Edit File - File Manager

Edit File: date-and-time.js

(function (global, factory) {
    typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
    typeof define === 'function' && define.amd ? define(factory) :
    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, global.date = factory());
})(this, (function () { 'use strict';

/**
     * @preserve date-and-time (c) KNOWLEDGECODE | MIT
     */

for (var i = 0, len = array.length, item; i < len; i++) {
                    item = array[i];
                    if (!str.indexOf(item) && item.length > length) {
                        index = i;
                        length = item.length;
                    }
                }
                return { value: index, length: length };
            },
            pre: function (str) { return str; },
            res: _res
        },
        extend = function (base, props, override, res) {
            var obj = {}, key;

for (key in base) {
                obj[key] = base[key];
            }
            for (key in props || {}) {
                if (!(!!override ^ !!obj[key])) {
                    obj[key] = props[key];
                }
            }
            if (res) {
                obj.res = res;
            }
            return obj;
        },
        proto = {
            _formatter: _formatter,
            _parser: _parser
        },
        localized_proto,
        date;

/**
     * Compiling format strings
     * @param {string} formatString - A format string
     * @returns {Array.<string>} A compiled object
     */
    proto.compile = function (formatString) {
        return [formatString].concat(formatString.match(/\[(?:[^[\]]|\[[^[\]]*])*]|([A-Za-z])\1*|\.{3}|./g) || []);
    };

/**
     * Formatting date and time objects (Date -> String)
     * @param {Date} dateObj - A Date object
     * @param {string|Array.<string>} arg - A format string or its compiled object
     * @param {boolean} [utc] - Output as UTC
     * @returns {string} A formatted string
     */
    proto.format = function (dateObj, arg, utc) {
        var ctx = this || date, pattern = typeof arg === 'string' ? ctx.compile(arg) : arg,
            formatter = ctx._formatter,
            d = (function () {
                if (utc) {
                    var u = new Date(dateObj.getTime());

u.getFullYear = u.getUTCFullYear;
                    u.getMonth = u.getUTCMonth;
                    u.getDate = u.getUTCDate;
                    u.getHours = u.getUTCHours;
                    u.getMinutes = u.getUTCMinutes;
                    u.getSeconds = u.getUTCSeconds;
                    u.getMilliseconds = u.getUTCMilliseconds;
                    u.getDay = u.getUTCDay;
                    u.getTimezoneOffset = function () { return 0; };
                    return u;
                }
                return dateObj;
            }()),
            comment = /^\[(.*)\]$/, str = '';

for (var i = 1, len = pattern.length, token; i < len; i++) {
            token = pattern[i];
            str += formatter[token]
                ? formatter.post(formatter[token](d, pattern[0]))
                : comment.test(token) ? token.replace(comment, '$1') : token;
        }
        return str;
    };

/**
     * Pre-parsing date and time strings
     * @param {string} dateString - A date and time string
     * @param {string|Array.<string>} arg - A format string or its compiled object
     * @param {boolean} [utc] - Input as UTC
     * @returns {Object} A pre-parsed result object
     */
    proto.preparse = function (dateString, arg) {
        var ctx = this || date, pattern = typeof arg === 'string' ? ctx.compile(arg) : arg,
            parser = ctx._parser,
            dt = { Y: 1970, M: 1, D: 1, H: 0, A: 0, h: 0, m: 0, s: 0, S: 0, Z: 0, _index: 0, _length: 0, _match: 0 },
            wildcard = ' ', comment = /^\[(.*)\]$/, ellipsis = '...';

dateString = parser.pre(dateString);
        for (var i = 1, len = pattern.length, token, str, result; i < len; i++) {
            token = pattern[i];
            str = dateString.substring(dt._index);

if (parser[token]) {
                result = parser[token](str, pattern[0]);
                if (!result.length) {
                  break;
                }
                dt[result.token || token.charAt(0)] = result.value;
                dt._index += result.length;
                dt._match++;
            } else if (token === str.charAt(0) || token === wildcard) {
                dt._index++;
            } else if (comment.test(token) && !str.indexOf(token.replace(comment, '$1'))) {
                dt._index += token.length - 2;
            } else if (token === ellipsis) {
                dt._index = dateString.length;
                break;
            } else {
                break;
            }
        }
        dt.H = dt.H || parser.h12(dt.h, dt.A);
        dt._length = dateString.length;
        return dt;
    };

/**
     * Parsing of date and time string (String -> Date)
     * @param {string} dateString - A date-time string
     * @param {string|Array.<string>} arg - A format string or its compiled object
     * @param {boolean} [utc] - Input as UTC
     * @returns {Date} A Date object
     */
    proto.parse = function (dateString, arg, utc) {
        var ctx = this || date, pattern = typeof arg === 'string' ? ctx.compile(arg) : arg,
            dt = ctx.preparse(dateString, pattern);

if (ctx.isValid(dt)) {
            dt.M -= dt.Y < 100 ? 22801 : 1; // 22801 = 1900 * 12 + 1
            if (utc || ~ctx._parser.find(pattern, 'ZZ').value) {
                return new Date(Date.UTC(dt.Y, dt.M, dt.D, dt.H, dt.m + dt.Z, dt.s, dt.S));
            }
            return new Date(dt.Y, dt.M, dt.D, dt.H, dt.m, dt.s, dt.S);
        }
        return new Date(NaN);
    };

/**
     * Date and time string validation
     * @param {Object|string} arg1 - A pre-parsed result object or a date and time string
     * @param {string|Array.<string>} [arg2] - A format string or its compiled object
     * @returns {boolean} Whether the date and time string is a valid date and time
     */
    proto.isValid = function (arg1, arg2) {
        var ctx = this || date, dt = typeof arg1 === 'string' ? ctx.preparse(arg1, arg2) : arg1;

return !(
            dt._index < 1 || dt._length < 1 || dt._index - dt._length || dt._match < 1
            || dt.Y < 1 || dt.Y > 9999 || dt.M < 1 || dt.M > 12 || dt.D < 1 || dt.D >  new Date(dt.Y, dt.M, 0).getDate()
            || dt.H < 0 || dt.H > 23 || dt.m < 0 || dt.m > 59 || dt.s < 0 || dt.s > 59 || dt.S < 0 || dt.S > 999
            || dt.Z < -840 || dt.Z > 720
        );
    };

/**
     * Format transformation of date and time string (String -> String)
     * @param {string} dateString - A date and time string
     * @param {string|Array.<string>} arg1 - A format string or its compiled object before transformation
     * @param {string|Array.<string>} arg2 - A format string or its compiled object after transformation
     * @param {boolean} [utc] - Output as UTC
     * @returns {string} A formatted string
     */
    proto.transform = function (dateString, arg1, arg2, utc) {
        const ctx = this || date;
        return ctx.format(ctx.parse(dateString, arg1), arg2, utc);
    };

/**
     * Adding years
     * @param {Date} dateObj - A Date object
     * @param {number} years - Number of years to add
     * @param {boolean} [utc] - Calculates as UTC
     * @returns {Date} The Date object after adding the value
     */
    proto.addYears = function (dateObj, years, utc) {
        return (this || date).addMonths(dateObj, years * 12, utc);
    };

/**
     * Adding months
     * @param {Date} dateObj - A Date object
     * @param {number} months - Number of months to add
     * @param {boolean} [utc] - Calculates as UTC
     * @returns {Date} The Date object after adding the value
     */
    proto.addMonths = function (dateObj, months, utc) {
        var d = new Date(dateObj.getTime());

if (utc) {
            d.setUTCMonth(d.getUTCMonth() + months);
            if (d.getUTCDate() < dateObj.getUTCDate()) {
                return (this || date).addDays(d, -d.getUTCDate(), utc);
            }
        } else {
            d.setMonth(d.getMonth() + months);
            if (d.getDate() < dateObj.getDate()) {
                return (this || date).addDays(d, -d.getDate(), utc);
            }
        }
        return d;
    };

/**
     * Adding days
     * @param {Date} dateObj - A Date object
     * @param {number} days - Number of days to add
     * @param {boolean} [utc] - Calculates as UTC
     * @returns {Date} The Date object after adding the value
     */
    proto.addDays = function (dateObj, days, utc) {
        return (this || date).addHours(dateObj, days * 24, utc);
    };

/**
     * Adding hours
     * @param {Date} dateObj - A Date object
     * @param {number} hours - Number of hours to add
     * @param {boolean} [utc] - Calculates as UTC
     * @returns {Date} The Date object after adding the value
     */
    proto.addHours = function (dateObj, hours, utc) {
        return (this || date).addMinutes(dateObj, hours * 60, utc);
    };

/**
     * Adding minutes
     * @param {Date} dateObj - A Date object
     * @param {number} minutes - Number of minutes to add
     * @param {boolean} [utc] - Calculates as UTC
     * @returns {Date} The Date object after adding the value
     */
    proto.addMinutes = function (dateObj, minutes, utc) {
        return (this || date).addSeconds(dateObj, minutes * 60, utc);
    };

/**
     * Adding seconds
     * @param {Date} dateObj - A Date object
     * @param {number} seconds - Number of seconds to add
     * @param {boolean} [utc] - Calculates as UTC
     * @returns {Date} The Date object after adding the value
     */
    proto.addSeconds = function (dateObj, seconds, utc) {
        return (this || date).addMilliseconds(dateObj, seconds * 1000, utc);
    };

/**
     * Adding milliseconds
     * @param {Date} dateObj - A Date object
     * @param {number} milliseconds - Number of milliseconds to add
     * @param {boolean} [utc] - Calculates as UTC
     * @returns {Date} The Date object after adding the value
     */
    proto.addMilliseconds = function (dateObj, milliseconds, utc) {
        var d = new Date(dateObj.getTime());

if (utc) {
            d.setUTCMilliseconds(d.getUTCMilliseconds() + milliseconds);
        } else {
            d.setMilliseconds(d.getMilliseconds() + milliseconds);
        }
        return d;
    };

/**
     * Subtracting two dates (date1 - date2)
     * @param {Date} date1 - A Date object
     * @param {Date} date2 - A Date object
     * @returns {Object} The result object of subtracting date2 from date1
     */
    proto.subtract = function (date1, date2) {
        var delta = date1.getTime() - date2.getTime();

return {
            toMilliseconds: function () {
                return delta;
            },
            toSeconds: function () {
                return delta / 1000;
            },
            toMinutes: function () {
                return delta / 60000;
            },
            toHours: function () {
                return delta / 3600000;
            },
            toDays: function () {
                return delta / 86400000;
            }
        };
    };

/**
     * Whether a year is a leap year
     * @param {number} y - A year to check
     * @returns {boolean} Whether the year is a leap year
     */
    proto.isLeapYear = function (y) {
        return (!(y % 4) && !!(y % 100)) || !(y % 400);
    };

/**
     * Comparison of two dates
     * @param {Date} date1 - A Date object
     * @param {Date} date2 - A Date object
     * @returns {boolean} Whether the two dates are the same day (time is ignored)
     */
    proto.isSameDay = function (date1, date2) {
        return date1.toDateString() === date2.toDateString();
    };

/**
     * Definition of new locale
     * @param {string} code - A language code
     * @param {Function} locale - A locale installer
     * @returns {void}
     */
    proto.locale = function (code, locale) {
        if (!locales[code]) {
            locales[code] = locale;
        }
    };

/**
     * Definition of new plugin
     * @param {string} name - A plugin name
     * @param {Function} plugin - A plugin installer
     * @returns {void}
     */
    proto.plugin = function (name, plugin) {
        if (!plugins[name]) {
            plugins[name] = plugin;
        }
    };

localized_proto = extend(proto);
    date = extend(proto);

/**
     * Changing locales
     * @param {Function|string} [locale] - A locale installer or language code
     * @returns {string} The current language code
     */
    date.locale = function (locale) {
        var install = typeof locale === 'function' ? locale : date.locale[locale];

if (!install) {
            return lang;
        }
        lang = install(proto);

var extension = locales[lang] || {};
        var res = extend(_res, extension.res, true);
        var formatter = extend(_formatter, extension.formatter, true, res);
        var parser = extend(_parser, extension.parser, true, res);

date._formatter = localized_proto._formatter = formatter;
        date._parser = localized_proto._parser = parser;

for (var plugin in plugins) {
            date.extend(plugins[plugin]);
        }

return lang;
    };

/**
     * Functional extension
     * @param {Object} extension - An extension object
     * @returns {void}
     */
    date.extend = function (extension) {
        var res = extend(date._parser.res, extension.res);
        var extender = extension.extender || {};

date._formatter = extend(date._formatter, extension.formatter, false, res);
        date._parser = extend(date._parser, extension.parser, false, res);

for (var key in extender) {
            if (!date[key]) {
                date[key] = extender[key];
            }
        }
    };

/**
     * Importing plugins
     * @param {Function|string} plugin - A plugin installer or plugin name
     * @returns {void}
     */
    date.plugin = function (plugin) {
        var install = typeof plugin === 'function' ? plugin : date.plugin[plugin];

if (install) {
            date.extend(plugins[install(proto, localized_proto)] || {});
        }
    };

var date$1 = date;

return date$1;

}));

Back to File Manager