nhb-toolbox 3.6.3 → 3.6.45

package/dist/date/Chronos.d.ts

@@ -1,3 +1,4 @@
+import type { LocaleCode } from '../number/types';
 import type { FormatOptions, TimeUnit, TimeZone, UTCOffSet } from './types';
 export declare class Chronos {
     #private;
@@ -18,6 +19,8 @@ export declare class Chronos {
      * @returns The primitive value based on the hint.
      */
     [Symbol.toPrimitive](hint: string): string | number;
+    /** * Clones and returns a new Chronos instance with the same date. */
+    clone(): Chronos;
     /** * Enables JSON.stringify and console logging to show readable output. */
     toJSON(): string;
     /** * Enables arithmetic and comparison operations (e.g., +new Chronos()). */
@@ -26,6 +29,14 @@ export declare class Chronos {
     toDate(): Date;
     /** * Returns a string representation of a date. The format of the string depends on the locale. */
     toString(): string;
+    /**
+     *  * Wrapper over native `toLocaleString`
+     * @description Converts a date and time to a string by using the current or specified locale.
+     *
+     * @param locales A locale string, array of locale strings, Intl.Locale object, or array of Intl.Locale objects that contain one or more language or locale tags. If you include more than one locale string, list them in descending order of priority so that the first entry is the preferred locale. If you omit this parameter, the default locale of the JavaScript runtime is used.
+     * @param options An object that contains one or more properties that specify comparison options.
+     */
+    toLocaleString(locale?: LocaleCode | Intl.Locale | (LocaleCode | Intl.Locale)[], options?: Intl.DateTimeFormatOptions): string;
     /** * Returns a date as a string value in ISO format. */
     toISOString(): string;
     /** * Returns the time value in milliseconds since midnight, January 1, 1970 UTC. */
@@ -139,19 +150,19 @@ export declare class Chronos {
      * @param time An optional time value to compare with (`string`, `number`, `Date`, or `Chronos` instance). Defaults to `now`.
      * @returns The difference as a human-readable string, e.g., `2 years 1 month 9 days 18 hours 56 minutes ago`.
      */
-    fromNow(level?: Exclude<TimeUnit, 'millisecond'>, withSuffixPrefix?: boolean, time?: string | number | Date | Chronos): string;
+    fromNow(level?: Exclude<TimeUnit, 'millisecond'>, withSuffixPrefix?: boolean, time?: number | string | Date | Chronos): string;
     /**
      * * Returns the number of full years between the input date and now.
      * @param time Optional time to compare with the `Chronos` date/time.
      * @returns The difference in number, negative is `Chronos` time is a past time else positive.
      */
-    getRelativeYear(time?: string | number | Date | Chronos): number;
+    getRelativeYear(time?: number | string | Date | Chronos): number;
     /**
      * * Returns the number of full months between the input date and now.
      * @param time Optional time to compare with the `Chronos` date/time.
      * @returns The difference in number, negative is `Chronos` time is a past time else positive.
      */
-    getRelativeMonth(time?: string | number | Date | Chronos): number;
+    getRelativeMonth(time?: number | string | Date | Chronos): number;
     /**
      * * Determines if the given date is today, tomorrow, yesterday or any relative day.
      * @param date - The date to compare (Date object).
@@ -162,31 +173,31 @@ export declare class Chronos {
      *  - `1` if the date is tomorrow.
      *  - Other positive or negative numbers for other relative days (e.g., `-2` for two days ago, `2` for two days ahead).
      */
-    getRelativeDay(time?: string | number | Date | Chronos): number;
+    getRelativeDay(time?: number | string | Date | Chronos): number;
     /**
      * * Returns the number of full hours between the input date and now.
      * @param time Optional time to compare with the `Chronos` date/time.
      * @returns The difference in number, negative is `Chronos` time is a past time else positive.
      */
-    getRelativeHour(time?: string | number | Date | Chronos): number;
+    getRelativeHour(time?: number | string | Date | Chronos): number;
     /**
      * * Returns the number of full minutes between the input date and now.
      * @param time Optional time to compare with the `Chronos` date/time.
      * @returns The difference in number, negative is `Chronos` time is a past time else positive.
      */
-    getRelativeMinute(time?: string | number | Date | Chronos): number;
+    getRelativeMinute(time?: number | string | Date | Chronos): number;
     /**
      *  * Returns the number of full seconds between the input date and now.
      * @param time Optional time to compare with the `Chronos` date/time.
      * @returns The difference in number, negative is `Chronos` time is a past time else positive.
      */
-    getRelativeSecond(time?: string | number | Date | Chronos): number;
+    getRelativeSecond(time?: number | string | Date | Chronos): number;
     /**
      * * Returns the number of milliseconds between the input date and now.
      * @param time Optional time to compare with the `Chronos` date/time.
      * @returns The difference in number, negative is `Chronos` time is a past time else positive.
      */
-    getRelativeMilliSecond(time?: string | number | Date | Chronos): number;
+    getRelativeMilliSecond(time?: number | string | Date | Chronos): number;
     /**
      * * Compares the stored date with now, returning the difference in the specified unit.
      *
@@ -194,6 +205,64 @@ export declare class Chronos {
      * @param time Optional time to compare with the `Chronos` date/time.
      * @returns The difference in number, negative is `Chronos` time is a past time else positive.
      */
-    compare(unit?: TimeUnit, time?: string | number | Date | Chronos): number;
+    compare(unit?: TimeUnit, time?: number | string | Date | Chronos): number;
+    /**
+     * * 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;
+    /**
+     * * Returns a new Chronos instance at the end of a given unit.
+     * @param unit The unit to adjust (e.g., year, month, day).
+     */
+    endOf(unit: TimeUnit): Chronos;
+    /**
+     * * Returns a new Chronos instance with the specified unit added.
+     * @param amount The amount to add (can be negative).
+     * @param unit The time unit to add.
+     */
+    add(amount: number, unit: TimeUnit): Chronos;
+    /**
+     * * Gets the value of a specific time unit from the date.
+     * @param unit The unit to retrieve.
+     */
+    get(unit: TimeUnit): number;
+    /**
+     * Returns a new Chronos instance with the specified unit set to the given value.
+     * @param unit The unit to modify.
+     * @param value The value to set for the unit.
+     */
+    set(unit: TimeUnit, value: number): Chronos;
+    /**
+     * * Returns the difference between this and another date in the given unit.
+     * @param other The other date to compare.
+     * @param unit The unit in which to return the difference.
+     */
+    diff(other: number | string | Date | Chronos, unit: TimeUnit): number;
+    /**
+     * * Checks if another date is the same as this one in a specific unit.
+     * @param other The other date to compare.
+     * @param unit The unit to compare.
+     */
+    isSame(other: number | string | Date | Chronos, unit: TimeUnit): boolean;
+    /**
+     * * Checks if this date is before another date in a specific unit.
+     * @param other The other date to compare.
+     * @param unit The unit to compare.
+     */
+    isBefore(other: number | string | Date | Chronos, unit: TimeUnit): boolean;
+    /**
+     * * Checks if this date is after another date in a specific unit.
+     * @param other The other date to compare.
+     * @param unit The unit to compare.
+     */
+    isAfter(other: number | string | Date | Chronos, unit: TimeUnit): boolean;
+    /**
+     * * Returns a human-readable relative calendar time like "Today at 3:00 PM"
+     * @param baseDate Optional base date to compare with.
+     */
+    calendar(baseDate?: number | string | Date | Chronos): string;
+    /** * Returns a short human-readable string like "2h ago", "in 5m" */
+    fromNowShort(): string;
 }
 //# sourceMappingURL=Chronos.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Chronos.d.ts","sourceRoot":"","sources":["../../src/date/Chronos.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Chronos.d.ts","sourceRoot":"","sources":["../../src/date/Chronos.ts"],"names":[],"mappings":"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"}

package/dist/date/Chronos.js

@@ -31,6 +31,10 @@ export class Chronos {
             return this.valueOf();
         return this.toString();
     }
+    /** * Clones and returns a new Chronos instance with the same date. */
+    clone() {
+        return new Chronos(this.#date);
+    }
     /** * Enables JSON.stringify and console logging to show readable output. */
     toJSON() {
         return this.toISOString();
@@ -47,6 +51,16 @@ export class Chronos {
     toString() {
         return this.#date.toString();
     }
+    /**
+     *  * Wrapper over native `toLocaleString`
+     * @description Converts a date and time to a string by using the current or specified locale.
+     *
+     * @param locales A locale string, array of locale strings, Intl.Locale object, or array of Intl.Locale objects that contain one or more language or locale tags. If you include more than one locale string, list them in descending order of priority so that the first entry is the preferred locale. If you omit this parameter, the default locale of the JavaScript runtime is used.
+     * @param options An object that contains one or more properties that specify comparison options.
+     */
+    toLocaleString(locale, options) {
+        return this.#date.toLocaleString(locale, options);
+    }
     /** * Returns a date as a string value in ISO format. */
     toISOString() {
         return this.#date.toISOString();
@@ -500,4 +514,239 @@ export class Chronos {
                 throw new Error(`Unsupported time unit: ${unit}`);
         }
     }
+    /**
+     * * 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) {
+        const d = new Date(this.#date);
+        switch (unit) {
+            case 'year':
+                d.setMonth(0, 1);
+                d.setHours(0, 0, 0, 0);
+                break;
+            case 'month':
+                d.setDate(1);
+                d.setHours(0, 0, 0, 0);
+                break;
+            case 'day':
+                d.setHours(0, 0, 0, 0);
+                break;
+            case 'hour':
+                d.setMinutes(0, 0, 0);
+                break;
+            case 'minute':
+                d.setSeconds(0, 0);
+                break;
+            case 'second':
+                d.setMilliseconds(0);
+                break;
+            case 'millisecond':
+                break;
+        }
+        return new Chronos(d);
+    }
+    /**
+     * * Returns a new Chronos instance at the end of a given unit.
+     * @param unit The unit to adjust (e.g., year, month, day).
+     */
+    endOf(unit) {
+        return this.startOf(unit).add(1, unit).add(-1, 'millisecond');
+    }
+    /**
+     * * Returns a new Chronos instance with the specified unit added.
+     * @param amount The amount to add (can be negative).
+     * @param unit The time unit to add.
+     */
+    add(amount, unit) {
+        const d = new Date(this.#date);
+        switch (unit) {
+            case 'millisecond':
+                d.setMilliseconds(d.getMilliseconds() + amount);
+                break;
+            case 'second':
+                d.setSeconds(d.getSeconds() + amount);
+                break;
+            case 'minute':
+                d.setMinutes(d.getMinutes() + amount);
+                break;
+            case 'hour':
+                d.setHours(d.getHours() + amount);
+                break;
+            case 'day':
+                d.setDate(d.getDate() + amount);
+                break;
+            case 'month':
+                d.setMonth(d.getMonth() + amount);
+                break;
+            case 'year':
+                d.setFullYear(d.getFullYear() + amount);
+                break;
+        }
+        return new Chronos(d);
+    }
+    /**
+     * * Gets the value of a specific time unit from the date.
+     * @param unit The unit to retrieve.
+     */
+    get(unit) {
+        switch (unit) {
+            case 'year':
+                return this.#date.getFullYear();
+            case 'month':
+                return this.#date.getMonth();
+            case 'day':
+                return this.#date.getDate();
+            case 'hour':
+                return this.#date.getHours();
+            case 'minute':
+                return this.#date.getMinutes();
+            case 'second':
+                return this.#date.getSeconds();
+            case 'millisecond':
+                return this.#date.getMilliseconds();
+        }
+    }
+    /**
+     * Returns a new Chronos instance with the specified unit set to the given value.
+     * @param unit The unit to modify.
+     * @param value The value to set for the unit.
+     */
+    set(unit, value) {
+        const d = new Date(this.#date);
+        switch (unit) {
+            case 'year':
+                d.setFullYear(value);
+                break;
+            case 'month':
+                d.setMonth(value);
+                break;
+            case 'day':
+                d.setDate(value);
+                break;
+            case 'hour':
+                d.setHours(value);
+                break;
+            case 'minute':
+                d.setMinutes(value);
+                break;
+            case 'second':
+                d.setSeconds(value);
+                break;
+            case 'millisecond':
+                d.setMilliseconds(value);
+                break;
+        }
+        return new Chronos(d);
+    }
+    /**
+     * * Returns the difference between this and another date in the given unit.
+     * @param other The other date to compare.
+     * @param unit The unit in which to return the difference.
+     */
+    diff(other, unit) {
+        const time = new Chronos(other);
+        const msDiff = this.#date.getTime() - time.toDate().getTime();
+        switch (unit) {
+            case 'millisecond':
+                return msDiff;
+            case 'second':
+                return msDiff / 1e3;
+            case 'minute':
+                return msDiff / 6e4;
+            case 'hour':
+                return msDiff / 3.6e6;
+            case 'day':
+                return msDiff / 8.64e7;
+            case 'month':
+                return ((this.get('year') - time.get('year')) * 12 +
+                    (this.get('month') - time.get('month')));
+            case 'year':
+                return this.get('year') - time.get('year');
+        }
+    }
+    /**
+     * * Checks if another date is the same as this one in a specific unit.
+     * @param other The other date to compare.
+     * @param unit The unit to compare.
+     */
+    isSame(other, unit) {
+        const time = new Chronos(other);
+        return (this.startOf(unit).toDate().getTime() ===
+            time.startOf(unit).toDate().getTime());
+    }
+    /**
+     * * Checks if this date is before another date in a specific unit.
+     * @param other The other date to compare.
+     * @param unit The unit to compare.
+     */
+    isBefore(other, unit) {
+        const time = new Chronos(other);
+        return (this.startOf(unit).toDate().getTime() <
+            time.startOf(unit).toDate().getTime());
+    }
+    /**
+     * * Checks if this date is after another date in a specific unit.
+     * @param other The other date to compare.
+     * @param unit The unit to compare.
+     */
+    isAfter(other, unit) {
+        const time = new Chronos(other);
+        return (this.startOf(unit).toDate().getTime() >
+            time.startOf(unit).toDate().getTime());
+    }
+    /**
+     * * Returns a human-readable relative calendar time like "Today at 3:00 PM"
+     * @param baseDate Optional base date to compare with.
+     */
+    calendar(baseDate) {
+        const base = baseDate ? new Chronos(baseDate) : new Chronos();
+        const input = this.startOf('day');
+        const comparison = base.startOf('day');
+        const diff = input.diff(comparison, 'day');
+        const timeStr = this.toDate().toLocaleString(undefined, {
+            hour: 'numeric',
+            minute: '2-digit',
+        });
+        if (diff === 0)
+            return `Today at ${timeStr}`;
+        if (diff === 1)
+            return `Tomorrow at ${timeStr}`;
+        if (diff === -1)
+            return `Yesterday at ${timeStr}`;
+        return this.toDate().toLocaleString(undefined, {
+            month: 'long',
+            day: '2-digit',
+            year: 'numeric',
+            weekday: 'long',
+            hour: 'numeric',
+            minute: '2-digit',
+        });
+    }
+    /** * Returns a short human-readable string like "2h ago", "in 5m" */
+    fromNowShort() {
+        const now = new Chronos();
+        const diffInSeconds = this.diff(now, 'second');
+        const abs = Math.abs(diffInSeconds);
+        const suffix = diffInSeconds >= 0 ? 'in ' : '';
+        const postfix = diffInSeconds < 0 ? ' ago' : '';
+        if (abs < 60) {
+            return `${suffix}${Math.floor(abs)}s${postfix}`;
+        }
+        else if (abs < 3600) {
+            return `${suffix}${Math.floor(abs / 60)}m${postfix}`;
+        }
+        else if (abs < 86400) {
+            return `${suffix}${Math.floor(abs / 3600)}h${postfix}`;
+        }
+        else if (abs < 2592000) {
+            return `${suffix}${Math.floor(abs / 86400)}d${postfix}`;
+        }
+        else if (abs < 31536000) {
+            return `${suffix}${Math.floor(abs / 2592000)}mo${postfix}`;
+        }
+        else {
+            return `${suffix}${Math.floor(abs / 31536000)}y${postfix}`;
+        }
+    }
 }

package/dist/date/types.d.ts

@@ -1,3 +1,4 @@
+import type { Chronos } from './Chronos';
 import type { DATE_FORMATS, DAY_FORMATS, HOUR_FORMATS, MILLISECOND_FORMATS, MINUTE_FORMATS, MONTH_FORMATS, SECOND_FORMATS, TIME_FORMATS, TIME_ZONES, YEAR_FORMATS } from './constants';
 /** - Minute in numeric string from `00` to `23` */
 export type Hours = '00' | '01' | '02' | '03' | '04' | '05' | '06' | '07' | '08' | '09' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18' | '19' | '20' | '21' | '22' | '23';
@@ -47,6 +48,7 @@ export type Second = (typeof SECOND_FORMATS)[number];
 export type Millisecond = (typeof MILLISECOND_FORMATS)[number];
 export type TimeFormats = (typeof TIME_FORMATS)[number];
 export type ChronosFormat = Year | Month | Day | Date | Hour | Minute | Second | Millisecond | TimeFormats;
+export type ChronosDate = number | string | Date | Chronos;
 export type TimeZone = keyof typeof TIME_ZONES;
 export type PositiveUTCHour = '+00' | '+01' | '+02' | '+03' | '+04' | '+05' | '+06' | '+07' | '+08' | '+09' | '+10' | '+11' | '+12' | '+13' | '+14';
 export type NegativeUTCHour = '-00' | '-01' | '-02' | '-03' | '-04' | '-05' | '-06' | '-07' | '-08' | '-09' | '-10' | '-11' | '-12' | '-13' | '-14';

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/date/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/date/types.ts"],"names":[],"mappings":"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"}

package/package.json

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