npm - nhb-toolbox - Versions diffs - 3.6.45 → 3.7.5 - Mend

nhb-toolbox 3.6.45 → 3.7.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/dist/date/Chronos.d.ts +68 -3
package/dist/date/Chronos.d.ts.map +1 -1
package/dist/date/Chronos.js +212 -7
package/package.json +1 -1

package/dist/date/Chronos.d.ts CHANGED Viewed

@@ -29,6 +29,8 @@ export declare class Chronos {
     toDate(): Date;
     /** * Returns a string representation of a date. The format of the string depends on the locale. */
     toString(): string;
+    /** * Returns ISO string with local time zone offset */
+    toLocalISOString(): string;
     /**
      *  * Wrapper over native `toLocaleString`
      * @description Converts a date and time to a string by using the current or specified locale.
@@ -41,10 +43,18 @@ export declare class Chronos {
     toISOString(): string;
     /** * Returns the time value in milliseconds since midnight, January 1, 1970 UTC. */
     getTimeStamp(): number;
-    /** * Returns the date value as a `Date` object. */
-    get date(): Date;
     /** * Returns the time value in milliseconds since midnight, January 1, 1970 UTC. */
     get unix(): number;
+    get year(): number;
+    get month(): number;
+    get date(): number;
+    get day(): number;
+    get hour(): number;
+    get minute(): number;
+    get second(): number;
+    get millisecond(): number;
+    /** * ISO weekday: 1 = Monday, 7 = Sunday */
+    get isoWeekday(): number;
     /**
      * @instance Returns the current date and time in a specified format in local time.
      * * Default format is dd, `MMM DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55:379`
@@ -210,7 +220,7 @@ export declare class Chronos {
      * * Returns a new Chronos instance at the start of a given unit.
      * @param unit The unit to reset (e.g., year, month, day).
      */
-    startOf(unit: TimeUnit): Chronos;
+    startOf(unit: TimeUnit | 'week'): Chronos;
     /**
      * * Returns a new Chronos instance at the end of a given unit.
      * @param unit The unit to adjust (e.g., year, month, day).
@@ -264,5 +274,60 @@ export declare class Chronos {
     calendar(baseDate?: number | string | Date | Chronos): string;
     /** * Returns a short human-readable string like "2h ago", "in 5m" */
     fromNowShort(): string;
+    /** * Returns ISO week number */
+    getWeek(): number;
+    /** * Returns ISO week year */
+    getWeekYear(): number;
+    /** * Returns day of year (1 - 366) */
+    getDayOfYear(): number;
+    /**
+     * * Checks if the current date is between the given start and end dates.
+     *
+     * @param start - The start of the range.
+     * @param end - The end of the range.
+     * @param inclusive - Specifies whether the comparison is inclusive or exclusive:
+     * - `'[]'`: inclusive of both start and end (≥ start and ≤ end)
+     * - `'[)'`: inclusive of start, exclusive of end (≥ start and < end)
+     * - `'(]'`: exclusive of start, inclusive of end (> start and ≤ end)
+     * - `'()'`: exclusive of both start and end (> start and < end)
+     *
+     * @returns `true` if the current date is within the specified range based on the `inclusive` mode.
+     */
+    isBetween(start: number | string | Date | Chronos, end: number | string | Date | Chronos, inclusive?: '[]' | '[)' | '(]' | '()'): boolean;
+    /** * Returns number of days in current month */
+    daysInMonth(): number;
+    /** * Converts to object with all date unit parts */
+    toObject(): {
+        year: number;
+        month: number;
+        isoMonth: number;
+        date: number;
+        day: number;
+        isoDay: number;
+        hour: number;
+        minute: number;
+        second: number;
+        millisecond: number;
+    };
+    /** * Converts to array with all date unit parts */
+    toArray(): [number, number, number, number, number, number, number];
+    /** * Returns offset like +06:00 */
+    getUTCOffset(): string;
+    /** * Checks if currently in DST */
+    isDST(): boolean;
+    /** * Returns new Chronos instance in UTC */
+    /** * Returns new Chronos instance in local time */
+    /** @static Parses a date string with a given format (partial support) */
+    static parse(dateStr: string, format: string): Chronos;
+    /**
+     * @static Returns earliest Chronos
+     * @param dates Date inputs.
+     */
+    static min(...dates: (number | string | Date | Chronos)[]): Chronos;
+    /**
+     * @static Returns latest Chronos
+     * @param dates Date inputs.
+     */
+    static max(...dates: (number | string | Date | Chronos)[]): Chronos;
 }
 //# sourceMappingURL=Chronos.d.ts.map

