nhb-toolbox 4.26.64 → 4.26.66

package/CHANGELOG.md

@@ -6,6 +6,10 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.26.66] - 2025-11-17
+
+- **Changed** the signature of `Chronos` `get()` method to `get<Unit extends TimeUnit>(unit: Unit): TimeUnitValue<Unit>` to align with `set()` method.
+
 ## [4.26.64] - 2025-11-17
 
 ### 🕧 Fixes in Chronos

package/dist/cjs/date/Chronos.js

@@ -60,22 +60,22 @@ class Chronos {
         yield ['minute', this.minute];
         yield ['second', this.second];
         yield ['millisecond', this.millisecond];
-        yield ['timestamp', this.timestamp];
+        yield ['timestamp', this.getTimeStamp()];
         yield ['unix', this.unix];
     }
     [Symbol.toPrimitive](hint) {
         if (hint === 'number')
-            return this.valueOf();
+            return this.getTimeStamp();
         return this.toLocalISOString();
     }
     [Symbol.replace](string, replacement) {
-        return string.replace(this.#removeUTCFromISO(true), replacement);
+        return string.replace(this.#removeUTCFromISO(), replacement);
     }
     [Symbol.search](string) {
-        return string.indexOf(this.#removeUTCFromISO(true));
+        return string.indexOf(this.#removeUTCFromISO());
     }
     [Symbol.split](string) {
-        return string.split(this.#removeUTCFromISO(true));
+        return string.split(this.#removeUTCFromISO());
     }
     [Symbol.match](string) {
         const [datePart, timePart] = this.toLocalISOString().split('.')[0].split('T');
@@ -154,7 +154,6 @@ class Chronos {
         const minutes = _getUnitValue('Minutes');
         const seconds = _getUnitValue('Seconds');
         const milliseconds = _getUnitValue('Milliseconds');
-        const timeZone = useUTC ? 'Z' : this.getTimeZoneOffset();
         const dateComponents = {
             YYYY: String(year),
             YY: String(year).slice(-2),
@@ -182,7 +181,7 @@ class Chronos {
             mss: String(milliseconds).padStart(3, '0'),
             a: hours < 12 ? 'am' : 'pm',
             A: hours < 12 ? 'AM' : 'PM',
-            ZZ: timeZone,
+            ZZ: useUTC ? 'Z' : this.getTimeZoneOffset(),
         };
         const tokenRegex = new RegExp(`^(${constants_1.SORTED_TIME_FORMATS.join('|')})`);
         let result = '';
@@ -208,10 +207,11 @@ class Chronos {
         }
         return result;
     }
-    #removeUTCFromISO(local = false) {
+    #removeUTCFromISO(local = true) {
+        const search = /\.\d+(Z|[+-]\d{2}:\d{2})?$/;
         return local ?
-            this.toLocalISOString().replace(/\.\d+(Z|[+-]\d{2}:\d{2})?$/, '')
-            : this.toISOString().replace(/\.\d+(Z|[+-]\d{2}:\d{2})?$/, '');
+            this.toLocalISOString().replace(search, '')
+            : this.toISOString().replace(search, '');
     }
     get year() {
         return this.#date.getFullYear();
@@ -269,7 +269,7 @@ class Chronos {
         const targetOffset = (0, utils_1.extractMinutesFromUTC)(this.#offset);
         const systemOffset = this.getUTCOffsetMinutes();
         const adjustmentMs = (targetOffset - systemOffset) * 60_000;
-        return new Date(this.#date.getTime() - adjustmentMs);
+        return new Date(this.#timestamp - adjustmentMs);
     }
     toString() {
         return this.#format('dd mmm DD YYYY HH:mm:ss ')
@@ -322,31 +322,25 @@ class Chronos {
         return (0, guards_1.isLeapYear)(year ?? this.year);
     }
     isEqual(other) {
-        const time = _a.#cast(other);
-        return this.#timestamp === time.#timestamp;
+        return this.#timestamp === _a.#cast(other).#timestamp;
     }
     isEqualOrBefore(other) {
-        const time = _a.#cast(other);
-        return this.#timestamp <= time.#timestamp;
+        return this.#timestamp <= _a.#cast(other).#timestamp;
     }
     isEqualOrAfter(other) {
-        const time = _a.#cast(other);
-        return this.#timestamp >= time.#timestamp;
+        return this.#timestamp >= _a.#cast(other).#timestamp;
     }
     isSame(other, unit, weekStartsOn = 0) {
-        const time = _a.#cast(other);
         return (this.startOf(unit, weekStartsOn).#timestamp ===
-            time.startOf(unit, weekStartsOn).#timestamp);
+            _a.#cast(other).startOf(unit, weekStartsOn).#timestamp);
     }
     isBefore(other, unit, weekStartsOn = 0) {
-        const time = _a.#cast(other);
         return (this.startOf(unit, weekStartsOn).#timestamp <
-            time.startOf(unit, weekStartsOn).#timestamp);
+            _a.#cast(other).startOf(unit, weekStartsOn).#timestamp);
     }
     isAfter(other, unit, weekStartsOn = 0) {
-        const time = _a.#cast(other);
         return (this.startOf(unit, weekStartsOn).#timestamp >
-            time.startOf(unit, weekStartsOn).#timestamp);
+            _a.#cast(other).startOf(unit, weekStartsOn).#timestamp);
     }
     isSameOrBefore(other, unit, weekStartsOn = 0) {
         return (this.isSame(other, unit, weekStartsOn) || this.isBefore(other, unit, weekStartsOn));
@@ -355,9 +349,9 @@ class Chronos {
         return (this.isSame(other, unit, weekStartsOn) || this.isAfter(other, unit, weekStartsOn));
     }
     isBetween(start, end, inclusive = '()') {
-        const s = new _a(start).valueOf();
-        const e = new _a(end).valueOf();
-        const t = this.valueOf();
+        const s = _a.#cast(start).getTimeStamp();
+        const e = _a.#cast(end).getTimeStamp();
+        const t = this.getTimeStamp();
         switch (inclusive) {
             case '[]':
                 return t >= s && t <= e;
@@ -466,21 +460,21 @@ class Chronos {
     get(unit) {
         switch (unit) {
             case 'year':
-                return this.#date.getFullYear();
+                return this.year;
             case 'month':
-                return this.#date.getMonth();
+                return this.isoMonth;
             case 'day':
-                return this.#date.getDate();
+                return this.date;
             case 'week':
                 return this.getWeek();
             case 'hour':
-                return this.#date.getHours();
+                return this.hour;
             case 'minute':
-                return this.#date.getMinutes();
+                return this.minute;
             case 'second':
-                return this.#date.getSeconds();
+                return this.second;
             case 'millisecond':
-                return this.#date.getMilliseconds();
+                return this.millisecond;
         }
     }
     set(unit, value) {
@@ -514,7 +508,7 @@ class Chronos {
     }
     diff(other, unit) {
         const time = _a.#cast(other);
-        const msDiff = this.#date.getTime() - time.#date.getTime();
+        const msDiff = this.#timestamp - time.#timestamp;
         switch (unit) {
             case 'millisecond':
                 return msDiff;
@@ -540,7 +534,7 @@ class Chronos {
         }
     }
     calendar(baseDate) {
-        const base = baseDate ? new _a(baseDate) : new _a();
+        const base = baseDate ? _a.#cast(baseDate) : new _a();
         const input = this.startOf('day');
         const comparison = base.startOf('day');
         const diff = input.diff(comparison, 'day');
@@ -651,12 +645,12 @@ class Chronos {
     }
     toUTC() {
         const offset = this.getTimeZoneOffsetMinutes();
-        const utc = new Date(this.#date.getTime() - offset * 60 * 1000);
+        const utc = new Date(this.#timestamp - offset * 60 * 1000);
         return new _a(utc).#withOrigin('toUTC', 'UTC+00:00', 'Greenwich Mean Time', 'UTC');
     }
     toLocal() {
         const offset = this.getTimeZoneOffsetMinutes() - this.getUTCOffsetMinutes();
-        const localTime = new Date(this.#date.getTime() - offset * 60 * 1000);
+        const localTime = new Date(this.#timestamp - offset * 60 * 1000);
         return new _a(localTime).#withOrigin('toLocal');
     }
     day(index) {
@@ -671,10 +665,10 @@ class Chronos {
         if (options) {
             if ('from' in options || 'to' in options) {
                 if (options?.from) {
-                    startDate = new _a(options?.from);
+                    startDate = _a.#cast(options?.from);
                 }
                 if (options?.to) {
-                    endDate = new _a(options?.to);
+                    endDate = _a.#cast(options?.to);
                 }
             }
             else if ('span' in options || 'unit' in options) {
@@ -771,8 +765,7 @@ class Chronos {
     }
     static today(options) {
         const { format = 'dd, mmm DD, YYYY HH:mm:ss', useUTC = false } = options || {};
-        const today = new Date();
-        return new _a(today).#format(format, useUTC);
+        return new _a().#format(format, useUTC);
     }
     static yesterday() {
         const today = new Date();
@@ -790,7 +783,7 @@ class Chronos {
     static utc(dateLike) {
         const chronos = new _a(dateLike);
         const offset = chronos.getTimeZoneOffsetMinutes();
-        const utc = new Date(chronos.#date.getTime() - offset * 60 * 1000);
+        const utc = new Date(chronos.#timestamp - offset * 60 * 1000);
         return new _a(utc).#withOrigin('utc', 'UTC+00:00', 'Greenwich Mean Time', 'UTC');
     }
     static formatTimePart(time, format) {
@@ -806,10 +799,10 @@ class Chronos {
         if (options) {
             if ('from' in options || 'to' in options) {
                 if (options?.from) {
-                    startDate = new _a(options?.from);
+                    startDate = _a.#cast(options?.from);
                 }
                 if (options?.to) {
-                    endDate = new _a(options?.to);
+                    endDate = _a.#cast(options?.to);
                 }
             }
             else if ('span' in options || 'unit' in options) {
@@ -834,7 +827,7 @@ class Chronos {
         let winner = _a.#cast(dates[0]);
         for (const d of dates) {
             const c = _a.#cast(d);
-            if (c.timestamp < winner.timestamp) {
+            if (c.getTimeStamp() < winner.getTimeStamp()) {
                 winner = c;
             }
         }
@@ -844,7 +837,7 @@ class Chronos {
         let winner = _a.#cast(dates[0]);
         for (const d of dates) {
             const c = _a.#cast(d);
-            if (c.timestamp > winner.timestamp) {
+            if (c.getTimeStamp() > winner.getTimeStamp()) {
                 winner = c;
             }
         }
@@ -861,7 +854,7 @@ class Chronos {
             }
         }
         else {
-            year = date instanceof _a ? date.year : new _a(date).year;
+            year = _a.#cast(date).year;
         }
         return (0, guards_1.isLeapYear)(year);
     }

package/dist/dts/date/Chronos.d.ts

@@ -418,9 +418,9 @@ export declare class Chronos {
     subtract(number: number, unit: TimeUnit): Chronos;
     /**
      * @instance Gets the value of a specific time unit from the date.
-     * @param unit The unit to retrieve.
+     * @param unit The unit to retrieve. Type of return value is determined by `unit`.
      */
-    get(unit: TimeUnit): number;
+    get<Unit extends TimeUnit>(unit: Unit): TimeUnitValue<Unit>;
     /**
      * @instance Returns a new `Chronos` instance with the specified unit set to the given value.
      * @param unit The unit to modify. Type of `value` is determined by `unit`.

package/dist/dts/date/types.d.ts

@@ -82,7 +82,7 @@ export type Second = (typeof SECOND_FORMATS)[number];
 export type Millisecond = (typeof MILLISECOND_FORMATS)[number];
 /** Time formats in either capital or lowercase `am/pm` format */
 export type TimeFormats = (typeof TIME_FORMATS)[number];
-/** Represents a valid unit suffix for {@link Date} getter methods (e.g., 'getFullYear', 'getMonth' etc.). */
+/** Represents a unit suffix for {@link Date} getter methods (e.g., `'FullYear'` in `'getFullYear'`, `'Month'` in `'getMonth'` etc.). */
 export type $DateUnit = 'FullYear' | 'Month' | 'Day' | 'Date' | 'Hours' | 'Minutes' | 'Seconds' | 'Milliseconds';
 /** Standard union formats for `Chronos`. */
 export type ChronosFormat = Year | Month | Day | MonthDate | Hour | Minute | Second | Millisecond | TimeFormats | 'ZZ';
@@ -314,7 +314,7 @@ export interface RelativeRangeOptions {
     span?: number;
     /** - Unit of time to advance the date range. Defaults to `'week'`.  Controlled by the `span` option. */
     unit?: 'year' | 'month' | 'week' | 'day';
-    /** - Output format — return as local ISO string or UTC ISO string. Defaults to `'local'`. */
+    /** - Output format: return as local ISO string or UTC ISO string. Defaults to `'local'`. */
     format?: 'local' | 'utc';
     /** Whether to round the dates in the range to the start of the day. Default is `false`. */
     roundDate?: boolean;
@@ -358,7 +358,7 @@ export interface RelativeDateRange {
     span?: number;
     /** - Unit of time to advance the date range. Defaults to `'week'`.  Controlled by the `span` option. */
     unit?: 'year' | 'month' | 'week' | 'day';
-    /** - Output format — return as local ISO string or UTC ISO string. Defaults to `'local'`. */
+    /** - Output format: return as local ISO string or UTC ISO string. Defaults to `'local'`. */
     format?: 'local' | 'utc';
     /**
      * An array of weekdays to exclude from the date range.

package/dist/esm/date/Chronos.js

@@ -57,22 +57,22 @@ export class Chronos {
         yield ['minute', this.minute];
         yield ['second', this.second];
         yield ['millisecond', this.millisecond];
-        yield ['timestamp', this.timestamp];
+        yield ['timestamp', this.getTimeStamp()];
         yield ['unix', this.unix];
     }
     [Symbol.toPrimitive](hint) {
         if (hint === 'number')
-            return this.valueOf();
+            return this.getTimeStamp();
         return this.toLocalISOString();
     }
     [Symbol.replace](string, replacement) {
-        return string.replace(this.#removeUTCFromISO(true), replacement);
+        return string.replace(this.#removeUTCFromISO(), replacement);
     }
     [Symbol.search](string) {
-        return string.indexOf(this.#removeUTCFromISO(true));
+        return string.indexOf(this.#removeUTCFromISO());
     }
     [Symbol.split](string) {
-        return string.split(this.#removeUTCFromISO(true));
+        return string.split(this.#removeUTCFromISO());
     }
     [Symbol.match](string) {
         const [datePart, timePart] = this.toLocalISOString().split('.')[0].split('T');
@@ -151,7 +151,6 @@ export class Chronos {
         const minutes = _getUnitValue('Minutes');
         const seconds = _getUnitValue('Seconds');
         const milliseconds = _getUnitValue('Milliseconds');
-        const timeZone = useUTC ? 'Z' : this.getTimeZoneOffset();
         const dateComponents = {
             YYYY: String(year),
             YY: String(year).slice(-2),
@@ -179,7 +178,7 @@ export class Chronos {
             mss: String(milliseconds).padStart(3, '0'),
             a: hours < 12 ? 'am' : 'pm',
             A: hours < 12 ? 'AM' : 'PM',
-            ZZ: timeZone,
+            ZZ: useUTC ? 'Z' : this.getTimeZoneOffset(),
         };
         const tokenRegex = new RegExp(`^(${SORTED_TIME_FORMATS.join('|')})`);
         let result = '';
@@ -205,10 +204,11 @@ export class Chronos {
         }
         return result;
     }
-    #removeUTCFromISO(local = false) {
+    #removeUTCFromISO(local = true) {
+        const search = /\.\d+(Z|[+-]\d{2}:\d{2})?$/;
         return local ?
-            this.toLocalISOString().replace(/\.\d+(Z|[+-]\d{2}:\d{2})?$/, '')
-            : this.toISOString().replace(/\.\d+(Z|[+-]\d{2}:\d{2})?$/, '');
+            this.toLocalISOString().replace(search, '')
+            : this.toISOString().replace(search, '');
     }
     get year() {
         return this.#date.getFullYear();
@@ -266,7 +266,7 @@ export class Chronos {
         const targetOffset = extractMinutesFromUTC(this.#offset);
         const systemOffset = this.getUTCOffsetMinutes();
         const adjustmentMs = (targetOffset - systemOffset) * 60_000;
-        return new Date(this.#date.getTime() - adjustmentMs);
+        return new Date(this.#timestamp - adjustmentMs);
     }
     toString() {
         return this.#format('dd mmm DD YYYY HH:mm:ss ')
@@ -319,31 +319,25 @@ export class Chronos {
         return isLeapYear(year ?? this.year);
     }
     isEqual(other) {
-        const time = _a.#cast(other);
-        return this.#timestamp === time.#timestamp;
+        return this.#timestamp === _a.#cast(other).#timestamp;
     }
     isEqualOrBefore(other) {
-        const time = _a.#cast(other);
-        return this.#timestamp <= time.#timestamp;
+        return this.#timestamp <= _a.#cast(other).#timestamp;
     }
     isEqualOrAfter(other) {
-        const time = _a.#cast(other);
-        return this.#timestamp >= time.#timestamp;
+        return this.#timestamp >= _a.#cast(other).#timestamp;
     }
     isSame(other, unit, weekStartsOn = 0) {
-        const time = _a.#cast(other);
         return (this.startOf(unit, weekStartsOn).#timestamp ===
-            time.startOf(unit, weekStartsOn).#timestamp);
+            _a.#cast(other).startOf(unit, weekStartsOn).#timestamp);
     }
     isBefore(other, unit, weekStartsOn = 0) {
-        const time = _a.#cast(other);
         return (this.startOf(unit, weekStartsOn).#timestamp <
-            time.startOf(unit, weekStartsOn).#timestamp);
+            _a.#cast(other).startOf(unit, weekStartsOn).#timestamp);
     }
     isAfter(other, unit, weekStartsOn = 0) {
-        const time = _a.#cast(other);
         return (this.startOf(unit, weekStartsOn).#timestamp >
-            time.startOf(unit, weekStartsOn).#timestamp);
+            _a.#cast(other).startOf(unit, weekStartsOn).#timestamp);
     }
     isSameOrBefore(other, unit, weekStartsOn = 0) {
         return (this.isSame(other, unit, weekStartsOn) || this.isBefore(other, unit, weekStartsOn));
@@ -352,9 +346,9 @@ export class Chronos {
         return (this.isSame(other, unit, weekStartsOn) || this.isAfter(other, unit, weekStartsOn));
     }
     isBetween(start, end, inclusive = '()') {
-        const s = new _a(start).valueOf();
-        const e = new _a(end).valueOf();
-        const t = this.valueOf();
+        const s = _a.#cast(start).getTimeStamp();
+        const e = _a.#cast(end).getTimeStamp();
+        const t = this.getTimeStamp();
         switch (inclusive) {
             case '[]':
                 return t >= s && t <= e;
@@ -463,21 +457,21 @@ export class Chronos {
     get(unit) {
         switch (unit) {
             case 'year':
-                return this.#date.getFullYear();
+                return this.year;
             case 'month':
-                return this.#date.getMonth();
+                return this.isoMonth;
             case 'day':
-                return this.#date.getDate();
+                return this.date;
             case 'week':
                 return this.getWeek();
             case 'hour':
-                return this.#date.getHours();
+                return this.hour;
             case 'minute':
-                return this.#date.getMinutes();
+                return this.minute;
             case 'second':
-                return this.#date.getSeconds();
+                return this.second;
             case 'millisecond':
-                return this.#date.getMilliseconds();
+                return this.millisecond;
         }
     }
     set(unit, value) {
@@ -511,7 +505,7 @@ export class Chronos {
     }
     diff(other, unit) {
         const time = _a.#cast(other);
-        const msDiff = this.#date.getTime() - time.#date.getTime();
+        const msDiff = this.#timestamp - time.#timestamp;
         switch (unit) {
             case 'millisecond':
                 return msDiff;
@@ -537,7 +531,7 @@ export class Chronos {
         }
     }
     calendar(baseDate) {
-        const base = baseDate ? new _a(baseDate) : new _a();
+        const base = baseDate ? _a.#cast(baseDate) : new _a();
         const input = this.startOf('day');
         const comparison = base.startOf('day');
         const diff = input.diff(comparison, 'day');
@@ -648,12 +642,12 @@ export class Chronos {
     }
     toUTC() {
         const offset = this.getTimeZoneOffsetMinutes();
-        const utc = new Date(this.#date.getTime() - offset * 60 * 1000);
+        const utc = new Date(this.#timestamp - offset * 60 * 1000);
         return new _a(utc).#withOrigin('toUTC', 'UTC+00:00', 'Greenwich Mean Time', 'UTC');
     }
     toLocal() {
         const offset = this.getTimeZoneOffsetMinutes() - this.getUTCOffsetMinutes();
-        const localTime = new Date(this.#date.getTime() - offset * 60 * 1000);
+        const localTime = new Date(this.#timestamp - offset * 60 * 1000);
         return new _a(localTime).#withOrigin('toLocal');
     }
     day(index) {
@@ -668,10 +662,10 @@ export class Chronos {
         if (options) {
             if ('from' in options || 'to' in options) {
                 if (options?.from) {
-                    startDate = new _a(options?.from);
+                    startDate = _a.#cast(options?.from);
                 }
                 if (options?.to) {
-                    endDate = new _a(options?.to);
+                    endDate = _a.#cast(options?.to);
                 }
             }
             else if ('span' in options || 'unit' in options) {
@@ -768,8 +762,7 @@ export class Chronos {
     }
     static today(options) {
         const { format = 'dd, mmm DD, YYYY HH:mm:ss', useUTC = false } = options || {};
-        const today = new Date();
-        return new _a(today).#format(format, useUTC);
+        return new _a().#format(format, useUTC);
     }
     static yesterday() {
         const today = new Date();
@@ -787,7 +780,7 @@ export class Chronos {
     static utc(dateLike) {
         const chronos = new _a(dateLike);
         const offset = chronos.getTimeZoneOffsetMinutes();
-        const utc = new Date(chronos.#date.getTime() - offset * 60 * 1000);
+        const utc = new Date(chronos.#timestamp - offset * 60 * 1000);
         return new _a(utc).#withOrigin('utc', 'UTC+00:00', 'Greenwich Mean Time', 'UTC');
     }
     static formatTimePart(time, format) {
@@ -803,10 +796,10 @@ export class Chronos {
         if (options) {
             if ('from' in options || 'to' in options) {
                 if (options?.from) {
-                    startDate = new _a(options?.from);
+                    startDate = _a.#cast(options?.from);
                 }
                 if (options?.to) {
-                    endDate = new _a(options?.to);
+                    endDate = _a.#cast(options?.to);
                 }
             }
             else if ('span' in options || 'unit' in options) {
@@ -831,7 +824,7 @@ export class Chronos {
         let winner = _a.#cast(dates[0]);
         for (const d of dates) {
             const c = _a.#cast(d);
-            if (c.timestamp < winner.timestamp) {
+            if (c.getTimeStamp() < winner.getTimeStamp()) {
                 winner = c;
             }
         }
@@ -841,7 +834,7 @@ export class Chronos {
         let winner = _a.#cast(dates[0]);
         for (const d of dates) {
             const c = _a.#cast(d);
-            if (c.timestamp > winner.timestamp) {
+            if (c.getTimeStamp() > winner.getTimeStamp()) {
                 winner = c;
             }
         }
@@ -858,7 +851,7 @@ export class Chronos {
             }
         }
         else {
-            year = date instanceof _a ? date.year : new _a(date).year;
+            year = _a.#cast(date).year;
         }
         return isLeapYear(year);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.26.64",
+  "version": "4.26.66",
   "description": "A versatile collection of smart, efficient, and reusable utility functions, classes and types for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",