@blazedpath/commons 0.0.7 → 0.0.9

package/blz-datetimes/index.js

@@ -1,356 +1,358 @@
 module.exports = {
-    convertMilliseconds: function(strMilliseconds) {
-        if (strMilliseconds) {
-            if (strMilliseconds.length < 3)
-                strMilliseconds = strMilliseconds.padEnd(3, '0');
-            if (strMilliseconds.length > 3)
-                strMilliseconds = strMilliseconds.substr(0, 3);
-            return Number(strMilliseconds);
-        }
-        else
-            return 0;
-    },
-    tryDatetime: function (value) {
-        let strType = toString.call(value);
-        if (strType === '[object Date]') {
-            return value;
-        }
-        else if (strType === '[object String]') {
-            let matchDatetimeUtc = /^(\d{4})-(\d{1,2})-(\d{1,2})[T,\s](\d{1,2})\:(\d{1,2})\:(\d{1,2})\.?(\d+)?Z?$/.exec(value);
-            if (matchDatetimeUtc && matchDatetimeUtc[7] !== undefined) {
-                return new Date(Date.UTC(Number(matchDatetimeUtc[1]), Number(matchDatetimeUtc[2]) - 1, Number(matchDatetimeUtc[3]), Number(matchDatetimeUtc[4]), Number(matchDatetimeUtc[5]), Number(matchDatetimeUtc[6] || 0), this.convertMilliseconds(matchDatetimeUtc[7])));
+    Dual: {
+        convertMilliseconds: function (strMilliseconds) {
+            if (strMilliseconds) {
+                if (strMilliseconds.length < 3)
+                    strMilliseconds = strMilliseconds.padEnd(3, '0');
+                if (strMilliseconds.length > 3)
+                    strMilliseconds = strMilliseconds.substr(0, 3);
+                return Number(strMilliseconds);
             }
-            let matchDatetimeZone = /^(\d{4})-(\d{1,2})-(\d{1,2})[T\s](\d{1,2}):(\d{1,2}):(\d{1,2})(?:\.(\d+))?([+-]\d{2}:\d{2})?$/.exec(value);
-            if (matchDatetimeZone) { // timezone
-                let year = Number(matchDatetimeZone[1]);
-                let month = Number(matchDatetimeZone[2]) - 1; // Month is zero-based in JavaScript Date
-                let day = Number(matchDatetimeZone[3]);
-                let hour = Number(matchDatetimeZone[4]);
-                let minute = Number(matchDatetimeZone[5]);
-                let second = Number(matchDatetimeZone[6] || 0);
-                let millisecond = this.convertMilliseconds(matchDatetimeZone[7]);
-                let timezoneOffset = matchDatetimeZone[8];
-                if (timezoneOffset) {
-                    let offsetSign = timezoneOffset[0] === "+" ? 1 : -1;
-                    let [offsetHour, offsetMinute] = timezoneOffset.slice(1).split(":").map(Number);
-                    hour -= offsetSign * offsetHour;
-                    minute -= offsetSign * offsetMinute;
-                }
-                return new Date(Date.UTC(year, month, day, hour, minute, second, millisecond));
+            else
+                return 0;
+        },
+        tryDatetime: function (value) {
+            let strType = toString.call(value);
+            if (strType === '[object Date]') {
+                return value;
             }
-            else {
-                const probableDate = new Date(value)
-                if (probableDate.toString() !== 'Invalid Date') {
-                    return probableDate
+            else if (strType === '[object String]') {
+                let matchDatetimeUtc = /^(\d{4})-(\d{1,2})-(\d{1,2})[T,\s](\d{1,2})\:(\d{1,2})\:(\d{1,2})\.?(\d+)?Z?$/.exec(value);
+                if (matchDatetimeUtc && matchDatetimeUtc[7] !== undefined) {
+                    return new Date(Date.UTC(Number(matchDatetimeUtc[1]), Number(matchDatetimeUtc[2]) - 1, Number(matchDatetimeUtc[3]), Number(matchDatetimeUtc[4]), Number(matchDatetimeUtc[5]), Number(matchDatetimeUtc[6] || 0), this.convertMilliseconds(matchDatetimeUtc[7])));
+                }
+                let matchDatetimeZone = /^(\d{4})-(\d{1,2})-(\d{1,2})[T\s](\d{1,2}):(\d{1,2}):(\d{1,2})(?:\.(\d+))?([+-]\d{2}:\d{2})?$/.exec(value);
+                if (matchDatetimeZone) { // timezone
+                    let year = Number(matchDatetimeZone[1]);
+                    let month = Number(matchDatetimeZone[2]) - 1; // Month is zero-based in JavaScript Date
+                    let day = Number(matchDatetimeZone[3]);
+                    let hour = Number(matchDatetimeZone[4]);
+                    let minute = Number(matchDatetimeZone[5]);
+                    let second = Number(matchDatetimeZone[6] || 0);
+                    let millisecond = this.convertMilliseconds(matchDatetimeZone[7]);
+                    let timezoneOffset = matchDatetimeZone[8];
+                    if (timezoneOffset) {
+                        let offsetSign = timezoneOffset[0] === "+" ? 1 : -1;
+                        let [offsetHour, offsetMinute] = timezoneOffset.slice(1).split(":").map(Number);
+                        hour -= offsetSign * offsetHour;
+                        minute -= offsetSign * offsetMinute;
+                    }
+                    return new Date(Date.UTC(year, month, day, hour, minute, second, millisecond));
+                }
+                else {
+                    const probableDate = new Date(value)
+                    if (probableDate.toString() !== 'Invalid Date') {
+                        return probableDate
+                    }
                 }
             }
+            let err = new Error();
+            err.code = 'InvalidDatetime';
+            err.data = { value: value };
+            throw err;
+        },
+        tryDate: function (value) {
+            let strType = toString.call(value);
+            if (strType === '[object Date]') {
+                return new Date(Date.UTC(value.getUTCFullYear(), value.getUTCMonth(), value.getUTCDate(), 0, 0, 0, 0));
+            }
+            else if (strType === '[object String]') {
+                let match = /^(\d{4})-(\d{1,2})-(\d{1,2})$/.exec(value);
+                if (match)
+                    return new Date(Date.UTC(Number(match[1]), Number(match[2]) - 1, Number(match[3]), 0, 0, 0, 0));
+            }
+            let err = new Error();
+            err.code = 'InvalidDate';
+            err.data = { value: value };
+            throw err;
+        },
+        tryTime: function (value) {
+            let strType = toString.call(value);
+            if (strType === '[object Date]') {
+                return new Date(Date.UTC(1970, 0, 1, value.getUTCHours(), value.getUTCMinutes(), value.getUTCSeconds(), value.getUTCMilliseconds()));
+            }
+            else if (strType === '[object String]') {
+                let match = /^(\d{1,2})\:(\d{1,2})\:(\d{1,2})\.?(\d+)?$/.exec(value);
+                if (match)
+                    return new Date(Date.UTC(1970, 0, 1, Number(match[1]), Number(match[2]), Number(match[3]), this.convertMilliseconds(match[4])));
+            }
+            let err = new Error();
+            err.code = 'InvalidTime';
+            err.data = { value: value };
+            throw err;
+        },
+        addDays: function (value, days) {
+            if (value === null || value === undefined)
+                return null;
+            if (days === null || days === undefined)
+                return value;
+            let datetime = this.tryDatetime(value);
+            return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate() + days, datetime.getUTCHours(), datetime.getUTCMinutes(), datetime.getUTCSeconds(), datetime.getUTCMilliseconds()));
+        },
+        addHours: function (value, hours) {
+            if (value === null || value === undefined)
+                return null;
+            if (hours === null || hours === undefined)
+                return value;
+            let datetime = this.tryDatetime(value);
+            return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate(), datetime.getUTCHours() + hours, datetime.getUTCMinutes(), datetime.getUTCSeconds(), datetime.getUTCMilliseconds()));
+        },
+        addMilliseconds: function (value, milliseconds) {
+            if (value === null || value === undefined)
+                return null;
+            if (milliseconds === null || milliseconds === undefined)
+                return value;
+            let datetime = this.tryDatetime(value);
+            return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate(), datetime.getUTCHours(), datetime.getUTCMinutes(), datetime.getUTCSeconds(), datetime.getUTCMilliseconds() + milliseconds));
+        },
+        addMinutes: function (value, minutes) {
+            if (value === null || value === undefined)
+                return null;
+            if (minutes === null || minutes === undefined)
+                return value;
+            let datetime = this.tryDatetime(value);
+            return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate(), datetime.getUTCHours(), datetime.getUTCMinutes() + minutes, datetime.getUTCSeconds(), datetime.getUTCMilliseconds()));
+        },
+        addMonths: function (value, months) {
+            if (value === null || value === undefined)
+                return null;
+            if (months === null || months === undefined)
+                return value;
+            let datetime = this.tryDatetime(value);
+            let year = datetime.getUTCFullYear();
+            let month = datetime.getUTCMonth() + months;
+            let day = datetime.getUTCDate();
+            let hour = datetime.getUTCHours();
+            let minute = datetime.getUTCMinutes();
+            let second = datetime.getUTCSeconds();
+            let millisecond = datetime.getUTCMilliseconds();
+            let targetDatetime = new Date(Date.UTC(year, month, day, hour, minute, second, millisecond));
+            while (day > targetDatetime.getUTCDate()) {
+                day--;
+                targetDatetime = new Date(Date.UTC(year, month, day, hour, minute, second, millisecond));
+            }
+            return targetDatetime;
+        },
+        addSeconds: function (value, seconds) {
+            if (value === null || value === undefined)
+                return null;
+            if (seconds === null || seconds === undefined)
+                return value;
+            let datetime = this.tryDatetime(value);
+            return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate(), datetime.getUTCHours(), datetime.getUTCMinutes(), datetime.getUTCSeconds() + seconds, datetime.getUTCMilliseconds()));
+        },
+        addYears: function (value, years) {
+            if (value === null || value === undefined)
+                return null;
+            if (years === null || years === undefined)
+                return value;
+            let datetime = this.tryDatetime(value);
+            let year = datetime.getUTCFullYear() + years;
+            let month = datetime.getUTCMonth();
+            let day = datetime.getUTCDate();
+            let hour = datetime.getUTCHours();
+            let minute = datetime.getUTCMinutes();
+            let second = datetime.getUTCSeconds();
+            let millisecond = datetime.getUTCMilliseconds();
+            let targetDatetime = new Date(Date.UTC(year, month, day, hour, minute, second, millisecond));
+            while (day > targetDatetime.getUTCDate()) {
+                day--;
+                targetDatetime = new Date(Date.UTC(year, month, day, hour, minute, second, millisecond));
+            }
+            return targetDatetime;
+        },
+        date: function (year, month, day) {
+            if (year === null || year === undefined)
+                return null;
+            if (month === null || month === undefined)
+                return null;
+            if (day === null || day === undefined)
+                return null;
+            return new Date(Date.UTC(year, month - 1, day));
+        },
+        dateDiff: function (date1, date2) {
+            if (date1 === null || date1 === undefined)
+                return null;
+            if (date2 === null || date2 === undefined)
+                return date1;
+            return (this.tryDate(date1) - this.tryDate(date2)) / 86400000;
+        },
+        datetime: function (year, month, day, hour, minute, second, milliseconds) {
+            if (year === null || year === undefined)
+                return null;
+            if (month === null || month === undefined)
+                return null;
+            if (day === null || day === undefined)
+                return null;
+            if (hour === null || hour === undefined)
+                return null;
+            if (minute === null || minute === undefined)
+                return null;
+            if (second === null || second === undefined)
+                return null;
+            return new Date(Date.UTC(year, month - 1, day, hour, minute, second, 0));
+        },
+        datetimeDiff: function (datetime1, datetime2) {
+            if (datetime1 === null || datetime1 === undefined)
+                return null;
+            if (datetime2 === null || datetime2 === undefined)
+                return datetime1;
+            return this.tryDatetime(datetime1) - this.tryDatetime(datetime2);
+        },
+        day: function (value) {
+            if (value === null || value === undefined)
+                return null;
+            let datetime = this.tryDatetime(value);
+            return datetime.getUTCDate();
+        },
+        hour: function (value) {
+            if (value === null || value === undefined)
+                return null;
+            let datetime = this.tryDatetime(value);
+            return datetime.getUTCHours();
+        },
+        millisecond: function (value) {
+            if (value === null || value === undefined)
+                return null;
+            let datetime = this.tryDatetime(value);
+            return datetime.getUTCMilliseconds();
+        },
+        minute: function (value) {
+            if (value === null || value === undefined)
+                return null;
+            let datetime = this.tryDatetime(value);
+            return datetime.getUTCMinutes();
+        },
+        month: function (value) {
+            if (value === null || value === undefined)
+                return null;
+            let datetime = this.tryDatetime(value);
+            return datetime.getUTCMonth() + 1;
+        },
+        monthText: function (value) {
+            if (value === null || value === undefined)
+                return null;
+            let datetime = this.tryDatetime(value);
+            switch (datetime.getUTCMonth()) {
+                case 0: return 'January';
+                case 1: return 'February';
+                case 2: return 'March';
+                case 3: return 'April';
+                case 4: return 'May';
+                case 5: return 'June';
+                case 6: return 'July';
+                case 7: return 'August';
+                case 8: return 'September';
+                case 9: return 'October';
+                case 10: return 'November';
+                case 11: return 'December';
+            }
+        },
+        now: function () {
+            let now = new Date(Date.now());
+            return new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate(), now.getUTCHours(), now.getUTCMinutes(), now.getUTCSeconds(), now.getUTCMilliseconds()));
+        },
+        second: function (value) {
+            if (value === null || value === undefined)
+                return null;
+            let datetime = this.tryDatetime(value);
+            return datetime.getUTCSeconds();
+        },
+        subtractDays: function (value, days) {
+            if (value === null || value === undefined)
+                return null;
+            if (days === null || days === undefined)
+                return value;
+            let datetime = this.tryDatetime(value);
+            return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate() - days, datetime.getUTCHours(), datetime.getUTCMinutes(), datetime.getUTCSeconds(), datetime.getUTCMilliseconds()));
+        },
+        subtractHours: function (value, hours) {
+            if (value === null || value === undefined)
+                return null;
+            if (hours === null || hours === undefined)
+                return value;
+            let datetime = this.tryDatetime(value);
+            return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate(), datetime.getUTCHours() - hours, datetime.getUTCMinutes(), datetime.getUTCSeconds(), datetime.getUTCMilliseconds()));
+        },
+        subtractMilliseconds: function (value, milliseconds) {
+            if (value === null || value === undefined)
+                return null;
+            if (milliseconds === null || milliseconds === undefined)
+                return value;
+            let datetime = this.tryDatetime(value);
+            return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate(), datetime.getUTCHours(), datetime.getUTCMinutes(), datetime.getUTCSeconds(), datetime.getUTCMilliseconds() - milliseconds));
+        },
+        subtractMinutes: function (value, minutes) {
+            if (value === null || value === undefined)
+                return null;
+            if (minutes === null || minutes === undefined)
+                return value;
+            let datetime = this.tryDatetime(value);
+            return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate(), datetime.getUTCHours(), datetime.getUTCMinutes() - minutes, datetime.getUTCSeconds(), datetime.getUTCMilliseconds()));
+        },
+        subtractSeconds: function (value, seconds) {
+            if (value === null || value === undefined)
+                return null;
+            if (seconds === null || seconds === undefined)
+                return value;
+            let datetime = this.tryDatetime(value);
+            return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate(), datetime.getUTCHours(), datetime.getUTCMinutes(), datetime.getUTCSeconds() - seconds, datetime.getUTCMilliseconds()));
+        },
+        time: function (hour, minute, second, milliseconds) {
+            if (hour === null || hour === undefined)
+                return null;
+            if (minute === null || minute === undefined)
+                return null;
+            if (second === null || second === undefined)
+                return null;
+            return new Date(Date.UTC(1970, 0, 1, hour, minute, second, 0));
+        },
+        timeDiff: function (time1, time2) {
+            if (time1 === null || time1 === undefined)
+                return null;
+            if (time2 === null || time2 === undefined)
+                return time1;
+            return this.tryTime(time1) - this.tryTime(time2);
+        },
+        today: function () {
+            let now = new Date(Date.now());
+            return new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate(), 0, 0, 0, 0));
+        },
+        week: function (value) {
+            if (value === null || value === undefined)
+                return null;
+            let datetime = this.tryDatetime(value);
+            let d = new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate()));
+            let dayNum = d.getUTCDay() || 7;
+            d.setUTCDate(d.getUTCDate() + 4 - dayNum);
+            let yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+            return Math.ceil((((d - yearStart) / 86400000) + 1) / 7);
+        },
+        weekDay: function (value) {
+            if (value === null || value === undefined)
+                return null;
+            let datetime = this.tryDatetime(value);
+            return datetime.getUTCDay();
+        },
+        weekDayText: function (value) {
+            if (value === null || value === undefined)
+                return null;
+            let datetime = this.tryDatetime(value);
+            switch (datetime.getUTCDay()) {
+                case 0: return 'Sunday';
+                case 1: return 'Monday';
+                case 2: return 'Tuesday';
+                case 3: return 'Wednesday';
+                case 4: return 'Thursday';
+                case 5: return 'Friday';
+                case 6: return 'Saturday';
+            }
+        },
+        year: function (value) {
+            if (value === null || value === undefined)
+                return null;
+            let datetime = this.tryDatetime(value);
+            return datetime.getUTCFullYear();
         }