package/dist/date/Chronos.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Chronos.d.ts","sourceRoot":"","sources":["../../src/date/Chronos.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,OAAO,KAAK,EAEX,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,SAAS,CAAC;AAGjB,qBAAa,OAAO;;IAInB;;;;;;;;OAQG;gBACS,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO;IAOpD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;IAED;;;;OAIG;IACH,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAKnD,sEAAsE;IAC/D,KAAK,IAAI,OAAO;IAIvB,4EAA4E;IAC5E,MAAM,IAAI,MAAM;IAIhB,6EAA6E;IAC7E,OAAO,IAAI,MAAM;IAIjB,qDAAqD;IACrD,MAAM,IAAI,IAAI;IAId,mGAAmG;IACnG,QAAQ,IAAI,MAAM;IAIlB;;;;;;OAMG;IACH,cAAc,CACb,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,EAChE,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAClC,MAAM;IAIT,wDAAwD;IACxD,WAAW,IAAI,MAAM;IAIrB,oFAAoF;IACpF,YAAY,IAAI,MAAM;IAItB,~~mDAAmD~~;~~IACnD~~,IAAI,IAAI,IAAI,~~IAAI~~,~~CAEf~~;IAED,~~oFAAoF~~;~~IACpF~~,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;IAOtC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;IAO7C;;;;OAIG;IACH,MAAM,CAAC,GAAG,IAAI,MAAM;IAyGpB;;;;;;OAMG;IACH,MAAM,CACL,MAAM,GAAE,MAAwC,EAChD,MAAM,UAAQ,GACZ,MAAM;IAIT;;;;;OAKG;IACH,SAAS,CAAC,MAAM,GAAE,MAAwC,GAAG,MAAM;IAInE;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAMpC;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAMpC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMhC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAM9B;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAMlC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMhC;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInC;;;;;OAKG;IACH,UAAU,IAAI,OAAO;IAMrB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO;IAiB7C,6CAA6C;IAC7C,OAAO,IAAI,OAAO;IAIlB,gDAAgD;IAChD,UAAU,IAAI,OAAO;IAIrB,iDAAiD;IACjD,WAAW,IAAI,OAAO;IAItB;;;;;;;OAOG;IACH,OAAO,CACN,KAAK,GAAE,OAAO,CAAC,QAAQ,EAAE,aAAa,CAAY,EAClD,gBAAgB,GAAE,OAAc,EAChC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GACrC,MAAM;IA8FT;;;;OAIG;IACH,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM;IAiBhE;;;;OAIG;IACH,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM;IAgBjE;;;;;;;;;OASG;IACH,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM;IAe/D;;;;OAIG;IACH,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM;IAKhE;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM;IAKlE;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM;IAKlE;;;;OAIG;IACH,sBAAsB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM;IAIvE;;;;;;OAMG;IACH,OAAO,CACN,IAAI,GAAE,QAAmB,EACzB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GACrC,MAAM;IAqBT;;;OAGG;IACI,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO;~~IA8BvC~~;;;OAGG;IACI,KAAK,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO;IAIrC;;;;OAIG;IACI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO;IA8BnD;;;OAGG;IACI,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM;IAmBlC;;;;OAIG;IACI,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IA6BlD;;;;OAIG;IACI,IAAI,CACV,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,EACvC,IAAI,EAAE,QAAQ,GACZ,MAAM;IA0BT;;;;OAIG;IACI,MAAM,CACZ,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,EACvC,IAAI,EAAE,QAAQ,GACZ,OAAO;IASV;;;;OAIG;IACI,QAAQ,CACd,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,EACvC,IAAI,EAAE,QAAQ,GACZ,OAAO;IASV;;;;OAIG;IACI,OAAO,CACb,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,EACvC,IAAI,EAAE,QAAQ,GACZ,OAAO;IASV;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM;IA0B7D,qEAAqE;IACrE,YAAY,IAAI,MAAM;~~CAuBtB~~"}
1	+ {"version":3,"file":"Chronos.d.ts","sourceRoot":"","sources":["../../src/date/Chronos.ts"],"names":[],"mappings":"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"}

package/dist/date/Chronos.js CHANGED Viewed

