@naturalcycles/js-lib 14.91.0 → 14.92.0

package/dist/datetime/localDate.d.ts

@@ -1,5 +1,6 @@
 import { Sequence } from '../seq/seq';
-import { IsoDate } from '../types';
+import { IsoDate, UnixTimestamp } from '../types';
+import { LocalTime } from './localTime';
 export declare type LocalDateUnit = 'year' | 'month' | 'day';
 export declare type LocalDateConfig = LocalDate | string;
 /**
@@ -18,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;
@@ -70,8 +73,12 @@ export declare class LocalDate {
      * Timezone will match local timezone.
      */
     toDate(): Date;
+    toLocalTime(): LocalTime;
+    toISODate(): IsoDate;
     toString(): IsoDate;
     toStringCompact(): string;
+    unix(): UnixTimestamp;
+    unixMillis(): number;
     toJSON(): IsoDate;
 }
 /**

package/dist/datetime/localDate.js

@@ -4,6 +4,7 @@ exports.localDate = exports.LocalDate = void 0;
 const assert_1 = require("../error/assert");
 const seq_1 = require("../seq/seq");
 const types_1 = require("../types");
+const localTime_1 = require("./localTime");
 const m31 = new Set([1, 3, 5, 7, 8, 10, 12]);
 /**
  * @experimental
@@ -38,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.
      */
@@ -63,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);
@@ -282,6 +289,12 @@ class LocalDate {
     toDate() {
         return new Date(this.year, this.month - 1, this.day);
     }
+    toLocalTime() {
+        return localTime_1.LocalTime.of(this.toDate());
+    }
+    toISODate() {
+        return this.toString();
+    }
     toString() {
         return [
             String(this.year).padStart(4, '0'),
@@ -296,6 +309,13 @@ class LocalDate {
             String(this.day).padStart(2, '0'),
         ].join('');
     }
+    // May be not optimal, as LocalTime better suits it
+    unix() {
+        return Math.floor(this.toDate().valueOf() / 1000);
+    }
+    unixMillis() {
+        return this.toDate().valueOf();
+    }
     toJSON() {
         return this.toString();
     }

package/dist/datetime/localTime.d.ts

@@ -1,4 +1,5 @@
-import { IsoDateTime, UnixTimestamp } from '../types';
+import { IsoDate, IsoDateTime, UnixTimestamp } from '../types';
+import { LocalDate } from './localDate';
 export declare type LocalTimeUnit = 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second';
 export declare type LocalTimeConfig = LocalTime | Date | IsoDateTime | UnixTimestamp;
 export interface LocalTimeComponents {
@@ -14,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;
@@ -68,12 +71,26 @@ export declare class LocalTime {
      */
     cmp(d: LocalTimeConfig): -1 | 0 | 1;
     components(): LocalTimeComponents;
+    fromNow(now?: LocalTimeConfig): string;
     getDate(): Date;
     clone(): LocalTime;
     unix(): UnixTimestamp;
+    unixMillis(): number;
     valueOf(): UnixTimestamp;
-    toISO8601(): IsoDateTime;
+    toLocalDate(): LocalDate;
     toPretty(seconds?: boolean): IsoDateTime;
+    /**
+     * Returns e.g: `1984-06-21T17:56:21`, only the date part of DateTime
+     */
+    toISODateTime(): IsoDateTime;
+    /**
+     * 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,8 @@
 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:
 // No milliseconds
@@ -16,8 +18,9 @@ const assert_1 = require("../error/assert");
  * @experimental
  */
 class LocalTime {
-    constructor($date) {
+    constructor($date, utcMode) {
         this.$date = $date;
+        this.utcMode = utcMode;
     }
     /**
      * Parses input String into LocalDate.
@@ -30,6 +33,14 @@ class LocalTime {
         }
         return t;
     }
+    utc() {
+        this.utcMode = true;
+        return this;
+    }
+    local() {
+        this.utcMode = false;
+        return this;
+    }
     /**
      * Returns null if invalid
      */
@@ -51,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));
@@ -188,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;
@@ -276,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,
@@ -285,40 +293,102 @@ 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);
     }
+    unixMillis() {
+        return this.$date.valueOf();
+    }
     valueOf() {
         return Math.floor(this.$date.valueOf() / 1000);
     }
-    toISO8601() {
-        return this.$date.toISOString().slice(0, 19);
+    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
+     */
+    toISODateTime() {
+        return this.$date.toISOString().slice(0, 19);
+    }
+    /**
+     * Returns e.g: `1984-06-21`, only the date part of DateTime
+     */
+    toISODate() {
+        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

@@ -1,6 +1,7 @@
 import { _assert } from '../error/assert';
 import { Sequence } from '../seq/seq';
 import { END } from '../types';
+import { LocalTime } from './localTime';
 const m31 = new Set([1, 3, 5, 7, 8, 10, 12]);
 /**
  * @experimental
@@ -35,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.
      */
@@ -60,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);
@@ -279,6 +286,12 @@ export class LocalDate {
     toDate() {
         return new Date(this.year, this.month - 1, this.day);
     }
+    toLocalTime() {
+        return LocalTime.of(this.toDate());
+    }
+    toISODate() {
+        return this.toString();
+    }
     toString() {
         return [
             String(this.year).padStart(4, '0'),
@@ -293,6 +306,13 @@ export class LocalDate {
             String(this.day).padStart(2, '0'),
         ].join('');
     }
+    // May be not optimal, as LocalTime better suits it
+    unix() {
+        return Math.floor(this.toDate().valueOf() / 1000);
+    }
+    unixMillis() {
+        return this.toDate().valueOf();
+    }
     toJSON() {
         return this.toString();
     }