-        let err = new Error();
-        err.code = 'InvalidDatetime';
-        err.data = { value: value };
-        throw err;
-    },
-    tryDate: function (value) {
-        let strType = toString.call(value);
-        if (strType === '[object Date]') {
-            return new Date(Date.UTC(value.getUTCFullYear(), value.getUTCMonth(), value.getUTCDate(), 0, 0, 0, 0));
-        }
-        else if (strType === '[object String]') {
-            let match = /^(\d{4})-(\d{1,2})-(\d{1,2})$/.exec(value);
-            if (match)
-                return new Date(Date.UTC(Number(match[1]), Number(match[2]) - 1, Number(match[3]), 0, 0, 0, 0));
-        }
-        let err = new Error();
-        err.code = 'InvalidDate';
-        err.data = { value: value };
-        throw err;
-    },
-    tryTime: function (value) {
-        let strType = toString.call(value);
-        if (strType === '[object Date]') {
-            return new Date(Date.UTC(1970, 0, 1, value.getUTCHours(), value.getUTCMinutes(), value.getUTCSeconds(), value.getUTCMilliseconds()));
-        }
-        else if (strType === '[object String]') {
-            let match = /^(\d{1,2})\:(\d{1,2})\:(\d{1,2})\.?(\d+)?$/.exec(value);
-            if (match)
-                return new Date(Date.UTC(1970, 0, 1, Number(match[1]), Number(match[2]), Number(match[3]), this.convertMilliseconds(match[4])));
-        }
-        let err = new Error();
-        err.code = 'InvalidTime';
-        err.data = { value: value };
-        throw err;
-    },
-    addDays: function (value, days) {
-        if (value === null || value === undefined)
-            return null;
-        if (days === null || days === undefined)
-            return value;
-        let datetime = this.tryDatetime(value);
-        return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate() + days, datetime.getUTCHours(), datetime.getUTCMinutes(), datetime.getUTCSeconds(), datetime.getUTCMilliseconds()));
-    },
-    addHours: function (value, hours) {
-        if (value === null || value === undefined)
-            return null;
-        if (hours === null || hours === undefined)
-            return value;
-        let datetime = this.tryDatetime(value);
-        return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate(), datetime.getUTCHours() + hours, datetime.getUTCMinutes(), datetime.getUTCSeconds(), datetime.getUTCMilliseconds()));
-    },
-    addMilliseconds: function (value, milliseconds) {
-        if (value === null || value === undefined)
-            return null;
-        if (milliseconds === null || milliseconds === undefined)
-            return value;
-        let datetime = this.tryDatetime(value);
-        return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate(), datetime.getUTCHours(), datetime.getUTCMinutes(), datetime.getUTCSeconds(), datetime.getUTCMilliseconds() + milliseconds));
-    },
-    addMinutes: function (value, minutes) {
-        if (value === null || value === undefined)
-            return null;
-        if (minutes === null || minutes === undefined)
-            return value;
-        let datetime = this.tryDatetime(value);
-        return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate(), datetime.getUTCHours(), datetime.getUTCMinutes() + minutes, datetime.getUTCSeconds(), datetime.getUTCMilliseconds()));
-    },
-    addMonths: function (value, months) {
-        if (value === null || value === undefined)
-            return null;
-        if (months === null || months === undefined)
-            return value;
-        let datetime = this.tryDatetime(value);
-        let year = datetime.getUTCFullYear();
-        let month = datetime.getUTCMonth() + months;
-        let day = datetime.getUTCDate();
-        let hour = datetime.getUTCHours();
-        let minute = datetime.getUTCMinutes();
-        let second = datetime.getUTCSeconds();
-        let millisecond = datetime.getUTCMilliseconds();
-        let targetDatetime = new Date(Date.UTC(year, month, day, hour, minute, second, millisecond));
-        while (day > targetDatetime.getUTCDate()) {
-            day--;
-            targetDatetime = new Date(Date.UTC(year, month, day, hour, minute, second, millisecond));
-        }
-        return targetDatetime;
-    },
-    addSeconds: function (value, seconds) {
-        if (value === null || value === undefined)
-            return null;
-        if (seconds === null || seconds === undefined)
-            return value;
-        let datetime = this.tryDatetime(value);
-        return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate(), datetime.getUTCHours(), datetime.getUTCMinutes(), datetime.getUTCSeconds() + seconds, datetime.getUTCMilliseconds()));
-    },
-    addYears: function (value, years) {
-        if (value === null || value === undefined)
-            return null;
-        if (years === null || years === undefined)
-            return value;
-        let datetime = this.tryDatetime(value);
-        let year = datetime.getUTCFullYear() + years;
-        let month = datetime.getUTCMonth();
-        let day = datetime.getUTCDate();
-        let hour = datetime.getUTCHours();
-        let minute = datetime.getUTCMinutes();
-        let second = datetime.getUTCSeconds();
-        let millisecond = datetime.getUTCMilliseconds();
-        let targetDatetime = new Date(Date.UTC(year, month, day, hour, minute, second, millisecond));
-        while (day > targetDatetime.getUTCDate()) {
-            day--;
-            targetDatetime = new Date(Date.UTC(year, month, day, hour, minute, second, millisecond));
-        }
-        return targetDatetime;
-    },
-    date: function (year, month, day) {
-        if (year === null || year === undefined)
-            return null;
-        if (month === null ||month === undefined)
-            return null;
-        if (day === null || day === undefined)
-            return null;
-        return new Date(Date.UTC(year, month - 1, day));
-    },
-    dateDiff: function (date1, date2) {
-        if (date1 === null || date1 === undefined)
-            return null;
-        if (date2 === null || date2 === undefined)
-            return date1;
-        return (this.tryDate(date1) - this.tryDate(date2)) / 86400000;
-    },
-    datetime: function (year, month, day, hour, minute, second, milliseconds) {
-        if (year === null || year === undefined)
-            return null;
-        if (month === null ||month === undefined)
-            return null;
-        if (day === null || day === undefined)
-            return null;
-        if (hour === null || hour === undefined)
-            return null;
-        if (minute === null || minute === undefined)
-            return null;
-        if (second === null || second === undefined)
-            return null;
-        return new Date(Date.UTC(year, month - 1, day, hour, minute, second, 0));
-    },
-    datetimeDiff: function (datetime1, datetime2) {
-        if (datetime1 === null || datetime1 === undefined)
-            return null;
-        if (datetime2 === null || datetime2 === undefined)
-            return datetime1;
-        return this.tryDatetime(datetime1) - this.tryDatetime(datetime2);
-    },
-    day: function (value) {
-        if (value === null || value === undefined)
-            return null;
-        let datetime = this.tryDatetime(value);
-        return datetime.getUTCDate();
-    },
-    hour: function (value) {
-        if (value === null || value === undefined)
-            return null;
-        let datetime = this.tryDatetime(value);
-        return datetime.getUTCHours();
-    },
-    millisecond: function (value) {
-        if (value === null || value === undefined)
-            return null;
-        let datetime = this.tryDatetime(value);
-        return datetime.getUTCMilliseconds();
-    },
-    minute: function (value) {
-        if (value === null || value === undefined)
-            return null;
-        let datetime = this.tryDatetime(value);
-        return datetime.getUTCMinutes();
-    },
-    month: function (value) {
-        if (value === null || value === undefined)
-            return null;
-        let datetime = this.tryDatetime(value);
-        return datetime.getUTCMonth() + 1;
-    },
-    monthText: function (value) {
-        if (value === null || value === undefined)
-            return null;
-        let datetime = this.tryDatetime(value);
-        switch (datetime.getUTCMonth()) {
-            case 0: return 'January';
-            case 1: return 'February';
-            case 2: return 'March';
-            case 3: return 'April';
-            case 4: return 'May';
-            case 5: return 'June';
-            case 6: return 'July';
-            case 7: return 'August';
-            case 8: return 'September';
-            case 9: return 'October';
-            case 10: return 'November';
-            case 11: return 'December';
-        }
-    },
-    now: function () {       
-        let now = new Date(Date.now());
-        return new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate(), now.getUTCHours(), now.getUTCMinutes(), now.getUTCSeconds(), now.getUTCMilliseconds()));
-    },
-    second: function (value) {
-        if (value === null || value === undefined)
-            return null;
-        let datetime = this.tryDatetime(value);
-        return datetime.getUTCSeconds();
-    },
-    subtractDays: function (value, days) {
-        if (value === null || value === undefined)
-            return null;
-        if (days === null || days === undefined)
-            return value;
-        let datetime = this.tryDatetime(value);
-        return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate() - days, datetime.getUTCHours(), datetime.getUTCMinutes(), datetime.getUTCSeconds(), datetime.getUTCMilliseconds()));
-    },
-    subtractHours: function (value, hours) {
-        if (value === null || value === undefined)
-            return null;
-        if (hours === null || hours === undefined)
-            return value;
-        let datetime = this.tryDatetime(value);
-        return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate(), datetime.getUTCHours() - hours, datetime.getUTCMinutes(), datetime.getUTCSeconds(), datetime.getUTCMilliseconds()));
-    },
-    subtractMilliseconds: function (value, milliseconds) {
-        if (value === null || value === undefined)
-            return null;
-        if (milliseconds === null || milliseconds === undefined)
-            return value;
-        let datetime = this.tryDatetime(value);
-        return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate(), datetime.getUTCHours(), datetime.getUTCMinutes(), datetime.getUTCSeconds(), datetime.getUTCMilliseconds() - milliseconds));
-    },
-    subtractMinutes: function (value, minutes) {
-        if (value === null || value === undefined)
-            return null;
-        if (minutes === null || minutes === undefined)
-            return value;
-        let datetime = this.tryDatetime(value);
-        return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate(), datetime.getUTCHours(), datetime.getUTCMinutes() - minutes, datetime.getUTCSeconds(), datetime.getUTCMilliseconds()));
-    },
-    subtractSeconds: function (value, seconds) {
-        if (value === null || value === undefined)
-            return null;
-        if (seconds === null || seconds === undefined)
-            return value;
-        let datetime = this.tryDatetime(value);
-        return new Date(Date.UTC(datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate(), datetime.getUTCHours(), datetime.getUTCMinutes(), datetime.getUTCSeconds() - seconds, datetime.getUTCMilliseconds()));
-    },
-    time: function (hour, minute, second, milliseconds) {
-        if (hour === null || hour === undefined)
-            return null;
-        if (minute === null || minute === undefined)
-            return null;
-        if (second === null || second === undefined)
-            return null;
-        return new Date(Date.UTC(1970, 0, 1, hour, minute, second, 0));
-    },
-    timeDiff: function (time1, time2) {
-        if (time1 === null || time1 === undefined)
-            return null;
-        if (time2 === null || time2 === undefined)
-            return time1;
-        return this.tryTime(time1) - this.tryTime(time2);
-    },
-    today: function () {
-        let now = new Date(Date.now());
-        return new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate(), 0, 0, 0, 0));
-    },
-    week: function (value) {
-        if (value === null || value === undefined)
-            return null;
-        let datetime = this.tryDatetime(value);
-        let d = new Date( Date.UTC( datetime.getUTCFullYear(), datetime.getUTCMonth(), datetime.getUTCDate() ) );
-        let dayNum = d.getUTCDay() || 7;
-        d.setUTCDate(d.getUTCDate() + 4 - dayNum);
-        let yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
-        return Math.ceil((((d - yearStart) / 86400000) + 1) / 7);
-    },
-    weekDay: function (value) {
-        if (value === null || value === undefined)
-            return null;
-        let datetime = this.tryDatetime(value);
-        return datetime.getUTCDay();
-    },
-    weekDayText: function (value) {
-        if (value === null || value === undefined)
-            return null;
-        let datetime = this.tryDatetime(value);
-        switch (datetime.getUTCDay()) {
-            case 0: return 'Sunday';
-            case 1: return 'Monday';
-            case 2: return 'Tuesday';
-            case 3: return 'Wednesday';
-            case 4: return 'Thursday';
-            case 5: return 'Friday';
-            case 6: return 'Saturday';
-        }
-    },
-    year: function (value) {
-        if (value === null || value === undefined)
-            return null;
-        let datetime = this.tryDatetime(value);
-        return datetime.getUTCFullYear();
     }
 };