@@ -19,7 +19,7 @@ export class Chronos {
         // this.preview = this.toISOString();
     }
     get [Symbol.toStringTag]() {
-        return this.toISOString();
+        return this.toLocalISOString();
     }
     /**
      * * Enables primitive coercion like `console.log`, `${chronos}`, etc.
@@ -29,7 +29,7 @@ export class Chronos {
     [Symbol.toPrimitive](hint) {
         if (hint === 'number')
             return this.valueOf();
-        return this.toString();
+        return this.toLocalISOString();
     }
     /** * Clones and returns a new Chronos instance with the same date. */
     clone() {
@@ -37,7 +37,7 @@ export class Chronos {
     }
     /** * Enables JSON.stringify and console logging to show readable output. */
     toJSON() {
-        return this.toISOString();
+        return this.toLocalISOString();
     }
     /** * Enables arithmetic and comparison operations (e.g., +new Chronos()). */
     valueOf() {
@@ -51,6 +51,11 @@ export class Chronos {
     toString() {
         return this.#date.toString();
     }
+    /** * Returns ISO string with local time zone offset */
+    toLocalISOString() {
+        const pad = (n, p = 2) => String(n).padStart(p, '0');
+        return `${this.year}-${pad(this.month + 1)}-${pad(this.date)}T${pad(this.hour)}:${pad(this.minute)}:${pad(this.second)}.${pad(this.millisecond, 3)}${this.getUTCOffset()}`;
+    }
     /**
      *  * Wrapper over native `toLocaleString`
      * @description Converts a date and time to a string by using the current or specified locale.
@@ -69,14 +74,39 @@ export class Chronos {
     getTimeStamp() {
         return this.#date.getTime();
     }
-    /** * Returns the date value as a `Date` object. */
-    get date() {
-        return this.#date;
-    }
     /** * Returns the time value in milliseconds since midnight, January 1, 1970 UTC. */
     get unix() {
         return this.#date.getTime();
     }
+    get year() {
+        return this.#date.getFullYear();
+    }
+    get month() {
+        return this.#date.getMonth();
+    }
+    get date() {
+        return this.#date.getDate();
+    }
+    get day() {
+        return this.#date.getDay();
+    }
+    get hour() {
+        return this.#date.getHours();
+    }
+    get minute() {
+        return this.#date.getMinutes();
+    }
+    get second() {
+        return this.#date.getSeconds();
+    }
+    get millisecond() {
+        return this.#date.getMilliseconds();
+    }
+    /** * ISO weekday: 1 = Monday, 7 = Sunday */
+    get isoWeekday() {
+        const day = this.day;
+        return day === 0 ? 7 : day;
+    }
     /**
      * @instance Returns the current date and time in a specified format in local time.
      * * Default format is dd, `MMM DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55:379`
@@ -529,6 +559,13 @@ export class Chronos {
                 d.setDate(1);
                 d.setHours(0, 0, 0, 0);
                 break;
+            case 'week': {
+                const day = d.getDay(); // 0 (Sun) - 6 (Sat)
+                const diff = (day + 6) % 7; // convert Sunday=0 to 6, Monday=1 to 0, etc.
+                d.setDate(d.getDate() - diff);
+                d.setHours(0, 0, 0, 0);
+                break;
+            }
             case 'day':
                 d.setHours(0, 0, 0, 0);
                 break;
@@ -749,4 +786,172 @@ export class Chronos {
             return `${suffix}${Math.floor(abs / 31536000)}y${postfix}`;
         }
     }
+    /** * Returns ISO week number */
+    getWeek() {
+        // ISO week starts on Monday
+        const target = this.startOf('week').add(3, 'day');
+        const firstThursday = new Chronos(new Date(target.year, 0, 4))
+            .startOf('week')
+            .add(3, 'day');
+        const daysDiff = target.diff(firstThursday, 'day');
+        const week = Math.floor(daysDiff / 7) + 1;
+        return week;
+    }
+    /** * Returns ISO week year */
+    getWeekYear() {
+        const d = this.startOf('week').add(3, 'day'); // Thursday of current ISO week
+        return d.year;
+    }
+    /** * Returns day of year (1 - 366) */
+    getDayOfYear() {
+        const start = new Date(this.year, 0, 1);
+        const diff = this.#date.getTime() - start.getTime();
+        return Math.floor(diff / 86400000) + 1;
+    }
+    /**
+     * * Checks if the current date is between the given start and end dates.
+     *
+     * @param start - The start of the range.
+     * @param end - The end of the range.
+     * @param inclusive - Specifies whether the comparison is inclusive or exclusive:
+     * - `'[]'`: inclusive of both start and end (≥ start and ≤ end)
+     * - `'[)'`: inclusive of start, exclusive of end (≥ start and < end)
+     * - `'(]'`: exclusive of start, inclusive of end (> start and ≤ end)
+     * - `'()'`: exclusive of both start and end (> start and < end)
+     *
+     * @returns `true` if the current date is within the specified range based on the `inclusive` mode.
+     */
+    isBetween(start, end, inclusive = '()') {
+        const s = new Chronos(start).valueOf();
+        const e = new Chronos(end).valueOf();
+        const t = this.valueOf();
+        switch (inclusive) {
+            case '[]':
+                return t >= s && t <= e;
+            case '[)':
+                return t >= s && t < e;
+            case '(]':
+                return t > s && t <= e;
+            case '()':
+                return t > s && t < e;
+        }
+    }
+    /** * Returns number of days in current month */
+    daysInMonth() {
+        return new Date(this.year, this.month + 1, 0).getDate();
+    }
+    /** * Converts to object with all date unit parts */
+    toObject() {
+        return {
+            year: this.year,
+            month: this.month,
+            isoMonth: this.month + 1,
+            date: this.date,
+            day: this.day,
+            isoDay: this.day + 1,
+            hour: this.hour,
+            minute: this.minute,
+            second: this.second,
+            millisecond: this.millisecond,
+        };
+    }
+    /** * Converts to array with all date unit parts */
+    toArray() {
+        return [
+            this.year,
+            this.month,
+            this.date,
+            this.hour,
+            this.minute,
+            this.second,
+            this.millisecond,
+        ];
+    }
+    /** * Returns offset like +06:00 */
+    getUTCOffset() {
+        const offset = -this.#date.getTimezoneOffset();
+        const sign = offset >= 0 ? '+' : '-';
+        const pad = (n) => String(Math.floor(Math.abs(n))).padStart(2, '0');
+        return `${sign}${pad(offset / 60)}:${pad(offset % 60)}`;
+    }
+    /** * Checks if currently in DST */
+    isDST() {
+        const jan = new Date(this.year, 0, 1);
+        const jul = new Date(this.year, 6, 1);
+        return (Math.min(jan.getTimezoneOffset(), jul.getTimezoneOffset()) !==
+            this.#date.getTimezoneOffset());
+    }
+    /** * Returns new Chronos instance in UTC */
+    // toUTC(): Chronos {
+    // 	// const utcDate = new Date(
+    // 	// 	Date.UTC(
+    // 	// 		this.#date.getFullYear(),
+    // 	// 		this.#date.getMonth(),
+    // 	// 		this.#date.getDate(),
+    // 	// 		this.#date.getHours(),
+    // 	// 		this.#date.getMinutes(),
+    // 	// 		this.#date.getSeconds(),
+    // 	// 		this.#date.getMilliseconds(),
+    // 	// 	),
+    // 	// );
+    // 	// return new Chronos(utcDate);
+    // 	const date = this.#date;
+    // 	const utc = new Date(date.getTime() + date.getTimezoneOffset() * 60000);
+    // 	return new Chronos(utc);
+    // }
+    /** * Returns new Chronos instance in local time */
+    // toLocal(): Chronos {
+    // 	const date = new Date(this.#date.getTime());
+    // 	date.setMinutes(date.getMinutes() + date.getTimezoneOffset());
+    // 	return new Chronos(date);
+    // }
+    /** @static Parses a date string with a given format (partial support) */
+    static parse(dateStr, format) {
+        const formatMap = {
+            YYYY: 'year',
+            MM: 'month',
+            DD: 'date',
+            HH: 'hour',
+            mm: 'minute',
+            ss: 'second',
+        };
+        const regex = format.replace(/YYYY|MM|DD|HH|mm|ss/g, (match) => {
+            return `(?<${match}>\\d{${match.length}})`;
+        });
+        const match = new RegExp(`^${regex}$`).exec(dateStr);
+        if (!match?.groups) {
+            throw new Error('Invalid date format');
+        }
+        const values = Object.entries(match.groups).reduce((acc, [key, val]) => {
+            const map = formatMap[key];
+            if (map) {
+                acc[map] = Number(val);
+            }
+            return acc;
+        }, {});
+        return new Chronos(new Date(values.year ?? 1970, (values.month ?? 1) - 1, values.date ?? 1, values.hour ?? 0, values.minute ?? 0, values.second ?? 0));
+    }
+    // /**
+    //  * @static Creates UTC Chronos
+    //  * @param dateLike Date input to create utc time.
+    //  */
+    // static utc(dateLike: number | string | Date | Chronos): Chronos {
+    // 	const date = new Chronos(dateLike).toDate();
+    // 	const utc = new Date(date.getTime() + date.getTimezoneOffset() * 60000);
+    // 	return new Chronos(utc);
+    // }
+    /**
+     * @static Returns earliest Chronos
+     * @param dates Date inputs.
+     */
+    static min(...dates) {
+        return new Chronos(Math.min(...dates.map((d) => new Chronos(d).valueOf())));
+    }
+    /**
+     * @static Returns latest Chronos
+     * @param dates Date inputs.
+     */
+    static max(...dates) {
+        return new Chronos(Math.max(...dates.map((d) => new Chronos(d).valueOf())));
+    }
 }

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "3.6.45",
+  "version": "3.7.5",
   "description": "A versatile collection of smart, efficient, and reusable utility functions for everyday development needs.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",