nhb-toolbox 3.5.0 → 3.5.15

package/dist/date/Chronos.d.ts

@@ -1,3 +1,4 @@
+import type { TimeZone, UTCOffSet } from './types';
 export declare class Chronos {
     #private;
     /**
@@ -54,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.
@@ -88,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 `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;;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;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,4 +1,6 @@
-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;
@@ -96,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),
@@ -165,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.
@@ -213,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 `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] ?? TIME_ZONES['UTC'];
+        }
+        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/guards.d.ts

@@ -1,4 +1,5 @@
-import type { Time } from './types';
+import type { Numeric } from '../types';
+import type { Time, UTCOffSet } from './types';
 /**
  * * Checks if the provided value is a valid time string in "HH:MM" format.
  *
@@ -6,4 +7,20 @@ 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;
+/**
+ * * Checks if the year is a leap year.
+ *
+ * - A year is a leap year if it is divisible by 4, but not divisible by 100, unless it is also divisible by 400.
+ * - For example, 2000 and 2400 are leap years, but 1900 and 2100 are not.
+ * @param year The year to check.
+ * @returns `true` if the year is a leap year, `false` otherwise.
+ */
+export declare function isLeapYear(year: Numeric): boolean;
 //# 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,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,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;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAKjD"}

package/dist/date/guards.js

@@ -16,3 +16,26 @@ 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);
+}
+/**
+ * * Checks if the year is a leap year.
+ *
+ * - A year is a leap year if it is divisible by 4, but not divisible by 100, unless it is also divisible by 400.
+ * - For example, 2000 and 2400 are leap years, but 1900 and 2100 are not.
+ * @param year The year to check.
+ * @returns `true` if the year is a leap year, `false` otherwise.
+ */
+export function isLeapYear(year) {
+    return ((Number(year) % 4 === 0 && Number(year) % 100 !== 0) ||
+        Number(year) % 400 === 0);
+}

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` */
@@ -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,5 +1,5 @@
 import { Chronos } from './Chronos';
-import type { Time } from './types';
+import type { Time, UTCOffSet } from './types';
 /**
  * * Extracts the hour and minute from a time string in `HH:MM` format.
  *
@@ -32,4 +32,18 @@ export declare function getCurrentDateTime(): Date;
  * @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,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,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;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,WAE9D"}
+{"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

@@ -41,3 +41,21 @@ export function getCurrentDateTime() {
 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, isLeapYear, } from './date/guards';
 export { Chronos, Chronos as Chronus } from './date/Chronos';
-export { chronos, chronos as chronosjs, chronos as chronosts, chronos as chronus, chronos as chronusjs, chronos as chronusts, 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":"AACA,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,cAAc,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EACN,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,GACX,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,aAAa,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,IAAI,mBAAmB,GAC7C,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACN,YAAY,IAAI,YAAY,EAC5B,YAAY,EACZ,YAAY,IAAI,YAAY,EAC5B,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,IAAI,YAAY,EAClC,kBAAkB,IAAI,mBAAmB,EACzC,kBAAkB,EAClB,eAAe,EACf,UAAU,IAAI,eAAe,EAC7B,aAAa,EACb,SAAS,EACT,UAAU,EACV,UAAU,IAAI,YAAY,GAC1B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,MAAM,EACN,MAAM,IAAI,YAAY,EACtB,WAAW,EACX,UAAU,EACV,KAAK,EACL,KAAK,IAAI,WAAW,EACpB,WAAW,IAAI,gBAAgB,EAC/B,WAAW,IAAI,sBAAsB,EACrC,eAAe,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,aAAa,IAAI,oBAAoB,EACrC,sBAAsB,EACtB,aAAa,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,gBAAgB,EAChB,gBAAgB,IAAI,eAAe,EACnC,OAAO,EACP,OAAO,IAAI,aAAa,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACN,WAAW,EACX,cAAc,IAAI,uBAAuB,EACzC,cAAc,EACd,cAAc,IAAI,gBAAgB,EAClC,cAAc,EACd,cAAc,IAAI,WAAW,EAC7B,cAAc,IAAI,4BAA4B,EAC9C,cAAc,EACd,cAAc,IAAI,sBAAsB,GACxC,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EACN,2BAA2B,EAC3B,sBAAsB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxD,OAAO,EACN,WAAW,IAAI,gBAAgB,EAC/B,WAAW,EACX,WAAW,IAAI,KAAK,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,WAAW,EAAE,WAAW,IAAI,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE9E,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE7D,OAAO,EACN,OAAO,EACP,OAAO,IAAI,SAAS,EACpB,OAAO,IAAI,SAAS,EACpB,OAAO,IAAI,OAAO,EAClB,OAAO,IAAI,SAAS,EACpB,OAAO,IAAI,SAAS,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,IAAI,cAAc,EACpC,eAAe,GACf,MAAM,cAAc,CAAC;AAGtB,OAAO,EACN,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,IAAI,iBAAiB,EAC1C,YAAY,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,WAAW,EACX,UAAU,GACV,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACN,wBAAwB,IAAI,mBAAmB,EAC/C,wBAAwB,EACxB,wBAAwB,IAAI,cAAc,GAC1C,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACN,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,YAAY,EACZ,eAAe,EACf,eAAe,GACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEjE,OAAO,EACN,gBAAgB,EAChB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EACN,mBAAmB,EACnB,cAAc,EACd,gBAAgB,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,EACN,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,GACpB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACN,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,cAAc,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EACN,SAAS,EACT,OAAO,EACP,SAAS,EACT,gBAAgB,EAChB,MAAM,EACN,QAAQ,EACR,iBAAiB,EACjB,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,WAAW,GACX,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACN,kBAAkB,IAAI,iBAAiB,EACvC,OAAO,EACP,aAAa,EACb,YAAY,IAAI,iBAAiB,EACjC,QAAQ,EACR,MAAM,EACN,aAAa,EACb,aAAa,IAAI,kBAAkB,EACnC,OAAO,EACP,UAAU,EACV,MAAM,EACN,MAAM,IAAI,YAAY,EACtB,KAAK,EACL,gBAAgB,EAChB,QAAQ,EACR,aAAa,IAAI,aAAa,EAC9B,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,QAAQ,IAAI,mBAAmB,EAC/B,kBAAkB,EAClB,KAAK,EACL,YAAY,EACZ,MAAM,IAAI,WAAW,EACrB,KAAK,IAAI,UAAU,EACnB,gBAAgB,IAAI,aAAa,EACjC,KAAK,IAAI,UAAU,GACnB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACN,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,aAAa,EACb,aAAa,IAAI,iBAAiB,EAClC,WAAW,EACX,MAAM,EACN,aAAa,IAAI,SAAS,EAC1B,aAAa,IAAI,iBAAiB,EAClC,eAAe,EACf,aAAa,EACb,KAAK,EACL,MAAM,EACN,OAAO,IAAI,YAAY,EACvB,KAAK,IAAI,UAAU,GACnB,MAAM,mBAAmB,CAAC"}
+{"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, isLeapYear, } from './date/guards';
 export { Chronos, Chronos as Chronus } from './date/Chronos';
-export { chronos, chronos as chronosjs, chronos as chronosts, chronos as chronus, chronos as chronusjs, chronos as chronusts, 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.5.0",
+  "version": "3.5.15",
   "description": "A versatile collection of smart, efficient, and reusable utility functions for everyday development needs.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",