nhb-toolbox 3.5.20 → 3.6.0

package/dist/date/Chronos.d.ts

@@ -1,4 +1,4 @@
-import type { FormatOptions, TimeZone, UTCOffSet } from './types';
+import type { FormatOptions, TimeUnit, TimeZone, UTCOffSet } from './types';
 export declare class Chronos {
     #private;
     /**
@@ -81,16 +81,6 @@ export declare class Chronos {
      * @returns A new `Chronos` instance with the updated date.
      */
     subtractDays(days: number): Chronos;
-    /**
-     * * Determines if the given date is today, tomorrow, yesterday or any relative day.
-     * @param date - The date to compare (Date object).
-     * @returns
-     *  - `-1` if the date is yesterday.
-     *  - `0` if the date is today.
-     *  - `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(): number;
     /**
      * * 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.
@@ -105,5 +95,44 @@ export declare class Chronos {
      * @returns A new instance of `Chronos` with time in the given timezone. Invalid input sets time-zone to `UTC`.
      */
     timeZone(zone: TimeZone | UTCOffSet): Chronos;
+    /** - Checks if the current date is today. */
+    isToday(): boolean;
+    /** - Checks if the current date is tomorrow. */
+    isTomorrow(): boolean;
+    /** - Checks if the current date is yesterday. */
+    isYesterday(): boolean;
+    /**
+     * * Returns full time difference from now (or specified time) in years, months, days, hours, minutes, and seconds.
+     * @param time An optional time value (`number`, `string`, `Date`, or `Chronos` object).
+     * @returns The difference as string, e.g., `2 years 1 month 9 days 18 hours 56 minutes 9 seconds ago`.
+     */
+    fromNow(time?: string | number | Date | Chronos): string;
+    /** * Returns the number of full years between the input date and now. */
+    getRelativeYear(): number;
+    /** * Returns the number of full months between the input date and now. */
+    getRelativeMonth(): number;
+    /**
+     * * Determines if the given date is today, tomorrow, yesterday or any relative day.
+     * @param date - The date to compare (Date object).
+     * @returns
+     *  - `-1` if the date is yesterday.
+     *  - `0` if the date is today.
+     *  - `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(): number;
+    /** * Returns the number of full hours between the input date and now. */
+    getRelativeHour(): number;
+    /** * Returns the number of full minutes between the input date and now. */
+    getRelativeMinute(): number;
+    /** * Returns the number of full seconds between the input date and now. */
+    getRelativeSecond(): number;
+    /** * Returns the number of milliseconds between the input date and now. */
+    getRelativeMilliSecond(): number;
+    /**
+     * * Compares the stored date with now, returning the difference in the specified unit.
+     * @param unit The time unit to compare by. Defaults to 'minute'.
+     */
+    compare(unit?: TimeUnit): number;
 }
 //# 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":"AAEA,OAAO,KAAK,EAEX,aAAa,EACb,QAAQ,EACR,SAAS,EACT,MAAM,SAAS,CAAC;AAGjB,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,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;IAOtC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;IAO7C;;;;OAIG;IACH,MAAM,CAAC,GAAG,IAAI,MAAM;IA2FpB;;;;;;OAMG;IACH,MAAM,CACL,MAAM,GAAE,MAAwC,EAChD,MAAM,UAAQ,GACZ,MAAM;IAIT;;;;;OAKG;IACH,SAAS,CAAC,MAAM,GAAE,MAAwC,GAAG,MAAM;IAInE;;;;OAIG;IACH,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"}
