nhb-toolbox 3.4.77 → 3.5.1

package/dist/date/Chronos.d.ts

@@ -1,10 +1,27 @@
+import type { TimeZone, UTCOffSet } from './types';
 export declare class Chronos {
     #private;
     /**
-     * * Creates a new immutable Chronos instance.
-     * @param value - A date value (`timestamp`, `string`, `Date`, `Chronos`).
+     * * Creates a new immutable `Chronos` instance.
+     *
+     * @param value - A date value (`number`, `string`, `Date`, or `Chronos` object).
+     * - If a string is provided, it should be in a format that can be parsed by the Date constructor.
+     * - If a number is provided, it should be a timestamp (milliseconds since the Unix epoch).
+     * - If a Date object is provided, it will be used as is.
+     * - If a Chronos object is provided, it will be converted to a Date object.
      */
     constructor(value?: number | string | Date | Chronos);
+    get [Symbol.toStringTag](): string;
+    /**
+     * * Enables primitive coercion like `console.log`, `${chronos}`, etc.
+     * @param hint - The type hint provided by the JS engine.
+     * @returns The primitive value based on the hint.
+     */
+    [Symbol.toPrimitive](hint: string): string | number;
+    /** * Enables JSON.stringify and console logging to show readable output. */
+    toJSON(): string;
+    /** * Enables arithmetic and comparison operations (e.g., +new Chronos()). */
+    valueOf(): number;
     /** * Gets the native `Date` instance (read-only). */
     toDate(): Date;
     /** * Returns a string representation of a date. The format of the string depends on the locale. */
@@ -38,11 +55,19 @@ export declare class Chronos {
      */
     static now(): number;
     /**
-     * * Formats the date into a custom string format.
+     * * Formats the date into a custom string format (local time).
+     *
      * @param format - The desired format (Default format is `DD-MM-YYYY` = `30-06-1995`).
-     * @returns Formatted date string in desired format.
+     * @returns Formatted date string in desired format (local time).
      */
     format(format?: string): string;
+    /**
+     * * Formats the date into a custom string format (UTC time).
+     *
+     * @param format - The desired format (Default format is `DD-MM-YYYY` = `30-06-1995`).
+     * @returns Formatted date string in desired format (UTC time).
+     */
+    formatUTC(format?: string): string;
     /**
      * * Adds days and returns a new immutable instance.
      * @param days - Number of days to add.
@@ -72,5 +97,12 @@ export declare class Chronos {
      * @returns `true` if the year is a leap year, `false` otherwise.
      */
     isLeapYear(): boolean;
+    /**
+     * * Create a new instance of `Chronos` in the specified timezone.
+     *
+     * @param zone - Standard timezone abbreviation (e.g., 'IST', 'UTC', 'EST') or UTC Offset in in `UTC-01:30` format.
+     * @returns A new instance of `Chronos` with time in the given timezone. Invalid input sets time-zone to `UTC`.
+     */
+    timeZone(zone: TimeZone | UTCOffSet): Chronos;
 }
 //# 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":"AAGA,qBAAa,OAAO;;IAGnB;;;OAGG;gBACS,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO;IAcpD,qDAAqD;IACrD,MAAM,IAAI,IAAI;IAId,mGAAmG;IACnG,QAAQ,IAAI,MAAM;IAIlB,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,MAAM,SAA4B,GAAG,MAAM;IAKjD;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,SAA4B,GAAG,MAAM;IAKxD;;;;OAIG;IACH,MAAM,CAAC,GAAG,IAAI,MAAM;IAIpB;;;;OAIG;IACH,MAAM,CAAC,MAAM,GAAE,MAAqB,GAAG,MAAM;IA2E7C;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAM9B;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInC;;;;;;;;OAQG;IACH,cAAc,IAAI,MAAM;IAexB;;;;;OAKG;IACH,UAAU,IAAI,OAAO;CAKrB"}
+{"version":3,"file":"Chronos.d.ts","sourceRoot":"","sources":["../../src/date/Chronos.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGlE,qBAAa,OAAO;;IAInB;;;;;;;;OAQG;gBACS,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO;IAepD,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,4EAA4E;IAC5E,MAAM,IAAI,MAAM;IAIhB,6EAA6E;IAC7E,OAAO,IAAI,MAAM;IAIjB,qDAAqD;IACrD,MAAM,IAAI,IAAI;IAId,mGAAmG;IACnG,QAAQ,IAAI,MAAM;IAIlB,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,MAAM,SAA4B,GAAG,MAAM;IAKjD;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,SAA4B,GAAG,MAAM;IAKxD;;;;OAIG;IACH,MAAM,CAAC,GAAG,IAAI,MAAM;IA4FpB;;;;;OAKG;IACH,MAAM,CAAC,MAAM,GAAE,MAAqB,GAAG,MAAM;IAI7C;;;;;OAKG;IACH,SAAS,CAAC,MAAM,GAAE,MAAqB,GAAG,MAAM;IAIhD;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAM9B;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInC;;;;;;;;OAQG;IACH,cAAc,IAAI,MAAM;IAexB;;;;;OAKG;IACH,UAAU,IAAI,OAAO;IAMrB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO;CAgB7C"}

package/dist/date/Chronos.js

@@ -1,9 +1,17 @@
-import { DAYS, MONTHS, sortedFormats } from './constants';
+import { DAYS, MONTHS, sortedFormats, TIME_ZONES } from './constants';
+import { isValidUTCOffSet } from './guards';
+import { extractMinutesFromUTC } from './utils';
 export class Chronos {
     #date;
+    // readonly preview: string;
     /**
-     * * Creates a new immutable Chronos instance.
-     * @param value - A date value (`timestamp`, `string`, `Date`, `Chronos`).
+     * * Creates a new immutable `Chronos` instance.
+     *
+     * @param value - A date value (`number`, `string`, `Date`, or `Chronos` object).
+     * - If a string is provided, it should be in a format that can be parsed by the Date constructor.
+     * - If a number is provided, it should be a timestamp (milliseconds since the Unix epoch).
+     * - If a Date object is provided, it will be used as is.
+     * - If a Chronos object is provided, it will be converted to a Date object.
      */
     constructor(value) {
         const date = value instanceof Chronos ?
@@ -11,9 +19,31 @@ export class Chronos {
             : new Date(value ?? Date.now());
         // Check if the date is invalid
         if (isNaN(date.getTime())) {
-            throw new Error('Invalid date provided!');
+            throw new Error('Provided date is invalid!');
         }
         this.#date = date;
+        // this.preview = this.toISOString();
+    }
+    get [Symbol.toStringTag]() {
+        return this.toISOString();
+    }
+    /**
+     * * Enables primitive coercion like `console.log`, `${chronos}`, etc.
+     * @param hint - The type hint provided by the JS engine.
+     * @returns The primitive value based on the hint.
+     */
+    [Symbol.toPrimitive](hint) {
+        if (hint === 'number')
+            return this.valueOf();
+        return this.toString();
+    }
+    /** * Enables JSON.stringify and console logging to show readable output. */
+    toJSON() {
+        return this.toISOString();
+    }
+    /** * Enables arithmetic and comparison operations (e.g., +new Chronos()). */
+    valueOf() {
+        return this.getTimeStamp();
     }
     /** * Gets the native `Date` instance (read-only). */
     toDate() {
@@ -68,19 +98,23 @@ export class Chronos {
         return Date.now();
     }
     /**
-     * * Formats the date into a custom string format.
-     * @param format - The desired format (Default format is `DD-MM-YYYY` = `30-06-1995`).
-     * @returns Formatted date string in desired format.
+     * @private Formats the current `Chronos` date using the specified template.
+     *
+     * @param format - The desired date format.
+     * @param useUTC - Whether to use UTC or local time.
+     * @returns Formatted date string.
      */
-    format(format = 'DD-MM-YYYY') {
-        const year = this.#date.getFullYear();
-        const month = this.#date.getMonth();
-        const day = this.#date.getDay();
-        const date = this.#date.getDate();
-        const hours = this.#date.getHours();
-        const minutes = this.#date.getMinutes();
-        const seconds = this.#date.getSeconds();
-        const milliseconds = this.#date.getMilliseconds();
+    #format(format, useUTC = false) {
+        const year = useUTC ? this.#date.getUTCFullYear() : this.#date.getFullYear();
+        const month = useUTC ? this.#date.getUTCMonth() : this.#date.getMonth();
+        const day = useUTC ? this.#date.getUTCDay() : this.#date.getDay();
+        const date = useUTC ? this.#date.getUTCDate() : this.#date.getDate();
+        const hours = useUTC ? this.#date.getUTCHours() : this.#date.getHours();
+        const minutes = useUTC ? this.#date.getUTCMinutes() : this.#date.getMinutes();
+        const seconds = useUTC ? this.#date.getUTCSeconds() : this.#date.getSeconds();
+        const milliseconds = useUTC ?
+            this.#date.getUTCMilliseconds()
+            : this.#date.getMilliseconds();
         const dateComponents = {
             YYYY: String(year),
             YY: String(year).slice(-2),
@@ -137,6 +171,24 @@ export class Chronos {
         }
         return result;
     }
+    /**
+     * * Formats the date into a custom string format (local time).
+     *
+     * @param format - The desired format (Default format is `DD-MM-YYYY` = `30-06-1995`).
+     * @returns Formatted date string in desired format (local time).
+     */
+    format(format = 'DD-MM-YYYY') {
+        return this.#format(format, false);
+    }
+    /**
+     * * Formats the date into a custom string format (UTC time).
+     *
+     * @param format - The desired format (Default format is `DD-MM-YYYY` = `30-06-1995`).
+     * @returns Formatted date string in desired format (UTC time).
+     */
+    formatUTC(format = 'DD-MM-YYYY') {
+        return this.#format(format, true);
+    }
     /**
      * * Adds days and returns a new immutable instance.
      * @param days - Number of days to add.
@@ -185,4 +237,22 @@ export class Chronos {
         const year = this.#date.getFullYear();
         return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
     }
+    /**
+     * * Create a new instance of `Chronos` in the specified timezone.
+     *
+     * @param zone - Standard timezone abbreviation (e.g., 'IST', 'UTC', 'EST') or UTC Offset in in `UTC-01:30` format.
+     * @returns A new instance of `Chronos` with time in the given timezone. Invalid input sets time-zone to `UTC`.
+     */
+    timeZone(zone) {
+        let offset;
+        if (isValidUTCOffSet(zone)) {
+            offset = extractMinutesFromUTC(zone);
+        }
+        else {
+            offset = TIME_ZONES[zone] ?? 0;
+        }
+        const utc = this.#date.getTime() + this.#date.getTimezoneOffset() * 60 * 1000;
+        const adjusted = new Date(utc + offset * 60 * 1000);
+        return new Chronos(adjusted);
+    }
 }

package/dist/date/constants.d.ts

@@ -10,4 +10,133 @@ export declare const SECOND_FORMATS: readonly ["ss", "s"];
 export declare const MILLISECOND_FORMATS: readonly ["ms", "mss"];
 export declare const TIME_FORMATS: readonly ["a", "A"];
 export declare const sortedFormats: ("a" | "M" | "D" | "A" | "YYYY" | "YY" | "yyyy" | "yy" | "MM" | "MMM" | "MMMM" | "mmm" | "mmmm" | "DD" | "d" | "dd" | "ddd" | "dddd" | "H" | "HH" | "hh" | "h" | "mm" | "m" | "ss" | "s" | "ms" | "mss")[];
+export declare const TIME_ZONES: {
+    readonly UTC: 0;
+    readonly GMT: 0;
+    readonly EST: number;
+    readonly EDT: number;
+    readonly CST: number;
+    readonly CDT: number;
+    readonly MST: number;
+    readonly MDT: number;
+    readonly PST: number;
+    readonly PDT: number;
+    readonly AKST: number;
+    readonly AKDT: number;
+    readonly HST: number;
+    readonly HDT: number;
+    readonly ART: number;
+    readonly BRST: number;
+    readonly BRT: number;
+    readonly CLT: number;
+    readonly CLST: number;
+    readonly GFT: number;
+    readonly UYT: number;
+    readonly CET: number;
+    readonly CEST: number;
+    readonly EET: number;
+    readonly EEST: number;
+    readonly WET: 0;
+    readonly WEST: number;
+    readonly MET: number;
+    readonly MEST: number;
+    readonly WAT: number;
+    readonly CAT: number;
+    readonly EAT: number;
+    readonly IST: number;
+    readonly PKT: number;
+    readonly BST: number;
+    readonly NPT: number;
+    readonly MYT: number;
+    readonly THA: number;
+    readonly ICT: number;
+    readonly WIB: number;
+    readonly WITA: number;
+    readonly WIT: number;
+    readonly SGT: number;
+    readonly CST_CHINA: number;
+    readonly JST: number;
+    readonly KST: number;
+    readonly IRKT: number;
+    readonly IRKT_DST: number;
+    readonly AEST: number;
+    readonly AEDT: number;
+    readonly ACST: number;
+    readonly ACDT: number;
+    readonly AWST: number;
+    readonly NZST: number;
+    readonly NZDT: number;
+    readonly CHAST: number;
+    readonly CHADT: number;
+    readonly MSK: number;
+    readonly SAMT: number;
+    readonly YEKST: number;
+    readonly OMST: number;
+    readonly KRAT: number;
+    readonly IRKT_RU: number;
+    readonly YAKT: number;
+    readonly VLAT: number;
+    readonly MAGT: number;
+    readonly PETT: number;
+    readonly IRST: number;
+    readonly IRDT: number;
+    readonly GST: number;
+    readonly ROTT: number;
+    readonly MAWT: number;
+    readonly NZAT: number;
+    readonly AST: number;
+    readonly ADT: number;
+    readonly NST: number;
+    readonly NDT: number;
+    readonly SST: number;
+    readonly CHST: number;
+    readonly MART: number;
+    readonly CHAST_NZ: number;
+    readonly LHST: number;
+    readonly LHDT: number;
+    readonly ACWST: number;
+    readonly NPT_NEPAL: number;
+    readonly UTC_MINUS_12: number;
+    readonly UTC_MINUS_11: number;
+    readonly UTC_MINUS_10: number;
+    readonly UTC_MINUS_9: number;
+    readonly UTC_MINUS_8: number;
+    readonly UTC_MINUS_7: number;
+    readonly UTC_MINUS_6: number;
+    readonly UTC_MINUS_5: number;
+    readonly UTC_MINUS_4: number;
+    readonly UTC_MINUS_3: number;
+    readonly UTC_MINUS_2: number;
+    readonly UTC_MINUS_1: number;
+    readonly UTC_PLUS_0: 0;
+    readonly UTC_PLUS_1: number;
+    readonly UTC_PLUS_2: number;
+    readonly UTC_PLUS_3: number;
+    readonly UTC_PLUS_3_30: number;
+    readonly UTC_PLUS_4: number;
+    readonly UTC_PLUS_4_30: number;
+    readonly UTC_PLUS_5: number;
+    readonly UTC_PLUS_5_30: number;
+    readonly UTC_PLUS_5_45: number;
+    readonly UTC_PLUS_6: number;
+    readonly UTC_PLUS_6_30: number;
+    readonly UTC_PLUS_7: number;
+    readonly UTC_PLUS_8: number;
+    readonly UTC_PLUS_8_45: number;
+    readonly UTC_PLUS_9: number;
+    readonly UTC_PLUS_9_30: number;
+    readonly UTC_PLUS_10: number;
+    readonly UTC_PLUS_10_30: number;
+    readonly UTC_PLUS_11: number;
+    readonly UTC_PLUS_12: number;
+    readonly UTC_PLUS_12_45: number;
+    readonly UTC_PLUS_13: number;
+    readonly UTC_PLUS_14: number;
+    readonly BST_UK: 60;
+    readonly BST_BD: 360;
+    readonly IST_IN: 330;
+    readonly IST_IL: 120;
+    readonly CST_US: -360;
+    readonly CST_CN: 480;
+};
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/date/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,yFAQP,CAAC;AAEX,eAAO,MAAM,MAAM,qIAaT,CAAC;AAEX,eAAO,MAAM,YAAY,uCAAwC,CAAC;AAClE,eAAO,MAAM,aAAa,oDAAqD,CAAC;AAChF,eAAO,MAAM,YAAY,sBAAuB,CAAC;AACjD,eAAO,MAAM,WAAW,qCAAsC,CAAC;AAC/D,eAAO,MAAM,YAAY,iCAAkC,CAAC;AAC5D,eAAO,MAAM,cAAc,sBAAuB,CAAC;AACnD,eAAO,MAAM,cAAc,sBAAuB,CAAC;AACnD,eAAO,MAAM,mBAAmB,wBAAyB,CAAC;AAC1D,eAAO,MAAM,YAAY,qBAAsB,CAAC;AAEhD,eAAO,MAAM,aAAa,4MAUW,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/date/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,yFAQP,CAAC;AAEX,eAAO,MAAM,MAAM,qIAaT,CAAC;AAEX,eAAO,MAAM,YAAY,uCAAwC,CAAC;AAClE,eAAO,MAAM,aAAa,oDAAqD,CAAC;AAChF,eAAO,MAAM,YAAY,sBAAuB,CAAC;AACjD,eAAO,MAAM,WAAW,qCAAsC,CAAC;AAC/D,eAAO,MAAM,YAAY,iCAAkC,CAAC;AAC5D,eAAO,MAAM,cAAc,sBAAuB,CAAC;AACnD,eAAO,MAAM,cAAc,sBAAuB,CAAC;AACnD,eAAO,MAAM,mBAAmB,wBAAyB,CAAC;AAC1D,eAAO,MAAM,YAAY,qBAAsB,CAAC;AAEhD,eAAO,MAAM,aAAa,4MAUW,CAAC;AAEtC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyJb,CAAC"}

package/dist/date/constants.js

@@ -41,3 +41,144 @@ export const sortedFormats = [
     ...MILLISECOND_FORMATS,
     ...TIME_FORMATS,
 ].sort((a, b) => b.length - a.length);
+export const TIME_ZONES = {
+    // Universal
+    UTC: 0,
+    GMT: 0,
+    // North America
+    EST: -5 * 60,
+    EDT: -4 * 60,
+    CST: -6 * 60,
+    CDT: -5 * 60,
+    MST: -7 * 60,
+    MDT: -6 * 60,
+    PST: -8 * 60,
+    PDT: -7 * 60,
+    AKST: -9 * 60,
+    AKDT: -8 * 60,
+    HST: -10 * 60,
+    HDT: -9 * 60,
+    // South America
+    ART: -3 * 60,
+    BRST: -2 * 60,
+    BRT: -3 * 60,
+    CLT: -4 * 60,
+    CLST: -3 * 60,
+    GFT: -3 * 60,
+    UYT: -3 * 60,
+    // Europe
+    CET: 1 * 60,
+    CEST: 2 * 60,
+    EET: 2 * 60,
+    EEST: 3 * 60,
+    WET: 0,
+    WEST: 1 * 60,
+    MET: 1 * 60,
+    MEST: 2 * 60,
+    // Africa
+    WAT: 1 * 60,
+    CAT: 2 * 60,
+    EAT: 3 * 60,
+    // Asia
+    IST: 5.5 * 60, // India
+    PKT: 5 * 60,
+    BST: 6 * 60, // Bangladesh
+    NPT: 5.75 * 60,
+    MYT: 8 * 60,
+    THA: 7 * 60,
+    ICT: 7 * 60,
+    WIB: 7 * 60,
+    WITA: 8 * 60,
+    WIT: 9 * 60,
+    SGT: 8 * 60,
+    CST_CHINA: 8 * 60,
+    JST: 9 * 60,
+    KST: 9 * 60,
+    IRKT: 8 * 60,
+    IRKT_DST: 9 * 60,
+    // Australia & Oceania
+    AEST: 10 * 60,
+    AEDT: 11 * 60,
+    ACST: 9.5 * 60,
+    ACDT: 10.5 * 60,
+    AWST: 8 * 60,
+    NZST: 12 * 60,
+    NZDT: 13 * 60,
+    CHAST: 12.75 * 60,
+    CHADT: 13.75 * 60,
+    // Russia
+    MSK: 3 * 60,
+    SAMT: 4 * 60,
+    YEKST: 5 * 60,
+    OMST: 6 * 60,
+    KRAT: 7 * 60,
+    IRKT_RU: 8 * 60,
+    YAKT: 9 * 60,
+    VLAT: 10 * 60,
+    MAGT: 11 * 60,
+    PETT: 12 * 60,
+    // Middle East
+    IRST: 3.5 * 60,
+    IRDT: 4.5 * 60,
+    GST: 4 * 60,
+    // Antarctica (used in research stations)
+    ROTT: -3 * 60,
+    MAWT: 5 * 60,
+    NZAT: 13 * 60,
+    // Misc
+    AST: -4 * 60,
+    ADT: -3 * 60,
+    NST: -3.5 * 60,
+    NDT: -2.5 * 60,
+    SST: -11 * 60,
+    CHST: 10 * 60,
+    // Rare fractional or unique time zones
+    MART: -9.5 * 60, // Marquesas Islands Time (UTC−09:30)
+    CHAST_NZ: 12.75 * 60, // Chatham Standard Time (NZ, UTC+12:45)
+    LHST: 10.5 * 60, // Lord Howe Standard Time (UTC+10:30)
+    LHDT: 11 * 60, // Lord Howe Daylight Time (DST +30min)
+    ACWST: 8.75 * 60, // Australian Central Western Standard Time (Eucla, UTC+08:45)
+    NPT_NEPAL: 5.75 * 60, // Nepal Time (UTC+05:45)
+    UTC_MINUS_12: -12 * 60,
+    UTC_MINUS_11: -11 * 60,
+    UTC_MINUS_10: -10 * 60,
+    UTC_MINUS_9: -9 * 60,
+    UTC_MINUS_8: -8 * 60,
+    UTC_MINUS_7: -7 * 60,
+    UTC_MINUS_6: -6 * 60,
+    UTC_MINUS_5: -5 * 60,
+    UTC_MINUS_4: -4 * 60,
+    UTC_MINUS_3: -3 * 60,
+    UTC_MINUS_2: -2 * 60,
+    UTC_MINUS_1: -1 * 60,
+    UTC_PLUS_0: 0,
+    UTC_PLUS_1: 1 * 60,
+    UTC_PLUS_2: 2 * 60,
+    UTC_PLUS_3: 3 * 60,
+    UTC_PLUS_3_30: 3.5 * 60,
+    UTC_PLUS_4: 4 * 60,
+    UTC_PLUS_4_30: 4.5 * 60,
+    UTC_PLUS_5: 5 * 60,
+    UTC_PLUS_5_30: 5.5 * 60,
+    UTC_PLUS_5_45: 5.75 * 60,
+    UTC_PLUS_6: 6 * 60,
+    UTC_PLUS_6_30: 6.5 * 60,
+    UTC_PLUS_7: 7 * 60,
+    UTC_PLUS_8: 8 * 60,
+    UTC_PLUS_8_45: 8.75 * 60,
+    UTC_PLUS_9: 9 * 60,
+    UTC_PLUS_9_30: 9.5 * 60,
+    UTC_PLUS_10: 10 * 60,
+    UTC_PLUS_10_30: 10.5 * 60,
+    UTC_PLUS_11: 11 * 60,
+    UTC_PLUS_12: 12 * 60,
+    UTC_PLUS_12_45: 12.75 * 60,
+    UTC_PLUS_13: 13 * 60,
+    UTC_PLUS_14: 14 * 60,
+    BST_UK: 60, // British Summer Time (UK DST)
+    BST_BD: 360, // Bangladesh Standard Time
+    IST_IN: 330, // India
+    IST_IL: 120, // Israel
+    CST_US: -360,
+    CST_CN: 480,
+};

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

@@ -1 +1 @@
-{"version":3,"file":"greet.d.ts","sourceRoot":"","sources":["../../src/date/greet.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM,CAiD7D"}
+{"version":3,"file":"greet.d.ts","sourceRoot":"","sources":["../../src/date/greet.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAO/C;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM,CAiD7D"}

package/dist/date/greet.js

@@ -7,7 +7,7 @@ import { extractHourMinute, getCurrentDateTime, getTotalMinutes, } from './utils
  * @returns The appropriate greeting message.
  */
 export function getGreeting(configs) {
-    const { morningEnds = '11:59', noonEnds = '12:59', afternoonEnds = '17:59', eveningEnds = '23:59', midnightEnds = '02:59', currentTime, appendMsg = '', prependMsg = '', morningMessage = 'Good Morning!', noonMessage = 'Good Noon!', afternoonMessage = 'Good Afternoon!', eveningMessage = 'Good Evening!', midnightMessage = 'Hello, Night Owl!', defaultMessage = 'Greetings!', } = configs || {};
+    const { morningEnds = '11:59', noonEnds = '12:59', afternoonEnds = '17:59', eveningEnds = '23:59', midnightEnds = '02:59', currentTime, appendToMsg = '', prependToMsg = '', morningMessage = 'Good Morning!', noonMessage = 'Good Noon!', afternoonMessage = 'Good Afternoon!', eveningMessage = 'Good Evening!', midnightMessage = 'Hello, Night Owl!', defaultMessage = 'Greetings!', } = configs || {};
     let hour;
     let minute;
     if (currentTime && isValidTime(currentTime)) {
@@ -24,21 +24,21 @@ export function getGreeting(configs) {
     const eveningEndMinutes = getTotalMinutes(eveningEnds);
     const midnightEndMinutes = getTotalMinutes(midnightEnds);
     if (currentTotalMinutes <= midnightEndMinutes) {
-        return prependMsg.concat(midnightMessage.concat(appendMsg));
+        return prependToMsg.concat(midnightMessage.concat(appendToMsg));
     }
     else if (currentTotalMinutes <= morningEndMinutes) {
-        return prependMsg.concat(morningMessage.concat(appendMsg));
+        return prependToMsg.concat(morningMessage.concat(appendToMsg));
     }
     else if (currentTotalMinutes <= noonEndMinutes) {
-        return prependMsg.concat(noonMessage.concat(appendMsg));
+        return prependToMsg.concat(noonMessage.concat(appendToMsg));
     }
     else if (currentTotalMinutes <= afternoonEndMinutes) {
-        return prependMsg.concat(afternoonMessage.concat(appendMsg));
+        return prependToMsg.concat(afternoonMessage.concat(appendToMsg));
     }
     else if (currentTotalMinutes <= eveningEndMinutes) {
-        return prependMsg.concat(eveningMessage.concat(appendMsg));
+        return prependToMsg.concat(eveningMessage.concat(appendToMsg));
     }
     else {
-        return prependMsg.concat(defaultMessage.concat(appendMsg));
+        return prependToMsg.concat(defaultMessage.concat(appendToMsg));
     }
 }

package/dist/date/guards.d.ts

@@ -1,4 +1,4 @@
-import type { Time } from './types';
+import type { Time, UTCOffSet } from './types';
 /**
  * * Checks if the provided value is a valid time string in "HH:MM" format.
  *
@@ -6,4 +6,11 @@ import type { Time } from './types';
  * @returns `true` if the value is a valid time string, `false` otherwise.
  */
 export declare function isValidTime(value: unknown): value is Time;
+/**
+ * * Checks if the provided value is a valid UTCOffSet (e.g. `UTC-01:30`).
+ *
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid utc offset, `false` otherwise.
+ */
+export declare function isValidUTCOffSet(value: unknown): value is UTCOffSet;
 //# sourceMappingURL=guards.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/date/guards.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAWzD"}
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/date/guards.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAWzD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAInE"}

package/dist/date/guards.js

@@ -16,3 +16,14 @@ export function isValidTime(value) {
     const minute = Number(minuteStr);
     return hour >= 0 && hour <= 23 && minute >= 0 && minute <= 59;
 }
+/**
+ * * Checks if the provided value is a valid UTCOffSet (e.g. `UTC-01:30`).
+ *
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid utc offset, `false` otherwise.
+ */
+export function isValidUTCOffSet(value) {
+    if (!isString(value))
+        return false;
+    return /^UTC[+-]?\d{1,2}:\d{2}$/.test(value);
+}

package/dist/date/types.d.ts

@@ -1,4 +1,4 @@
-import type { DATE_FORMATS, DAY_FORMATS, HOUR_FORMATS, MILLISECOND_FORMATS, MINUTE_FORMATS, MONTH_FORMATS, SECOND_FORMATS, TIME_FORMATS, YEAR_FORMATS } from './constants';
+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';
 /** - Minute in numeric string from `00` to `59` */
@@ -20,9 +20,9 @@ export interface GreetingConfigs {
     /** Current time in "HH:MM" format for some weird reason. Defaults to current time `new Date()` */
     currentTime?: Time;
     /** Optional string to append after each message */
-    appendMsg?: string;
+    appendToMsg?: string;
     /** Optional string to prepend before each message */
-    prependMsg?: string;
+    prependToMsg?: string;
     /** Custom greeting message for the morning period. */
     morningMessage?: string;
     /** Custom greeting message for the noon period. */
@@ -47,4 +47,9 @@ 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 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 = '-01' | '-02' | '-03' | '-04' | '-05' | '-06' | '-07' | '-08' | '-09' | '-10' | '-11' | '-12';
+export type UTCMinute = '00' | '15' | '30' | '45';
+export type UTCOffSet = `UTC${PositiveUTCHour | NegativeUTCHour}:${UTCMinute}`;
 //# sourceMappingURL=types.d.ts.map

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/dist/date/utils.d.ts

@@ -1,4 +1,5 @@
-import type { Time } from './types';
+import { Chronos } from './Chronos';
+import type { Time, UTCOffSet } from './types';
 /**
  * * Extracts the hour and minute from a time string in `HH:MM` format.
  *
@@ -20,4 +21,29 @@ export declare function getTotalMinutes(time: Time): number;
  * @returns The current date and time as a `Date` object.
  */
 export declare function getCurrentDateTime(): Date;
+/**
+ * * Converts a date into a Chronos object.
+ *
+ * @param date - A date value. It can be a `string`, `number`, `Date`, or `Chronos` object.
+ * - If a string is provided, it should be in a format that can be parsed by the Date constructor.
+ * - If a number is provided, it should be a timestamp (milliseconds since the Unix epoch).
+ * - If a Date object is provided, it will be used as is.
+ * - If a Chronos object is provided, it will be converted to a Date object.
+ * @returns A new Chronos object representing the provided date.
+ */
+export declare function chronos(date?: number | string | Date | Chronos): Chronos;
+/**
+ * * Extract Time in `HH:MM` format from given UTC value.
+ *
+ * @param utc UTC value in `UTC-01:30` or `UTC+01:30` format.
+ * @returns The UTC value in `HH:MM` format.
+ */
+export declare function extractTimeFromUTC(utc: UTCOffSet): Time;
+/**
+ * * Converts a UTC value in `UTC-01:30` or `UTC+01:30` format into total minutes in number.
+ *
+ * @param time - UTC value in `UTC-01:30` or `UTC+01:30` format.
+ * @returns The total minutes elapsed since `00:00`.
+ */
+export declare function extractMinutesFromUTC(utc: UTCOffSet): number;
 //# sourceMappingURL=utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/date/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAI9D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAIlD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/date/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAI9D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAIlD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,WAE9D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAE5D"}

package/dist/date/utils.js

@@ -1,3 +1,4 @@
+import { Chronos } from './Chronos';
 /**
  * * Extracts the hour and minute from a time string in `HH:MM` format.
  *
@@ -27,3 +28,34 @@ export function getTotalMinutes(time) {
 export function getCurrentDateTime() {
     return new Date();
 }
+/**
+ * * Converts a date into a Chronos object.
+ *
+ * @param date - A date value. It can be a `string`, `number`, `Date`, or `Chronos` object.
+ * - If a string is provided, it should be in a format that can be parsed by the Date constructor.
+ * - If a number is provided, it should be a timestamp (milliseconds since the Unix epoch).
+ * - If a Date object is provided, it will be used as is.
+ * - If a Chronos object is provided, it will be converted to a Date object.
+ * @returns A new Chronos object representing the provided date.
+ */
+export function chronos(date) {
+    return new Chronos(date);
+}
+/**
+ * * Extract Time in `HH:MM` format from given UTC value.
+ *
+ * @param utc UTC value in `UTC-01:30` or `UTC+01:30` format.
+ * @returns The UTC value in `HH:MM` format.
+ */
+export function extractTimeFromUTC(utc) {
+    return utc.replace(/^UTC[+-]?/g, '');
+}
+/**
+ * * Converts a UTC value in `UTC-01:30` or `UTC+01:30` format into total minutes in number.
+ *
+ * @param time - UTC value in `UTC-01:30` or `UTC+01:30` format.
+ * @returns The total minutes elapsed since `00:00`.
+ */
+export function extractMinutesFromUTC(utc) {
+    return getTotalMinutes(extractTimeFromUTC(utc));
+}

package/dist/index.d.ts

@@ -14,9 +14,9 @@ export { generateRandomColorInHexRGB, generateRandomHSLColor, } from './colors/r
 export { convertColorCode, convertHex8ToHsla, convertHex8ToRgba, convertHexToHsl, convertHexToRgb, convertHslaToHex8, convertHslaToRgba, convertHslToHex, convertHslToRgb, convertRgbaToHex8, convertRgbaToHsla, convertRgbToHex, convertRgbToHsl, convertRgbToRgba, } from './colors/convert';
 export { Color, Color as Colour } from './colors/Color';
 export { getGreeting as generateGreeting, getGreeting, getGreeting as greet, } from './date/greet';
-export { isValidTime, isValidTime as isValidTimeString } from './date/guards';
+export { isValidTime, isValidTime as isValidTimeString, isValidUTCOffSet as isValidUTC, isValidUTCOffSet, } from './date/guards';
 export { Chronos, Chronos as Chronus } from './date/Chronos';
-export { extractHourMinute, getCurrentDateTime, getCurrentDateTime as getCurrentTime, getTotalMinutes, } from './date/utils';
+export { chronos, chronos as chronosjs, chronos as chronosts, chronos as chronus, chronos as chronusjs, chronos as chronusts, extractHourMinute, extractMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, getCurrentDateTime, getCurrentDateTime as getCurrentTime, extractMinutesFromUTC as getMinutesFromUTC, extractTimeFromUTC as getTimeStringFromUTC, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, extractMinutesFromUTC as getTotalMinutesFromUTC, } from './date/utils';
 export { filterArrayOfObjects, flattenArray, getLastArrayElement, isInvalidOrEmptyArray, isInvalidOrEmptyArray as isValidEmptyArray, shuffleArray, } from './array/basics';
 export { sortAnArray } from './array/sort';
 export { createOptionsArray, moveArrayElement, removeDuplicatesFromArray, rotateArray, splitArray, } from './array/transform';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -18,9 +18,9 @@ export { convertColorCode, convertHex8ToHsla, convertHex8ToRgba, convertHexToHsl
 export { Color, Color as Colour } from './colors/Color';
 // ! Date & Time Utilities
 export { getGreeting as generateGreeting, getGreeting, getGreeting as greet, } from './date/greet';
-export { isValidTime, isValidTime as isValidTimeString } from './date/guards';
+export { isValidTime, isValidTime as isValidTimeString, isValidUTCOffSet as isValidUTC, isValidUTCOffSet, } from './date/guards';
 export { Chronos, Chronos as Chronus } from './date/Chronos';
-export { extractHourMinute, getCurrentDateTime, getCurrentDateTime as getCurrentTime, getTotalMinutes, } from './date/utils';
+export { chronos, chronos as chronosjs, chronos as chronosts, chronos as chronus, chronos as chronusjs, chronos as chronusts, extractHourMinute, extractMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, getCurrentDateTime, getCurrentDateTime as getCurrentTime, extractMinutesFromUTC as getMinutesFromUTC, extractTimeFromUTC as getTimeStringFromUTC, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, extractMinutesFromUTC as getTotalMinutesFromUTC, } from './date/utils';
 // ! Array Utilities
 export { filterArrayOfObjects, flattenArray, getLastArrayElement, isInvalidOrEmptyArray, isInvalidOrEmptyArray as isValidEmptyArray, shuffleArray, } from './array/basics';
 export { sortAnArray } from './array/sort';

package/package.json

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