Source: lib/dateFormatter.js

/**
 * JTSage-DateBox
 * @fileOverview Formats the date via formatting string.
 * @author J.T.Sage <jtsage+datebox@gmail.com>
 * @author {@link https://github.com/jtsage/jtsage-datebox/contributors|GitHub Contributors}
 * @license {@link https://github.com/jtsage/jtsage-datebox/blob/master/LICENSE.txt|MIT}
 * @version 5.2.0
 */


/**
 * Ordinal generation
 *
 * Custom ordinals are possible, they should be _ord.<language code>
 *
 * To date, I've not found any other language that uses them for dates.
 * 
 * @type {Object}
 * @namespace JTSageDateBox._ord
 */
JTSageDateBox._ord = {};

/**
 * Make an english language ordinal (1st, 2nd, 3rd, 4th, etc)
 * 
 * @param  {number} 
 * @return {string} Ordinal string
 * @memberOf JTSageDateBox._ord
 */
JTSageDateBox._ord.default = function (num) {
    // Return an ordinal suffix (1st, 2nd, 3rd, etc)
    var ending = num % 10;
    if ( ( num > 9 && num < 21 ) || ending > 3 ) { return "th"; }
    return [ "th", "st", "nd", "rd" ][ ending ];
};


/**
 * Custom formatters functions
 *
 * Sample included.  These are triggered with %X[char]
 * 
 * @type {Object}
 * @namespace JTSageDateBox._customformat
 */
JTSageDateBox._customformat = {};

/*jshint -W098 */
/* eslint-disable no-unused-vars*/
// Unused arguments disabled for this stub.
/**
 * Sample custom formatter prototype.  Does nothing
 * 
 * @param  {string} oper Operator - single character. %X[char]
 * @param  {object} date Date being formatted
 * @param  {object} o DateBox options object
 * @return {string} Text to display
 * @this JTSageDateBox._customformat
 * @memberOf JTSageDateBox._customformat
 */
JTSageDateBox._customformat.default = function( oper, date, o ) { return false; };
/* eslint-enable no-unused-vars*/

/**
 * Format a date with a given string format.
 * 
 * @param  {string} format Text representation of the format
 * @param  {object} date JavaScript date to be formatted
 * @param  {boolean} allowArIn Allow indic number translation, default true
 * @return {string} Formatted Date
 */
JTSageDateBox._formatter = function(format, date, allowArIn) {
    var w = this,
        o = this.options, tmp,
        dur = 0;

    // Set default for allowArIn
    if ( typeof(allowArIn) === "undefined" ) { allowArIn = true; }

    // "Stack" duration elements if not all operators are present.
    // i.e. - if you set 1 day, 2 hrs, but display only days, DateBox
    // needs to report 26 hrs, not just 2.
    if ( o.mode.substr( 0, 4 ) === "dura" ) {
        dur = w._dur(this.theDate.getTime() - this.initDate.getTime());

        if ( ! format.match( /%Dd/ ) ) { dur[1] += (dur[0]*24);}
        if ( ! format.match( /%Dl/ ) ) { dur[2] += (dur[1]*60);}
        if ( ! format.match( /%DM/ ) ) { dur[3] += (dur[2]*60);}
    }

    // Do the translation
    format = format.replace(/%(D|X|0|-)*([1-9a-zA-Z])/g, function(match, pad, oper) {
        // Deal with custom elements
        if ( pad === "X" ) {
            if ( typeof w._customformat[o.mode] === "function" ) {
                return w._customformat[o.mode](oper, date, o);
            }
            return match;
        }
        // Deal with duration elements
        if ( pad === "D" ) {
            switch ( oper ) {
                case "d": return dur[0];
                case "l": return w._zPad(dur[1]);
                case "M": return w._zPad(dur[2]);
                case "S": return w._zPad(dur[3]);
                case "A": return w.__( "durationDays" )[ (( dur[0] === 1 ) ? 0 : 1 ) ];
                default: return match;
            }
        }
        // Deal with everything else.
        switch ( oper ) {
            case "a": // Short Day
                return w.__( "daysOfWeekShort" )[ date.getDay() ];
            case "A": // Full Day of week
                return w.__( "daysOfWeek" )[ date.getDay() ];
            case "b": // Short month
                return w.__( "monthsOfYearShort" )[ date.getMonth() ];
            case "B": // Full month
                return w.__( "monthsOfYear" )[ date.getMonth() ];
            case "C": // Century
                return parseInt(date.getFullYear() / 100);
            case "d": // Day of month
                return w._zPad( date.getDate(), pad );
            case "H": // Hour (01..23)
            case "k":
                return w._zPad( date.getHours(), pad );
            case "I": // Hour (01..12)
            case "l":
                return w._zPad( date.get12hr(), pad );
            case "m": // Month
                return w._zPad( date.getMonth()+1, pad );
            case "M": // Minutes
                return w._zPad( date.getMinutes(), pad );
            case "p": // AM/PM (ucase)
            case "P": // AM/PM (lcase)
                tmp = w.__( "meridiem" )[ ( ( date.get(3) < 12 ) ? 0 : 1 ) ].toUpperCase();
                return ( oper === "P" ? tmp.toLowerCase() : tmp );
            case "s": // Unix Seconds
                return date.getEpoch();
            case "S": // Seconds
                return w._zPad( date.getSeconds(), pad );
            case "u": // Day of week (1-7)
                return w._zPad( date.getDay() + 1, pad );
            case "w": // Day of week
                return date.getDay();
            case "y": // Year (2 digit)
                return w._zPad(date.getFullYear() % 100);
            case "Y": // Year (4 digit)
                return date.getFullYear();
            case "E": // BE (Buddist Era, 4 Digit)
                return date.getFullYear() + 543;
            case "V":
                return w._zPad( date.getDWeek(4), pad );
            case "U":
                return w._zPad( date.getDWeek(0), pad );
            case "W":
                return w._zPad( date.getDWeek(1), pad );
            case "o": // Ordinals
                if ( typeof w._ord[o.useLang] === "function" ) {
                    return w._ord[ o.useLang ]( date.getDate() );
                }
                return w._ord[ "default" ](date.getDate());
            case "j":
                tmp = new w._date(date.getFullYear(),0,1);
                tmp = "000" + String(Math.ceil((date - tmp) / 86400000)+1);
                return tmp.slice(-3);
            case "J":
                return date.toJSON();
            case "G":
                tmp = date.getFullYear();
                if ( date.getDWeek(4) === 1 && date.getMonth() > 0 ) {
                    return tmp + 1;
                }
                if ( date.getDWeek(4) > 51 && date.getMonth() < 11 ) {
                    return tmp - 1;
                }
                return tmp;
            case "g":
                tmp = date.getFullYear % 100;
                if ( date.getDWeek(4) === 1 && date.getMonth() > 0 ) {
                    ++tmp;
                }
                if ( date.getDWeek(4) > 51 && date.getMonth() < 11 ) {
                    --tmp;
                }
                return w._zpad(tmp);
            default:
                return match;
        }
    });

    if ( w.__( "useArabicIndic" ) === true && allowArIn === true ) {
        format = w._dRep(format);
    }

    return format;
};