@naturalcycles/js-lib 14.91.2 → 14.92.0

package/dist/datetime/localDate.d.ts

@@ -19,12 +19,14 @@ export declare class LocalDate {
     static of(d: LocalDateConfig): LocalDate;
     static parseCompact(d: string): LocalDate;
     static fromDate(d: Date): LocalDate;
+    static fromDateUTC(d: Date): LocalDate;
     /**
      * Returns null if invalid.
      */
     static parseOrNull(d: LocalDateConfig): LocalDate | null;
     static isValid(iso: string): boolean;
     static today(): LocalDate;
+    static todayUTC(): LocalDate;
     static sort(items: LocalDate[], mutate?: boolean, descending?: boolean): LocalDate[];
     static earliestOrUndefined(items: LocalDate[]): LocalDate | undefined;
     static earliest(items: LocalDate[]): LocalDate;

package/dist/datetime/localDate.js

@@ -39,6 +39,9 @@ class LocalDate {
     static fromDate(d) {
         return new LocalDate(d.getFullYear(), d.getMonth() + 1, d.getDate());
     }
+    static fromDateUTC(d) {
+        return new LocalDate(d.getUTCFullYear(), d.getUTCMonth() + 1, d.getUTCDate());
+    }
     /**
      * Returns null if invalid.
      */
@@ -64,6 +67,9 @@ class LocalDate {
     static today() {
         return this.fromDate(new Date());
     }
+    static todayUTC() {
+        return this.fromDateUTC(new Date());
+    }
     static sort(items, mutate = false, descending = false) {
         const mod = descending ? -1 : 1;
         return (mutate ? items : [...items]).sort((a, b) => a.cmp(b) * mod);

package/dist/datetime/localTime.d.ts

@@ -15,18 +15,20 @@ export interface LocalTimeComponents {
  */
 export declare class LocalTime {
     private $date;
+    utcMode: boolean;
     private constructor();
     /**
      * Parses input String into LocalDate.
      * Input can already be a LocalDate - it is returned as-is in that case.
      */
     static of(d: LocalTimeConfig): LocalTime;
+    utc(): this;
+    local(): this;
     /**
      * Returns null if invalid
      */
     static parseOrNull(d: LocalTimeConfig): LocalTime | null;
     static isValid(d: LocalTimeConfig): boolean;
-    static unix(ts: UnixTimestamp): LocalTime;
     static now(): LocalTime;
     static fromComponents(c: {
         year: number;
@@ -69,6 +71,7 @@ export declare class LocalTime {
      */
     cmp(d: LocalTimeConfig): -1 | 0 | 1;
     components(): LocalTimeComponents;
+    fromNow(now?: LocalTimeConfig): string;
     getDate(): Date;
     clone(): LocalTime;
     unix(): UnixTimestamp;
@@ -84,6 +87,10 @@ export declare class LocalTime {
      * Returns e.g: `1984-06-21`, only the date part of DateTime
      */
     toISODate(): IsoDate;
+    /**
+     * Returns e.g: `17:03:15` (or `17:03` with seconds=false)
+     */
+    toISOTime(seconds?: boolean): string;
     /**
      * Returns e.g: `19840621_1705`
      */

package/dist/datetime/localTime.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.localTime = exports.LocalTime = void 0;
 const assert_1 = require("../error/assert");
+const time_util_1 = require("../time/time.util");
 const localDate_1 = require("./localDate");
 /* eslint-disable no-dupe-class-members */
 // Design choices:
@@ -17,8 +18,9 @@ const localDate_1 = require("./localDate");
  * @experimental
  */
 class LocalTime {
-    constructor($date) {
+    constructor($date, utcMode) {
         this.$date = $date;
+        this.utcMode = utcMode;
     }
     /**
      * Parses input String into LocalDate.
@@ -31,6 +33,14 @@ class LocalTime {
         }
         return t;
     }
+    utc() {
+        this.utcMode = true;
+        return this;
+    }
+    local() {
+        this.utcMode = false;
+        return this;
+    }
     /**
      * Returns null if invalid
      */
@@ -52,106 +62,110 @@ class LocalTime {
             // throw new TypeError(`Cannot parse "${d}" into LocalTime`)
             return null;
         }
-        return new LocalTime(date);
+        // if (utc) {
+        //   date.setMinutes(date.getMinutes() + date.getTimezoneOffset())
+        // }
+        return new LocalTime(date, false);
     }
     static isValid(d) {
         return this.parseOrNull(d) !== null;
     }
-    static unix(ts) {
-        return new LocalTime(new Date(ts * 1000));
-    }
     static now() {
-        return this.of(new Date());
+        return new LocalTime(new Date(), false);
     }
     static fromComponents(c) {
-        return new LocalTime(new Date(c.year, c.month - 1, c.day, c.hour, c.minute, c.second));
+        return new LocalTime(new Date(c.year, c.month - 1, c.day, c.hour, c.minute, c.second), false);
     }
     get(unit) {
         if (unit === 'year') {
-            return this.$date.getFullYear();
+            return this.utcMode ? this.$date.getUTCFullYear() : this.$date.getFullYear();
         }
         if (unit === 'month') {
-            return this.$date.getMonth() + 1;
+            return (this.utcMode ? this.$date.getUTCMonth() : this.$date.getMonth()) + 1;
         }
         if (unit === 'day') {
-            return this.$date.getDate();
+            return this.utcMode ? this.$date.getUTCDate() : this.$date.getDate();
         }
         if (unit === 'hour') {
-            return this.$date.getHours();
+            return this.utcMode ? this.$date.getUTCHours() : this.$date.getHours();
         }
         if (unit === 'minute') {
-            return this.$date.getMinutes();
+            return this.utcMode ? this.$date.getUTCMinutes() : this.$date.getMinutes();
         }
         // second
-        return this.$date.getSeconds();
+        return this.utcMode ? this.$date.getUTCSeconds() : this.$date.getSeconds();
     }
     set(unit, v, mutate = false) {
         const t = mutate ? this : this.clone();
+        /* eslint-disable @typescript-eslint/no-unused-expressions */
         if (unit === 'year') {
-            t.$date.setFullYear(v);
+            this.utcMode ? t.$date.setUTCFullYear(v) : t.$date.setFullYear(v);
         }
         else if (unit === 'month') {
-            t.$date.setMonth(v - 1);
+            this.utcMode ? t.$date.setUTCMonth(v - 1) : t.$date.setMonth(v - 1);
         }
         else if (unit === 'day') {
-            t.$date.setDate(v);
+            this.utcMode ? t.$date.setUTCDate(v) : t.$date.setDate(v);
         }
         else if (unit === 'hour') {
-            t.$date.setHours(v);
+            this.utcMode ? t.$date.setUTCHours(v) : t.$date.setHours(v);
         }
         else if (unit === 'minute') {
-            t.$date.setMinutes(v);
+            this.utcMode ? t.$date.setUTCMinutes(v) : t.$date.setMinutes(v);
         }
         else if (unit === 'second') {
-            t.$date.setSeconds(v);
+            this.utcMode ? t.$date.setUTCSeconds(v) : t.$date.setSeconds(v);
         }
+        /* eslint-enable @typescript-eslint/no-unused-expressions */
         return t;
     }
     year(v) {
-        return v === undefined ? this.$date.getFullYear() : this.set('year', v);
+        return v === undefined ? this.get('year') : this.set('year', v);
     }
     month(v) {
-        return v === undefined ? this.$date.getMonth() + 1 : this.set('month', v);
+        return v === undefined ? this.get('month') : this.set('month', v);
     }
     date(v) {
-        return v === undefined ? this.$date.getDate() : this.set('day', v);
+        return v === undefined ? this.get('day') : this.set('day', v);
     }
     hour(v) {
-        return v === undefined ? this.$date.getHours() : this.set('hour', v);
+        return v === undefined ? this.get('hour') : this.set('hour', v);
     }
     minute(v) {
-        return v === undefined ? this.$date.getMinutes() : this.set('minute', v);
+        return v === undefined ? this.get('minute') : this.set('minute', v);
     }
     second(v) {
-        return v === undefined ? this.$date.getSeconds() : this.set('second', v);
+        return v === undefined ? this.get('second') : this.set('second', v);
     }
     setComponents(c, mutate = false) {
         const d = mutate ? this.$date : new Date(this.$date);
+        /* eslint-disable @typescript-eslint/no-unused-expressions */
         if (c.year) {
-            d.setFullYear(c.year);
+            this.utcMode ? d.setUTCFullYear(c.year) : d.setFullYear(c.year);
         }
         if (c.month) {
-            d.setMonth(c.month - 1);
+            this.utcMode ? d.setUTCMonth(c.month - 1) : d.setMonth(c.month - 1);
         }
         if (c.day) {
-            d.setDate(c.day);
+            this.utcMode ? d.setUTCDate(c.day) : d.setDate(c.day);
         }
         if (c.hour !== undefined) {
-            d.setHours(c.hour);
+            this.utcMode ? d.setUTCHours(c.hour) : d.setHours(c.hour);
         }
         if (c.minute !== undefined) {
-            d.setMinutes(c.minute);
+            this.utcMode ? d.setUTCMinutes(c.minute) : d.setMinutes(c.minute);
         }
         if (c.second !== undefined) {
-            d.setSeconds(c.second);
+            this.utcMode ? d.setUTCSeconds(c.second) : d.setSeconds(c.second);
         }
-        return mutate ? this : new LocalTime(d);
+        /* eslint-enable @typescript-eslint/no-unused-expressions */
+        return mutate ? this : new LocalTime(d, this.utcMode);
     }
     add(num, unit, mutate = false) {
         return this.set(unit, this.get(unit) + num, mutate);
     }
     subtract(num, unit, mutate = false) {
-        return this.add(-num, unit, mutate);
+        return this.add(num * -1, unit, mutate);
     }
     absDiff(other, unit) {
         return Math.abs(this.diff(other, unit));
@@ -189,40 +203,23 @@ class LocalTime {
     startOf(unit, mutate = false) {
         if (unit === 'second')
             return this;
-        if (mutate) {
-            const d = this.$date;
-            d.setSeconds(0);
-            if (unit === 'minute')
-                return this;
-            d.setMinutes(0);
-            if (unit === 'hour')
-                return this;
-            d.setHours(0);
-            if (unit === 'day')
-                return this;
-            d.setDate(0);
-            if (unit === 'month')
-                return this;
-            d.setMonth(0);
-            return this;
-        }
-        const c = this.components();
-        c.second = 0;
-        if (unit === 'year') {
-            c.month = c.day = 1;
-            c.hour = c.minute = 0;
-        }
-        else if (unit === 'month') {
-            c.day = 1;
-            c.hour = c.minute = 0;
-        }
-        else if (unit === 'day') {
-            c.hour = c.minute = 0;
-        }
-        else if (unit === 'hour') {
-            c.minute = 0;
-        }
-        return LocalTime.fromComponents(c);
+        const d = mutate ? this.$date : new Date(this.$date);
+        /* eslint-disable @typescript-eslint/no-unused-expressions */
+        this.utcMode ? d.setUTCSeconds(0) : d.setSeconds(0);
+        if (unit !== 'minute') {
+            this.utcMode ? d.setUTCMinutes(0) : d.setMinutes(0);
+            if (unit !== 'hour') {
+                this.utcMode ? d.setUTCHours(0) : d.setHours(0);
+                if (unit !== 'day') {
+                    this.utcMode ? d.setUTCDate(0) : d.setDate(0);
+                    if (unit !== 'month') {
+                        this.utcMode ? d.setUTCMonth(0) : d.setMonth(0);
+                    }
+                }
+            }
+        }
+        /* eslint-enable @typescript-eslint/no-unused-expressions */
+        return mutate ? this : new LocalTime(d, this.utcMode);
     }
     static sort(items, mutate = false, descending = false) {
         const mod = descending ? -1 : 1;
@@ -277,6 +274,16 @@ class LocalTime {
     }
     // todo: endOf
     components() {
+        if (this.utcMode) {
+            return {
+                year: this.$date.getUTCFullYear(),
+                month: this.$date.getUTCMonth() + 1,
+                day: this.$date.getUTCDate(),
+                hour: this.$date.getUTCHours(),
+                minute: this.$date.getUTCMinutes(),
+                second: this.$date.getSeconds(),
+            };
+        }
         return {
             year: this.$date.getFullYear(),
             month: this.$date.getMonth() + 1,
@@ -286,11 +293,20 @@ class LocalTime {
             second: this.$date.getSeconds(),
         };
     }
+    fromNow(now = LocalTime.now()) {
+        const msDiff = LocalTime.of(now).unixMillis() - this.unixMillis();
+        if (msDiff === 0)
+            return 'now';
+        if (msDiff >= 0) {
+            return `${(0, time_util_1._ms)(msDiff)} ago`;
+        }
+        return `in ${(0, time_util_1._ms)(msDiff * -1)}`;
+    }
     getDate() {
         return this.$date;
     }
     clone() {
-        return new LocalTime(new Date(this.$date));
+        return new LocalTime(new Date(this.$date), this.utcMode);
     }
     unix() {
         return Math.floor(this.$date.valueOf() / 1000);
@@ -302,14 +318,31 @@ class LocalTime {
         return Math.floor(this.$date.valueOf() / 1000);
     }
     toLocalDate() {
+        if (this.utcMode) {
+            return localDate_1.LocalDate.create(this.$date.getUTCFullYear(), this.$date.getUTCMonth() + 1, this.$date.getUTCDate());
+        }
         return localDate_1.LocalDate.create(this.$date.getFullYear(), this.$date.getMonth() + 1, this.$date.getDate());
     }
     toPretty(seconds = true) {
-        return this.$date
-            .toISOString()
-            .slice(0, seconds ? 19 : 16)
-            .split('T')
-            .join(' ');
+        const { year, month, day, hour, minute, second } = this.components();
+        return ([
+            String(year).padStart(4, '0'),
+            String(month).padStart(2, '0'),
+            String(day).padStart(2, '0'),
+        ].join('-') +
+            ' ' +
+            [
+                String(hour).padStart(2, '0'),
+                String(minute).padStart(2, '0'),
+                seconds && String(second).padStart(2, '0'),
+            ]
+                .filter(Boolean)
+                .join(':'));
+        // return this.$date
+        //   .toISOString()
+        //   .slice(0, seconds ? 19 : 16)
+        //   .split('T')
+        //   .join(' ')
     }
     /**
      * Returns e.g: `1984-06-21T17:56:21`, only the date part of DateTime
@@ -321,20 +354,41 @@ class LocalTime {
      * Returns e.g: `1984-06-21`, only the date part of DateTime
      */
     toISODate() {
-        return this.$date.toISOString().slice(0, 10);
+        const { year, month, day } = this.components();
+        return [
+            String(year).padStart(4, '0'),
+            String(month).padStart(2, '0'),
+            String(day).padStart(2, '0'),
+        ].join('-');
+        // return this.$date.toISOString().slice(0, 10)
+    }
+    /**
+     * Returns e.g: `17:03:15` (or `17:03` with seconds=false)
+     */
+    toISOTime(seconds = true) {
+        // return this.$date.toISOString().slice(11, seconds ? 19 : 16)
+        const { hour, minute, second } = this.components();
+        return [
+            String(hour).padStart(2, '0'),
+            String(minute).padStart(2, '0'),
+            seconds && String(second).padStart(2, '0'),
+        ]
+            .filter(Boolean)
+            .join(':');
     }
     /**
      * Returns e.g: `19840621_1705`
      */
     toStringCompact(seconds = false) {
+        const { year, month, day, hour, minute, second } = this.components();
         return [
-            String(this.$date.getFullYear()).padStart(4, '0'),
-            String(this.$date.getMonth() + 1).padStart(2, '0'),
-            String(this.$date.getDate()).padStart(2, '0'),
+            String(year).padStart(4, '0'),
+            String(month).padStart(2, '0'),
+            String(day).padStart(2, '0'),
             '_',
-            String(this.$date.getHours()).padStart(2, '0'),
-            String(this.$date.getMinutes()).padStart(2, '0'),
-            seconds ? String(this.$date.getSeconds()).padStart(2, '0') : '',
+            String(hour).padStart(2, '0'),
+            String(minute).padStart(2, '0'),
+            seconds ? String(second).padStart(2, '0') : '',
         ].join('');
     }
     toString() {

package/dist-esm/datetime/localDate.js

@@ -36,6 +36,9 @@ export class LocalDate {
     static fromDate(d) {
         return new LocalDate(d.getFullYear(), d.getMonth() + 1, d.getDate());
     }
+    static fromDateUTC(d) {
+        return new LocalDate(d.getUTCFullYear(), d.getUTCMonth() + 1, d.getUTCDate());
+    }
     /**
      * Returns null if invalid.
      */
@@ -61,6 +64,9 @@ export class LocalDate {
     static today() {
         return this.fromDate(new Date());
     }
+    static todayUTC() {
+        return this.fromDateUTC(new Date());
+    }
     static sort(items, mutate = false, descending = false) {
         const mod = descending ? -1 : 1;
         return (mutate ? items : [...items]).sort((a, b) => a.cmp(b) * mod);

package/dist-esm/datetime/localTime.js

@@ -1,4 +1,5 @@
 import { _assert } from '../error/assert';
+import { _ms } from '../time/time.util';
 import { LocalDate } from './localDate';
 /* eslint-disable no-dupe-class-members */
 // Design choices:
@@ -14,8 +15,9 @@ import { LocalDate } from './localDate';
  * @experimental
  */
 export class LocalTime {
-    constructor($date) {
+    constructor($date, utcMode) {
         this.$date = $date;
+        this.utcMode = utcMode;
     }
     /**
      * Parses input String into LocalDate.
@@ -28,6 +30,14 @@ export class LocalTime {
         }
         return t;
     }
+    utc() {
+        this.utcMode = true;
+        return this;
+    }
+    local() {
+        this.utcMode = false;
+        return this;
+    }
     /**
      * Returns null if invalid
      */
@@ -49,106 +59,110 @@ export class LocalTime {
             // throw new TypeError(`Cannot parse "${d}" into LocalTime`)
             return null;
         }
-        return new LocalTime(date);
+        // if (utc) {
+        //   date.setMinutes(date.getMinutes() + date.getTimezoneOffset())
+        // }
+        return new LocalTime(date, false);
     }
     static isValid(d) {
         return this.parseOrNull(d) !== null;
     }
-    static unix(ts) {
-        return new LocalTime(new Date(ts * 1000));
-    }
     static now() {
-        return this.of(new Date());
+        return new LocalTime(new Date(), false);
     }
     static fromComponents(c) {
-        return new LocalTime(new Date(c.year, c.month - 1, c.day, c.hour, c.minute, c.second));
+        return new LocalTime(new Date(c.year, c.month - 1, c.day, c.hour, c.minute, c.second), false);
     }
     get(unit) {
         if (unit === 'year') {
-            return this.$date.getFullYear();
+            return this.utcMode ? this.$date.getUTCFullYear() : this.$date.getFullYear();
         }
         if (unit === 'month') {
-            return this.$date.getMonth() + 1;
+            return (this.utcMode ? this.$date.getUTCMonth() : this.$date.getMonth()) + 1;
         }
         if (unit === 'day') {
-            return this.$date.getDate();
+            return this.utcMode ? this.$date.getUTCDate() : this.$date.getDate();
         }
         if (unit === 'hour') {
-            return this.$date.getHours();
+            return this.utcMode ? this.$date.getUTCHours() : this.$date.getHours();
         }
         if (unit === 'minute') {
-            return this.$date.getMinutes();
+            return this.utcMode ? this.$date.getUTCMinutes() : this.$date.getMinutes();
         }
         // second
-        return this.$date.getSeconds();
+        return this.utcMode ? this.$date.getUTCSeconds() : this.$date.getSeconds();
     }
     set(unit, v, mutate = false) {
         const t = mutate ? this : this.clone();
+        /* eslint-disable @typescript-eslint/no-unused-expressions */
         if (unit === 'year') {
-            t.$date.setFullYear(v);
+            this.utcMode ? t.$date.setUTCFullYear(v) : t.$date.setFullYear(v);
         }
         else if (unit === 'month') {
-            t.$date.setMonth(v - 1);
+            this.utcMode ? t.$date.setUTCMonth(v - 1) : t.$date.setMonth(v - 1);
         }
         else if (unit === 'day') {
-            t.$date.setDate(v);
+            this.utcMode ? t.$date.setUTCDate(v) : t.$date.setDate(v);
         }
         else if (unit === 'hour') {
-            t.$date.setHours(v);
+            this.utcMode ? t.$date.setUTCHours(v) : t.$date.setHours(v);
         }
         else if (unit === 'minute') {
-            t.$date.setMinutes(v);
+            this.utcMode ? t.$date.setUTCMinutes(v) : t.$date.setMinutes(v);
         }
         else if (unit === 'second') {
-            t.$date.setSeconds(v);
+            this.utcMode ? t.$date.setUTCSeconds(v) : t.$date.setSeconds(v);
         }
+        /* eslint-enable @typescript-eslint/no-unused-expressions */
         return t;
     }
     year(v) {
-        return v === undefined ? this.$date.getFullYear() : this.set('year', v);
+        return v === undefined ? this.get('year') : this.set('year', v);
     }
     month(v) {
-        return v === undefined ? this.$date.getMonth() + 1 : this.set('month', v);
+        return v === undefined ? this.get('month') : this.set('month', v);
     }
     date(v) {
-        return v === undefined ? this.$date.getDate() : this.set('day', v);
+        return v === undefined ? this.get('day') : this.set('day', v);
     }
     hour(v) {
-        return v === undefined ? this.$date.getHours() : this.set('hour', v);
+        return v === undefined ? this.get('hour') : this.set('hour', v);
     }
     minute(v) {
-        return v === undefined ? this.$date.getMinutes() : this.set('minute', v);
+        return v === undefined ? this.get('minute') : this.set('minute', v);
     }
     second(v) {
-        return v === undefined ? this.$date.getSeconds() : this.set('second', v);
+        return v === undefined ? this.get('second') : this.set('second', v);
     }
     setComponents(c, mutate = false) {
         const d = mutate ? this.$date : new Date(this.$date);
+        /* eslint-disable @typescript-eslint/no-unused-expressions */
         if (c.year) {
-            d.setFullYear(c.year);
+            this.utcMode ? d.setUTCFullYear(c.year) : d.setFullYear(c.year);
         }
         if (c.month) {
-            d.setMonth(c.month - 1);
+            this.utcMode ? d.setUTCMonth(c.month - 1) : d.setMonth(c.month - 1);
         }
         if (c.day) {
-            d.setDate(c.day);
+            this.utcMode ? d.setUTCDate(c.day) : d.setDate(c.day);
         }
         if (c.hour !== undefined) {
-            d.setHours(c.hour);
+            this.utcMode ? d.setUTCHours(c.hour) : d.setHours(c.hour);
         }
         if (c.minute !== undefined) {
-            d.setMinutes(c.minute);
+            this.utcMode ? d.setUTCMinutes(c.minute) : d.setMinutes(c.minute);
         }
         if (c.second !== undefined) {
-            d.setSeconds(c.second);
+            this.utcMode ? d.setUTCSeconds(c.second) : d.setSeconds(c.second);
         }
-        return mutate ? this : new LocalTime(d);
+        /* eslint-enable @typescript-eslint/no-unused-expressions */
+        return mutate ? this : new LocalTime(d, this.utcMode);
     }
     add(num, unit, mutate = false) {
         return this.set(unit, this.get(unit) + num, mutate);
     }
     subtract(num, unit, mutate = false) {
-        return this.add(-num, unit, mutate);
+        return this.add(num * -1, unit, mutate);
     }
     absDiff(other, unit) {
         return Math.abs(this.diff(other, unit));
@@ -186,40 +200,23 @@ export class LocalTime {
     startOf(unit, mutate = false) {
         if (unit === 'second')
             return this;
-        if (mutate) {
-            const d = this.$date;
-            d.setSeconds(0);
-            if (unit === 'minute')
-                return this;
-            d.setMinutes(0);
-            if (unit === 'hour')
-                return this;
-            d.setHours(0);
-            if (unit === 'day')
-                return this;
-            d.setDate(0);
-            if (unit === 'month')
-                return this;
-            d.setMonth(0);
-            return this;
-        }
-        const c = this.components();
-        c.second = 0;
-        if (unit === 'year') {
-            c.month = c.day = 1;
-            c.hour = c.minute = 0;
-        }
-        else if (unit === 'month') {
-            c.day = 1;
-            c.hour = c.minute = 0;
-        }
-        else if (unit === 'day') {
-            c.hour = c.minute = 0;
-        }
-        else if (unit === 'hour') {
-            c.minute = 0;
-        }
-        return LocalTime.fromComponents(c);
+        const d = mutate ? this.$date : new Date(this.$date);
+        /* eslint-disable @typescript-eslint/no-unused-expressions */
+        this.utcMode ? d.setUTCSeconds(0) : d.setSeconds(0);
+        if (unit !== 'minute') {
+            this.utcMode ? d.setUTCMinutes(0) : d.setMinutes(0);
+            if (unit !== 'hour') {
+                this.utcMode ? d.setUTCHours(0) : d.setHours(0);
+                if (unit !== 'day') {
+                    this.utcMode ? d.setUTCDate(0) : d.setDate(0);
+                    if (unit !== 'month') {
+                        this.utcMode ? d.setUTCMonth(0) : d.setMonth(0);
+                    }
+                }
+            }
+        }
+        /* eslint-enable @typescript-eslint/no-unused-expressions */
+        return mutate ? this : new LocalTime(d, this.utcMode);
     }
     static sort(items, mutate = false, descending = false) {
         const mod = descending ? -1 : 1;
@@ -274,6 +271,16 @@ export class LocalTime {
     }
     // todo: endOf
     components() {
+        if (this.utcMode) {
+            return {
+                year: this.$date.getUTCFullYear(),
+                month: this.$date.getUTCMonth() + 1,
+                day: this.$date.getUTCDate(),
+                hour: this.$date.getUTCHours(),
+                minute: this.$date.getUTCMinutes(),
+                second: this.$date.getSeconds(),
+            };
+        }
         return {
             year: this.$date.getFullYear(),
             month: this.$date.getMonth() + 1,
@@ -283,11 +290,20 @@ export class LocalTime {
             second: this.$date.getSeconds(),
         };
     }
+    fromNow(now = LocalTime.now()) {
+        const msDiff = LocalTime.of(now).unixMillis() - this.unixMillis();
+        if (msDiff === 0)
+            return 'now';
+        if (msDiff >= 0) {
+            return `${_ms(msDiff)} ago`;
+        }
+        return `in ${_ms(msDiff * -1)}`;
+    }
     getDate() {
         return this.$date;
     }
     clone() {
-        return new LocalTime(new Date(this.$date));
+        return new LocalTime(new Date(this.$date), this.utcMode);
     }
     unix() {
         return Math.floor(this.$date.valueOf() / 1000);
@@ -299,14 +315,31 @@ export class LocalTime {
         return Math.floor(this.$date.valueOf() / 1000);
     }
     toLocalDate() {
+        if (this.utcMode) {
+            return LocalDate.create(this.$date.getUTCFullYear(), this.$date.getUTCMonth() + 1, this.$date.getUTCDate());
+        }
         return LocalDate.create(this.$date.getFullYear(), this.$date.getMonth() + 1, this.$date.getDate());
     }
     toPretty(seconds = true) {
-        return this.$date
-            .toISOString()
-            .slice(0, seconds ? 19 : 16)
-            .split('T')
-            .join(' ');
+        const { year, month, day, hour, minute, second } = this.components();
+        return ([
+            String(year).padStart(4, '0'),
+            String(month).padStart(2, '0'),
+            String(day).padStart(2, '0'),
+        ].join('-') +
+            ' ' +
+            [
+                String(hour).padStart(2, '0'),
+                String(minute).padStart(2, '0'),
+                seconds && String(second).padStart(2, '0'),
+            ]
+                .filter(Boolean)
+                .join(':'));
+        // return this.$date
+        //   .toISOString()
+        //   .slice(0, seconds ? 19 : 16)
+        //   .split('T')
+        //   .join(' ')
     }
     /**
      * Returns e.g: `1984-06-21T17:56:21`, only the date part of DateTime
@@ -318,20 +351,41 @@ export class LocalTime {
      * Returns e.g: `1984-06-21`, only the date part of DateTime
      */
     toISODate() {
-        return this.$date.toISOString().slice(0, 10);
+        const { year, month, day } = this.components();
+        return [
+            String(year).padStart(4, '0'),
+            String(month).padStart(2, '0'),
+            String(day).padStart(2, '0'),
+        ].join('-');
+        // return this.$date.toISOString().slice(0, 10)
+    }
+    /**
+     * Returns e.g: `17:03:15` (or `17:03` with seconds=false)
+     */
+    toISOTime(seconds = true) {
+        // return this.$date.toISOString().slice(11, seconds ? 19 : 16)
+        const { hour, minute, second } = this.components();
+        return [
+            String(hour).padStart(2, '0'),
+            String(minute).padStart(2, '0'),
+            seconds && String(second).padStart(2, '0'),
+        ]
+            .filter(Boolean)
+            .join(':');
     }
     /**
      * Returns e.g: `19840621_1705`
      */
     toStringCompact(seconds = false) {
+        const { year, month, day, hour, minute, second } = this.components();
         return [
-            String(this.$date.getFullYear()).padStart(4, '0'),
-            String(this.$date.getMonth() + 1).padStart(2, '0'),
-            String(this.$date.getDate()).padStart(2, '0'),
+            String(year).padStart(4, '0'),
+            String(month).padStart(2, '0'),
+            String(day).padStart(2, '0'),
             '_',
-            String(this.$date.getHours()).padStart(2, '0'),
-            String(this.$date.getMinutes()).padStart(2, '0'),
-            seconds ? String(this.$date.getSeconds()).padStart(2, '0') : '',
+            String(hour).padStart(2, '0'),
+            String(minute).padStart(2, '0'),
+            seconds ? String(second).padStart(2, '0') : '',
         ].join('');
     }
     toString() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.91.2",
+  "version": "14.92.0",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",

package/src/datetime/localDate.ts

@@ -47,6 +47,10 @@ export class LocalDate {
     return new LocalDate(d.getFullYear(), d.getMonth() + 1, d.getDate())
   }
 
+  static fromDateUTC(d: Date): LocalDate {
+    return new LocalDate(d.getUTCFullYear(), d.getUTCMonth() + 1, d.getUTCDate())
+  }
+
   /**
    * Returns null if invalid.
    */
@@ -79,6 +83,10 @@ export class LocalDate {
     return this.fromDate(new Date())
   }
 
+  static todayUTC(): LocalDate {
+    return this.fromDateUTC(new Date())
+  }
+
   static sort(items: LocalDate[], mutate = false, descending = false): LocalDate[] {
     const mod = descending ? -1 : 1
     return (mutate ? items : [...items]).sort((a, b) => a.cmp(b) * mod)

package/src/datetime/localTime.ts

@@ -1,4 +1,5 @@
 import { _assert } from '../error/assert'
+import { _ms } from '../time/time.util'
 import { IsoDate, IsoDateTime, UnixTimestamp } from '../types'
 import { LocalDate } from './localDate'
 
@@ -30,7 +31,7 @@ export interface LocalTimeComponents {
  * @experimental
  */
 export class LocalTime {
-  private constructor(private $date: Date) {}
+  private constructor(private $date: Date, public utcMode: boolean) {}
 
   /**
    * Parses input String into LocalDate.
@@ -46,6 +47,16 @@ export class LocalTime {
     return t
   }
 
+  utc(): this {
+    this.utcMode = true
+    return this
+  }
+
+  local(): this {
+    this.utcMode = false
+    return this
+  }
+
   /**
    * Returns null if invalid
    */
@@ -68,63 +79,65 @@ export class LocalTime {
       return null
     }
 
-    return new LocalTime(date)
+    // if (utc) {
+    //   date.setMinutes(date.getMinutes() + date.getTimezoneOffset())
+    // }
+
+    return new LocalTime(date, false)
   }
 
   static isValid(d: LocalTimeConfig): boolean {
     return this.parseOrNull(d) !== null
   }
 
-  static unix(ts: UnixTimestamp): LocalTime {
-    return new LocalTime(new Date(ts * 1000))
-  }
-
   static now(): LocalTime {
-    return this.of(new Date())
+    return new LocalTime(new Date(), false)
   }
 
   static fromComponents(
     c: { year: number; month: number } & Partial<LocalTimeComponents>,
   ): LocalTime {
-    return new LocalTime(new Date(c.year, c.month - 1, c.day, c.hour, c.minute, c.second))
+    return new LocalTime(new Date(c.year, c.month - 1, c.day, c.hour, c.minute, c.second), false)
   }
 
   get(unit: LocalTimeUnit): number {
     if (unit === 'year') {
-      return this.$date.getFullYear()
+      return this.utcMode ? this.$date.getUTCFullYear() : this.$date.getFullYear()
     }
     if (unit === 'month') {
-      return this.$date.getMonth() + 1
+      return (this.utcMode ? this.$date.getUTCMonth() : this.$date.getMonth()) + 1
     }
     if (unit === 'day') {
-      return this.$date.getDate()
+      return this.utcMode ? this.$date.getUTCDate() : this.$date.getDate()
     }
     if (unit === 'hour') {
-      return this.$date.getHours()
+      return this.utcMode ? this.$date.getUTCHours() : this.$date.getHours()
     }
     if (unit === 'minute') {
-      return this.$date.getMinutes()
+      return this.utcMode ? this.$date.getUTCMinutes() : this.$date.getMinutes()
     }
     // second
-    return this.$date.getSeconds()
+    return this.utcMode ? this.$date.getUTCSeconds() : this.$date.getSeconds()
   }
 
   set(unit: LocalTimeUnit, v: number, mutate = false): LocalTime {
     const t = mutate ? this : this.clone()
 
+    /* eslint-disable @typescript-eslint/no-unused-expressions */
     if (unit === 'year') {
-      t.$date.setFullYear(v)
+      this.utcMode ? t.$date.setUTCFullYear(v) : t.$date.setFullYear(v)
     } else if (unit === 'month') {
-      t.$date.setMonth(v - 1)
+      this.utcMode ? t.$date.setUTCMonth(v - 1) : t.$date.setMonth(v - 1)
     } else if (unit === 'day') {
-      t.$date.setDate(v)
+      this.utcMode ? t.$date.setUTCDate(v) : t.$date.setDate(v)
     } else if (unit === 'hour') {
-      t.$date.setHours(v)
+      this.utcMode ? t.$date.setUTCHours(v) : t.$date.setHours(v)
     } else if (unit === 'minute') {
-      t.$date.setMinutes(v)
+      this.utcMode ? t.$date.setUTCMinutes(v) : t.$date.setMinutes(v)
     } else if (unit === 'second') {
-      t.$date.setSeconds(v)
+      this.utcMode ? t.$date.setUTCSeconds(v) : t.$date.setSeconds(v)
     }
+    /* eslint-enable @typescript-eslint/no-unused-expressions */
 
     return t
   }
@@ -132,57 +145,59 @@ export class LocalTime {
   year(): number
   year(v: number): LocalTime
   year(v?: number): number | LocalTime {
-    return v === undefined ? this.$date.getFullYear() : this.set('year', v)
+    return v === undefined ? this.get('year') : this.set('year', v)
   }
   month(): number
   month(v: number): LocalTime
   month(v?: number): number | LocalTime {
-    return v === undefined ? this.$date.getMonth() + 1 : this.set('month', v)
+    return v === undefined ? this.get('month') : this.set('month', v)
   }
   date(): number
   date(v: number): LocalTime
   date(v?: number): number | LocalTime {
-    return v === undefined ? this.$date.getDate() : this.set('day', v)
+    return v === undefined ? this.get('day') : this.set('day', v)
   }
   hour(): number
   hour(v: number): LocalTime
   hour(v?: number): number | LocalTime {
-    return v === undefined ? this.$date.getHours() : this.set('hour', v)
+    return v === undefined ? this.get('hour') : this.set('hour', v)
   }
   minute(): number
   minute(v: number): LocalTime
   minute(v?: number): number | LocalTime {
-    return v === undefined ? this.$date.getMinutes() : this.set('minute', v)
+    return v === undefined ? this.get('minute') : this.set('minute', v)
   }
   second(): number
   second(v: number): LocalTime
   second(v?: number): number | LocalTime {
-    return v === undefined ? this.$date.getSeconds() : this.set('second', v)
+    return v === undefined ? this.get('second') : this.set('second', v)
   }
 
   setComponents(c: Partial<LocalTimeComponents>, mutate = false): LocalTime {
     const d = mutate ? this.$date : new Date(this.$date)
 
+    /* eslint-disable @typescript-eslint/no-unused-expressions */
     if (c.year) {
-      d.setFullYear(c.year)
+      this.utcMode ? d.setUTCFullYear(c.year) : d.setFullYear(c.year)
     }
     if (c.month) {
-      d.setMonth(c.month - 1)
+      this.utcMode ? d.setUTCMonth(c.month - 1) : d.setMonth(c.month - 1)
     }
     if (c.day) {
-      d.setDate(c.day)
+      this.utcMode ? d.setUTCDate(c.day) : d.setDate(c.day)
     }
     if (c.hour !== undefined) {
-      d.setHours(c.hour)
+      this.utcMode ? d.setUTCHours(c.hour) : d.setHours(c.hour)
     }
     if (c.minute !== undefined) {
-      d.setMinutes(c.minute)
+      this.utcMode ? d.setUTCMinutes(c.minute) : d.setMinutes(c.minute)
     }
     if (c.second !== undefined) {
-      d.setSeconds(c.second)
+      this.utcMode ? d.setUTCSeconds(c.second) : d.setSeconds(c.second)
     }
+    /* eslint-enable @typescript-eslint/no-unused-expressions */
 
-    return mutate ? this : new LocalTime(d)
+    return mutate ? this : new LocalTime(d, this.utcMode)
   }
 
   add(num: number, unit: LocalTimeUnit, mutate = false): LocalTime {
@@ -190,7 +205,7 @@ export class LocalTime {
   }
 
   subtract(num: number, unit: LocalTimeUnit, mutate = false): LocalTime {
-    return this.add(-num, unit, mutate)
+    return this.add(num * -1, unit, mutate)
   }
 
   absDiff(other: LocalTimeConfig, unit: LocalTimeUnit): number {
@@ -233,36 +248,25 @@ export class LocalTime {
   startOf(unit: LocalTimeUnit, mutate = false): LocalTime {
     if (unit === 'second') return this
 
-    if (mutate) {
-      const d = this.$date
-      d.setSeconds(0)
-      if (unit === 'minute') return this
-      d.setMinutes(0)
-      if (unit === 'hour') return this
-      d.setHours(0)
-      if (unit === 'day') return this
-      d.setDate(0)
-      if (unit === 'month') return this
-      d.setMonth(0)
-      return this
-    }
-
-    const c = this.components()
+    const d = mutate ? this.$date : new Date(this.$date)
 
-    c.second = 0
-    if (unit === 'year') {
-      c.month = c.day = 1
-      c.hour = c.minute = 0
-    } else if (unit === 'month') {
-      c.day = 1
-      c.hour = c.minute = 0
-    } else if (unit === 'day') {
-      c.hour = c.minute = 0
-    } else if (unit === 'hour') {
-      c.minute = 0
+    /* eslint-disable @typescript-eslint/no-unused-expressions */
+    this.utcMode ? d.setUTCSeconds(0) : d.setSeconds(0)
+    if (unit !== 'minute') {
+      this.utcMode ? d.setUTCMinutes(0) : d.setMinutes(0)
+      if (unit !== 'hour') {
+        this.utcMode ? d.setUTCHours(0) : d.setHours(0)
+        if (unit !== 'day') {
+          this.utcMode ? d.setUTCDate(0) : d.setDate(0)
+          if (unit !== 'month') {
+            this.utcMode ? d.setUTCMonth(0) : d.setMonth(0)
+          }
+        }
+      }
     }
+    /* eslint-enable @typescript-eslint/no-unused-expressions */
 
-    return LocalTime.fromComponents(c)
+    return mutate ? this : new LocalTime(d, this.utcMode)
   }
 
   static sort(items: LocalTime[], mutate = false, descending = false): LocalTime[] {
@@ -330,6 +334,17 @@ export class LocalTime {
   // todo: endOf
 
   components(): LocalTimeComponents {
+    if (this.utcMode) {
+      return {
+        year: this.$date.getUTCFullYear(),
+        month: this.$date.getUTCMonth() + 1,
+        day: this.$date.getUTCDate(),
+        hour: this.$date.getUTCHours(),
+        minute: this.$date.getUTCMinutes(),
+        second: this.$date.getSeconds(),
+      }
+    }
+
     return {
       year: this.$date.getFullYear(),
       month: this.$date.getMonth() + 1,
@@ -340,12 +355,24 @@ export class LocalTime {
     }
   }
 
+  fromNow(now: LocalTimeConfig = LocalTime.now()): string {
+    const msDiff = LocalTime.of(now).unixMillis() - this.unixMillis()
+
+    if (msDiff === 0) return 'now'
+
+    if (msDiff >= 0) {
+      return `${_ms(msDiff)} ago`
+    }
+
+    return `in ${_ms(msDiff * -1)}`
+  }
+
   getDate(): Date {
     return this.$date
   }
 
   clone(): LocalTime {
-    return new LocalTime(new Date(this.$date))
+    return new LocalTime(new Date(this.$date), this.utcMode)
   }
 
   unix(): UnixTimestamp {
@@ -361,6 +388,14 @@ export class LocalTime {
   }
 
   toLocalDate(): LocalDate {
+    if (this.utcMode) {
+      return LocalDate.create(
+        this.$date.getUTCFullYear(),
+        this.$date.getUTCMonth() + 1,
+        this.$date.getUTCDate(),
+      )
+    }
+
     return LocalDate.create(
       this.$date.getFullYear(),
       this.$date.getMonth() + 1,
@@ -369,11 +404,29 @@ export class LocalTime {
   }
 
   toPretty(seconds = true): IsoDateTime {
-    return this.$date
-      .toISOString()
-      .slice(0, seconds ? 19 : 16)
-      .split('T')
-      .join(' ')
+    const { year, month, day, hour, minute, second } = this.components()
+
+    return (
+      [
+        String(year).padStart(4, '0'),
+        String(month).padStart(2, '0'),
+        String(day).padStart(2, '0'),
+      ].join('-') +
+      ' ' +
+      [
+        String(hour).padStart(2, '0'),
+        String(minute).padStart(2, '0'),
+        seconds && String(second).padStart(2, '0'),
+      ]
+        .filter(Boolean)
+        .join(':')
+    )
+
+    // return this.$date
+    //   .toISOString()
+    //   .slice(0, seconds ? 19 : 16)
+    //   .split('T')
+    //   .join(' ')
   }
 
   /**
@@ -387,21 +440,47 @@ export class LocalTime {
    * Returns e.g: `1984-06-21`, only the date part of DateTime
    */
   toISODate(): IsoDate {
-    return this.$date.toISOString().slice(0, 10)
+    const { year, month, day } = this.components()
+
+    return [
+      String(year).padStart(4, '0'),
+      String(month).padStart(2, '0'),
+      String(day).padStart(2, '0'),
+    ].join('-')
+
+    // return this.$date.toISOString().slice(0, 10)
+  }
+
+  /**
+   * Returns e.g: `17:03:15` (or `17:03` with seconds=false)
+   */
+  toISOTime(seconds = true): string {
+    // return this.$date.toISOString().slice(11, seconds ? 19 : 16)
+    const { hour, minute, second } = this.components()
+
+    return [
+      String(hour).padStart(2, '0'),
+      String(minute).padStart(2, '0'),
+      seconds && String(second).padStart(2, '0'),
+    ]
+      .filter(Boolean)
+      .join(':')
   }
 
   /**
    * Returns e.g: `19840621_1705`
    */
   toStringCompact(seconds = false): string {
+    const { year, month, day, hour, minute, second } = this.components()
+
     return [
-      String(this.$date.getFullYear()).padStart(4, '0'),
-      String(this.$date.getMonth() + 1).padStart(2, '0'),
-      String(this.$date.getDate()).padStart(2, '0'),
+      String(year).padStart(4, '0'),
+      String(month).padStart(2, '0'),
+      String(day).padStart(2, '0'),
       '_',
-      String(this.$date.getHours()).padStart(2, '0'),
-      String(this.$date.getMinutes()).padStart(2, '0'),
-      seconds ? String(this.$date.getSeconds()).padStart(2, '0') : '',
+      String(hour).padStart(2, '0'),
+      String(minute).padStart(2, '0'),
+      seconds ? String(second).padStart(2, '0') : '',
     ].join('')
   }