@blazedpath/commons 0.3.1 → 0.4.0

package/blz-datetimes/index.js

@@ -0,0 +1,356 @@
+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])));
+            }
+            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();
+    }
+};