+{"version":3,"file":"Chronos.d.ts","sourceRoot":"","sources":["../../src/date/Chronos.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEX,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,SAAS,CAAC;AAGjB,qBAAa,OAAO;;IAInB;;;;;;;;OAQG;gBACS,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO;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,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;IAOtC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;IAO7C;;;;OAIG;IACH,MAAM,CAAC,GAAG,IAAI,MAAM;IA2FpB;;;;;;OAMG;IACH,MAAM,CACL,MAAM,GAAE,MAAwC,EAChD,MAAM,UAAQ,GACZ,MAAM;IAIT;;;;;OAKG;IACH,SAAS,CAAC,MAAM,GAAE,MAAwC,GAAG,MAAM;IAInE;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAM9B;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInC;;;;;OAKG;IACH,UAAU,IAAI,OAAO;IAMrB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO;IAiB7C,6CAA6C;IAC7C,OAAO,IAAI,OAAO;IAIlB,gDAAgD;IAChD,UAAU,IAAI,OAAO;IAIrB,iDAAiD;IACjD,WAAW,IAAI,OAAO;IAItB;;;;OAIG;IACH,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM;IAgExD,yEAAyE;IACzE,eAAe,IAAI,MAAM;IAgBzB,0EAA0E;IAC1E,gBAAgB,IAAI,MAAM;IAc1B;;;;;;;;OAQG;IACH,cAAc,IAAI,MAAM;IAexB,yEAAyE;IACzE,eAAe,IAAI,MAAM;IAKzB,2EAA2E;IAC3E,iBAAiB,IAAI,MAAM;IAK3B,2EAA2E;IAC3E,iBAAiB,IAAI,MAAM;IAK3B,2EAA2E;IAC3E,sBAAsB,IAAI,MAAM;IAIhC;;;OAGG;IACH,OAAO,CAAC,IAAI,GAAE,QAAmB,GAAG,MAAM;CAoB1C"}

package/dist/date/Chronos.js

@@ -209,26 +209,6 @@ export class Chronos {
     subtractDays(days) {
         return this.addDays(-days);
     }
-    /**
-     * * Determines if the given date is today, tomorrow, yesterday or any relative day.
-     * @param date - The date to compare (Date object).
-     * @returns
-     *  - `-1` if the date is yesterday.
-     *  - `0` if the date is today.
-     *  - `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() {
-        const today = new Date();
-        // Set the time of today to 00:00:00 for comparison purposes
-        today.setHours(0, 0, 0, 0);
-        // Normalize the input date to 00:00:00
-        const inputDate = new Date(this.#date);
-        inputDate.setHours(0, 0, 0, 0);
-        const diffTime = inputDate.getTime() - today.getTime();
-        const diffDays = Math.floor(diffTime / (1000 * 60 * 60 * 24));
-        return diffDays;
-    }
     /**
      * * 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.
@@ -257,4 +237,162 @@ export class Chronos {
         const adjusted = new Date(utc + offset * 60 * 1000);
         return new Chronos(adjusted);
     }
+    /** - Checks if the current date is today. */
+    isToday() {
+        return this.getRelativeDay() === 0;
+    }
+    /** - Checks if the current date is tomorrow. */
+    isTomorrow() {
+        return this.getRelativeDay() === 1;
+    }
+    /** - Checks if the current date is yesterday. */
+    isYesterday() {
+        return this.getRelativeDay() === -1;
+    }
+    /**
+     * * Returns full time difference from now (or specified time) in years, months, days, hours, minutes, and seconds.
+     * @param time An optional time value (`number`, `string`, `Date`, or `Chronos` object).
+     * @returns The difference as string, e.g., `2 years 1 month 9 days 18 hours 56 minutes 9 seconds ago`.
+     */
+    fromNow(time) {
+        const now = time instanceof Chronos ?
+            time.toDate()
+            : new Date(time ?? Date.now());
+        // Check if the date is invalid
+        if (isNaN(now.getTime())) {
+            throw new Error('Provided date is invalid!');
+        }
+        const target = this.#date;
+        const isFuture = target > now;
+        const from = isFuture ? now : target;
+        const to = isFuture ? target : now;
+        let years = to.getFullYear() - from.getFullYear();
+        let months = to.getMonth() - from.getMonth();
+        let days = to.getDate() - from.getDate();
+        let hours = to.getHours() - from.getHours();
+        let minutes = to.getMinutes() - from.getMinutes();
+        let seconds = to.getSeconds() - from.getSeconds();
+        // Adjust negative values
+        if (seconds < 0) {
+            seconds += 60;
+            minutes--;
+        }
+        if (minutes < 0) {
+            minutes += 60;
+            hours--;
+        }
+        if (hours < 0) {
+            hours += 24;
+            days--;
+        }
+        if (days < 0) {
+            const prevMonth = new Date(to.getFullYear(), to.getMonth(), 0);
+            days += prevMonth.getDate();
+            months--;
+        }
+        if (months < 0) {
+            months += 12;
+            years--;
+        }
+        const parts = [];
+        if (years > 0)
+            parts.push(`${years} year${years > 1 ? 's' : ''}`);
+        if (months > 0)
+            parts.push(`${months} month${months > 1 ? 's' : ''}`);
+        if (days > 0)
+            parts.push(`${days} day${days > 1 ? 's' : ''}`);
+        if (hours > 0)
+            parts.push(`${hours} hour${hours > 1 ? 's' : ''}`);
+        if (minutes > 0)
+            parts.push(`${minutes} minute${minutes > 1 ? 's' : ''}`);
+        if (seconds > 0 || parts.length === 0)
+            parts.push(`${seconds} second${seconds !== 1 ? 's' : ''}`);
+        return `${isFuture ? 'in ' : ''}${parts.join(' ')}${isFuture ? '' : ' ago'}`;
+    }
+    /** * Returns the number of full years between the input date and now. */
+    getRelativeYear() {
+        const now = new Date();
+        let years = now.getFullYear() - this.#date.getFullYear();
+        const hasNotHadBirthday = now.getMonth() < this.#date.getMonth() ||
+            (now.getMonth() === this.#date.getMonth() &&
+                now.getDate() < this.#date.getDate());
+        if (hasNotHadBirthday) {
+            years--;
+        }
+        return years;
+    }
+    /** * Returns the number of full months between the input date and now. */
+    getRelativeMonth() {
+        const now = new Date();
+        let months = (now.getFullYear() - this.#date.getFullYear()) * 12 +
+            (now.getMonth() - this.#date.getMonth());
+        const hasNotHadMonthDay = now.getDate() < this.#date.getDate();
+        if (hasNotHadMonthDay) {
+            months--;
+        }
+        return months;
+    }
+    /**
+     * * Determines if the given date is today, tomorrow, yesterday or any relative day.
+     * @param date - The date to compare (Date object).
+     * @returns
+     *  - `-1` if the date is yesterday.
+     *  - `0` if the date is today.
+     *  - `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() {
+        const today = new Date();
+        // Set the time of today to 00:00:00 for comparison purposes
+        today.setHours(0, 0, 0, 0);
+        // Normalize the input date to 00:00:00
+        const inputDate = new Date(this.#date);
+        inputDate.setHours(0, 0, 0, 0);
+        const diffTime = inputDate.getTime() - today.getTime();
+        const diffDays = Math.floor(diffTime / (1000 * 60 * 60 * 24));
+        return diffDays;
+    }
+    /** * Returns the number of full hours between the input date and now. */
+    getRelativeHour() {
+        const diff = new Date().getTime() - this.#date.getTime();
+        return Math.floor(diff / (1000 * 60 * 60));
+    }
+    /** * Returns the number of full minutes between the input date and now. */
+    getRelativeMinute() {
+        const diff = new Date().getTime() - this.#date.getTime();
+        return Math.floor(diff / (1000 * 60));
+    }
+    /** * Returns the number of full seconds between the input date and now. */
+    getRelativeSecond() {
+        const diff = new Date().getTime() - this.#date.getTime();
+        return Math.floor(diff / 1000);
+    }
+    /** * Returns the number of milliseconds between the input date and now. */
+    getRelativeMilliSecond() {
+        return new Date().getTime() - this.#date.getTime();
+    }
+    /**
+     * * Compares the stored date with now, returning the difference in the specified unit.
+     * @param unit The time unit to compare by. Defaults to 'minute'.
+     */
+    compare(unit = 'minute') {
+        switch (unit) {
+            case 'year':
+                return this.getRelativeYear();
+            case 'month':
+                return this.getRelativeMonth();
+            case 'day':
+                return this.getRelativeDay();
+            case 'hour':
+                return this.getRelativeHour();
+            case 'minute':
+                return this.getRelativeMinute();
+            case 'second':
+                return this.getRelativeSecond();
+            case 'millisecond':
+                return this.getRelativeMilliSecond();
+            default:
+                throw new Error(`Unsupported time unit: ${unit}`);
+        }
+    }
 }

package/dist/date/types.d.ts

@@ -36,7 +36,7 @@ export interface GreetingConfigs {
     /** Default greeting message if no period matches. */
     defaultMessage?: string;
 }
-export type FormatType = 'year' | 'month' | 'day' | 'date' | 'hour' | 'minute' | 'second' | 'millisecond';
+export type TimeUnit = 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second' | 'millisecond';
 export type Year = (typeof YEAR_FORMATS)[number];
 export type Month = (typeof MONTH_FORMATS)[number];
 export type Day = (typeof DAY_FORMATS)[number];
@@ -49,7 +49,7 @@ 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 NegativeUTCHour = '-00' | '-01' | '-02' | '-03' | '-04' | '-05' | '-06' | '-07' | '-08' | '-09' | '-10' | '-11' | '-12' | '-13' | '-14';
 export type UTCMinute = '00' | '15' | '30' | '45';
 export type UTCOffSet = `UTC${PositiveUTCHour | NegativeUTCHour}:${UTCMinute}`;
 /** * Format options */

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,19 +1,19 @@
 import { Chronos } from './Chronos';
 import type { Time, UTCOffSet } from './types';
 /**
- * * Extracts the hour and minute from a time string in `HH:MM` format.
+ * * Extracts the hour and minute from a time string in `HH:MM` or `-HH:MM` format.
  *
  * @param time - The time string to extract from.
  * @return The extracted hour and minute as number tuple.
  */
-export declare function extractHourMinute(time: Time): [number, number];
+export declare function extractHourMinute(time: `-${Time}` | Time): [number, number];
 /**
- * * Converts a time string `HH:MM` into total minutes from `00:00`.
+ * * Converts a time string `HH:MM` or `-HH:MM` into total minutes from `00:00`.
  *
- * @param time - The time in `HH:MM` format.
+ * @param time - The time in `HH:MM` or `-HH:MM` format.
  * @returns The total minutes elapsed since `00:00`.
  */
-export declare function getTotalMinutes(time: Time): number;
+export declare function getTotalMinutes(time: `-${Time}` | Time): number;
 /**
  * * Returns the current date and time as `Date` object.
  * - All the methods and properties of `new Date()` are accessible.
@@ -38,7 +38,7 @@ export declare function chronos(date?: number | string | Date | Chronos): Chrono
  * @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;
+export declare function extractTimeFromUTC(utc: UTCOffSet): `-${Time}` | Time;
 /**
  * * Converts a UTC value in `UTC-01:30` or `UTC+01:30` format into total minutes in number.
  *

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,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"}
+{"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,IAAI,EAAE,GAAG,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAI3E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,GAAG,IAAI,GAAG,MAAM,CAU/D;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,IAAI,EAAE,GAAG,IAAI,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAE5D"}

package/dist/date/utils.js

@@ -1,6 +1,6 @@
 import { Chronos } from './Chronos';
 /**
- * * Extracts the hour and minute from a time string in `HH:MM` format.
+ * * Extracts the hour and minute from a time string in `HH:MM` or `-HH:MM` format.
  *
  * @param time - The time string to extract from.
  * @return The extracted hour and minute as number tuple.
@@ -10,14 +10,16 @@ export function extractHourMinute(time) {
     return [hour, minute];
 }
 /**
- * * Converts a time string `HH:MM` into total minutes from `00:00`.
+ * * Converts a time string `HH:MM` or `-HH:MM` into total minutes from `00:00`.
  *
- * @param time - The time in `HH:MM` format.
+ * @param time - The time in `HH:MM` or `-HH:MM` format.
  * @returns The total minutes elapsed since `00:00`.
  */
 export function getTotalMinutes(time) {
-    const [h, m] = extractHourMinute(time);
-    return h * 60 + m;
+    const isNegative = time.startsWith('-');
+    const [h, m] = extractHourMinute(isNegative ? time.slice(1) : time);
+    const total = h * 60 + m;
+    return isNegative ? -total : total;
 }
 /**
  * * Returns the current date and time as `Date` object.
@@ -48,7 +50,7 @@ export function chronos(date) {
  * @returns The UTC value in `HH:MM` format.
  */
 export function extractTimeFromUTC(utc) {
-    return utc.replace(/^UTC[+-]?/g, '');
+    return utc.replace(/^UTC[+]?/g, '');
 }
 /**
  * * Converts a UTC value in `UTC-01:30` or `UTC+01:30` format into total minutes in number.

package/package.json

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