nhb-toolbox 4.26.21 → 4.26.30

package/CHANGELOG.md

@@ -6,11 +6,25 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.26.30] - 2025-11-11
+
+### 🕧 Updates in Chronos
+
+- **Fixed** issues in `getTimeZoneName()` and `getTimeZoneNameShort()` where expected outputs were *missing or incorrect*.
+- **Updated** *timezone constants*vby removing *redundant hints* and *improving internal consistency*.
+- **Introduced** a new *method alias* `getTimeZoneNameAbbr()` for `getTimeZoneNameShort()`.
+- **Fixed** an issue where the `clone()` method *did not correctly duplicate the instance state*.
+
 ## [4.26.21] - 2025-11-10
 
-- **Fixed** issues with `Chronos` timezone methods: `getTimeZoneName()` and `getTimeZoneNameShort()` *not providing name/short* name for *optional UTC*.
+### 🕧 Updates in Chronos
+
+- **Fixed** issues with `Chronos` timezone methods: `getTimeZoneName()` and `getTimeZoneNameShort()` *not providing name/short name* for *optional UTC*.
 - **Fixed** issues with `Chronos` `diff()` method: now *calculates exact differences for month and year* too.
 - **Changed** the signature of `Chronos` `set()` method to `set<Unit extends TimeUnit>(unit: Unit, value: TimeUnitValue<Unit>): Chronos`. **Created** new type helper `TimeUnitValue<Unit>`.
+
+### 🛠️ Other Updates
+
 - **Renamed** `isValidUTCOffSet` *guard* as `isValidUTCOffset` and also kept `isValidUTCOffSet` as alias.
 
 ## [4.26.20] - 2025-11-10

package/dist/cjs/date/Chronos.js

@@ -284,7 +284,7 @@ class Chronos {
         return this.getTimeStamp();
     }
     clone() {
-        return new _a(this.#date).#withOrigin(this.#ORIGIN);
+        return new _a(this.#date).#withOrigin(this.#ORIGIN, this.#offset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     }
     toDate() {
         switch (this.#ORIGIN) {

package/dist/cjs/date/plugins/timeZonePlugin.js

@@ -7,6 +7,13 @@ const timezone_1 = require("../timezone");
 const utils_1 = require("../utils");
 const timeZonePlugin = (ChronosClass) => {
     const { internalDate: $Date, withOrigin } = ChronosClass[constants_1.INTERNALS];
+    const _isGMT = (factor) => {
+        return factor === 'UTC+00:00' || factor === 'UTC-00:00';
+    };
+    const TZ_NAME_ABBR_MAP = new Map(Object.entries(timezone_1.TIME_ZONES).map(([tzAbbr, { offset, tzName }]) => [
+        offset,
+        { tzAbbr, tzName },
+    ]));
     const _isLabelKey = (offset) => {
         return offset in timezone_1.TIME_ZONE_LABELS;
     };
@@ -17,8 +24,14 @@ const timeZonePlugin = (ChronosClass) => {
         return undefined;
     };
     const _getTimeZoneName = (zone) => {
+        if (_isGMT(zone))
+            return 'Greenwich Mean Time';
         if ((0, guards_1.isValidUTCOffset)(zone)) {
-            return _resolveTzName(zone);
+            const tzName = _resolveTzName(zone);
+            if (!tzName && TZ_NAME_ABBR_MAP.has(zone)) {
+                return TZ_NAME_ABBR_MAP.get(zone)?.tzName;
+            }
+            return tzName;
         }
         else if ((0, guards_1.isValidTimeZoneId)(zone)) {
             const record = timezone_1.TIME_ZONE_IDS[zone];
@@ -27,17 +40,17 @@ const timeZonePlugin = (ChronosClass) => {
         else {
             return zone in timezone_1.TIME_ZONES ?
                 timezone_1.TIME_ZONES[zone].tzName
-                : _resolveTzName(timezone_1.TIME_ZONES[zone].offset);
+                : _resolveTzName(timezone_1.TIME_ZONES[zone]?.offset);
         }
     };
-    const TZ_ID_CACHE = new Map(Object.entries(timezone_1.TIME_ZONE_IDS).reduce((acc, [id, { offset }]) => {
+    const TZ_ID_MAP = new Map(Object.entries(timezone_1.TIME_ZONE_IDS).reduce((acc, [id, { offset }]) => {
         const arr = acc.get(offset) ?? [];
         arr.push(id);
         acc.set(offset, arr);
         return acc;
     }, new Map()));
     const _getTimeZoneId = (utc) => {
-        const tzIds = TZ_ID_CACHE.get(utc);
+        const tzIds = TZ_ID_MAP.get(utc);
         if (!tzIds || tzIds?.length === 0)
             return undefined;
         if (tzIds?.length === 1)
@@ -59,51 +72,72 @@ const timeZonePlugin = (ChronosClass) => {
             offset = zone in timezone_1.TIME_ZONES ? timezone_1.TIME_ZONES[zone].offset : timezone_1.TIME_ZONES['UTC'].offset;
             tzId = _getTimeZoneId(offset) || offset;
         }
-        const tzName = _getTimeZoneName(zone) ?? timezone_1.TIME_ZONES['UTC'].offset;
+        const $zone = zone || offset;
+        const tzName = _getTimeZoneName($zone) ?? offset;
         const targetOffset = (0, utils_1.extractMinutesFromUTC)(offset);
         const previousOffset = this.getTimeZoneOffsetMinutes();
         const relativeOffset = targetOffset - previousOffset;
         const adjustedTime = new Date($Date(this).getTime() + relativeOffset * 60 * 1000);
         const instance = new ChronosClass(adjustedTime);
-        return withOrigin(instance, `timeZone`, offset, tzName, tzId, zone);
+        return withOrigin(instance, `timeZone`, offset, tzName, tzId, $zone);
     };
     ChronosClass.prototype.getTimeZoneName = function (utc) {
         const UTC = utc || this.utcOffset;
         return _getTimeZoneName(utc || this?.$tzTracker || this.utcOffset) ?? UTC;
     };
-    const TZ_SHORT_CACHE = new Map();
+    const TZ_ABBR_CACHE = new Map();
+    const _abbreviate = (name) => {
+        return name
+            .split(/\s+/)
+            .map((w) => w[0])
+            .join('')
+            .replace(/\W/g, '');
+    };
     ChronosClass.prototype.getTimeZoneNameShort = function (utc) {
         const tracker = this?.$tzTracker;
+        const UTC = utc || this.utcOffset;
+        const tzMapKey = utc || tracker || this.utcOffset;
+        if (_isGMT(tzMapKey))
+            return 'GMT';
         if (!utc && tracker && tracker in timezone_1.TIME_ZONES)
             return tracker;
-        const zone = this.getTimeZoneName(utc);
-        if (TZ_SHORT_CACHE.has(zone))
-            return TZ_SHORT_CACHE.get(zone);
-        const customAbbr = (0, guards_1.isValidUTCOffset)(zone) || (0, guards_1.isValidTimeZoneId)(zone) ?
-            zone
-            : zone
-                .split(/\s+/)
-                .map((w) => w?.[0])
-                .join('')
-                .replace(/\W/g, '');
-        TZ_SHORT_CACHE.set(zone, customAbbr);
+        if ((0, guards_1.isValidUTCOffset)(tzMapKey)) {
+            if (TZ_ABBR_CACHE.has(tzMapKey))
+                return TZ_ABBR_CACHE.get(tzMapKey);
+            if (TZ_NAME_ABBR_MAP.has(tzMapKey)) {
+                return TZ_NAME_ABBR_MAP.get(tzMapKey)?.tzAbbr;
+            }
+            const tzName = _resolveTzName(tzMapKey);
+            if (tzName) {
+                const tzAbbr = _abbreviate(tzName);
+                TZ_ABBR_CACHE.set(tzMapKey, tzAbbr);
+                return tzAbbr;
+            }
+        }
+        const zone = _getTimeZoneName(tzMapKey) ?? UTC;
+        if (TZ_ABBR_CACHE.has(`name-${zone}`))
+            return TZ_ABBR_CACHE.get(zone);
+        const customAbbr = (0, guards_1.isValidUTCOffset)(zone) || (0, guards_1.isValidTimeZoneId)(zone) ? zone : _abbreviate(zone);
+        TZ_ABBR_CACHE.set(`name-${zone}`, customAbbr);
         return customAbbr;
     };
+    ChronosClass.prototype.getTimeZoneNameAbbr = function (utc) {
+        return this.getTimeZoneNameShort(utc);
+    };
     ChronosClass.prototype.toString = function () {
         const offset = this.utcOffset;
+        const search = /GMT[+-]\d{4}\s+\([^)]+\)/;
         switch (this.origin) {
             case 'timeZone': {
                 const gmt = offset.replace('UTC', 'GMT').replace(':', '');
                 const label = this.getTimeZoneName();
-                return $Date(this)
-                    .toString()
-                    .replace(/GMT[+-]\d{4}\s+\([^)]+\)/, `${gmt} (${label})`);
+                return $Date(this).toString().replace(search, `${gmt} (${label})`);
             }
             case 'toUTC':
             case 'utc': {
                 return $Date(this)
                     .toString()
-                    .replace(/GMT[+-]\d{4}\s+\([^)]+\)/, `GMT+0000 (Coordinated Universal Time)`);
+                    .replace(search, `GMT+0000 (Coordinated Universal Time)`);
             }
             default:
                 return $Date(this).toString();

package/dist/cjs/date/timezone.js

@@ -251,7 +251,7 @@ exports.TIME_ZONES = Object.freeze({
         offset: 'UTC+07:00',
     },
     DDUT: {
-        tzName: "Dumont d'Urville Time (in French Antarctic Station)",
+        tzName: "Dumont d'Urville Time (Antarctic Station in French)",
         offset: 'UTC+10:00',
     },
     DFT: {
@@ -399,7 +399,7 @@ exports.TIME_ZONES = Object.freeze({
         offset: 'UTC+07:00',
     },
     IDLW: {
-        tzName: 'International Date Line West time zone',
+        tzName: 'International Date Line West',
         offset: 'UTC-12:00',
     },
     IDT: {
@@ -892,7 +892,7 @@ exports.TIME_ZONE_LABELS = Object.freeze({
     'UTC+10:30': 'Lord Howe Standard Time',
     'UTC+11:00': 'Central Pacific Standard Time',
     'UTC+12:00': 'New Zealand Standard Time',
-    'UTC+12:45': 'Chatham Islands Time',
+    'UTC+12:45': 'Chatham Standard Time',
     'UTC+13:00': 'Phoenix Island Time',
     'UTC+14:00': 'Line Islands Time',
 });

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

@@ -17,7 +17,7 @@ import type { $UTCOffset, ChronosInput, ChronosInternals, ChronosMethods, Chrono
  * **It also accepts number values as following:**
  * - **`year, month, date, hours, minutes, seconds, milliseconds`**: Individual components of a date-time to construct a `Chronos` instance.
  *   - **`year`**: A number representing the year. If the year is between 0 and 99, it will be assumed to be the year 1900 + the provided year.
- *   - **`month`**: A number between 1 and 12 representing the month (1 for January, 12 for December). It is adjusted internally to a 0-based index (0 for January, 11 for December).
+ *   - **`month`**: A number between 1 and 12 representing the month (1 for January, 12 for December).
  *   - **`date`**: A number between 1 and 31 representing the day of the month.
  *   - **`hours`**: A number between 0 and 23 representing the hour of the day.
  *   - **`minutes`**: A number between 0 and 59 representing the minutes past the hour.
@@ -198,13 +198,13 @@ export declare class Chronos {
     get lastDateOfMonth(): NumberRange<28, 31>;
     /** @instance Returns a debug-friendly string for `console.log` or `util.inspect`. */
     inspect(): string;
-    /** @instance Enables JSON.stringify and logging in the console (in Browser environment) to show readable output. */
+    /** @instance Enables `JSON.stringify` to show readable output. Calls {@link toLocalISOString} method. */
     toJSON(): string;
-    /** @instance Enables arithmetic and comparison operations (e.g., +new Chronos()). */
+    /** @instance Enables arithmetic and comparison operations (e.g., `+new Chronos()`). Calls {@link getTimeStamp} method. */
     valueOf(): number;
-    /** @instance Clones and returns a new `Chronos` instance with the same date. */
+    /** @instance Clones and returns exactly same `Chronos` instance. */
     clone(): Chronos;
-    /** @instance Gets the native `Date` instance (read-only). */
+    /** @instance Gets the native `Date` instance of the current `Chronos`. */
     toDate(): Date;
     /** @instance Returns a string representation of a date. */
     toString(): string;
@@ -320,11 +320,11 @@ export declare class Chronos {
      * @returns `true` if the year is a leap year, `false` otherwise.
      */
     isLeapYear(year?: number): boolean;
-    /** @instance Checks if another date is exactly equal to this one */
+    /** @instance Checks if another date is exactly equal to this one. */
     isEqual(other: ChronosInput): boolean;
-    /** @instance Checks if another date is exactly equal to or before this one */
+    /** @instance Checks if another date is exactly equal to or before this one. */
     isEqualOrBefore(other: ChronosInput): boolean;
-    /** @instance Checks if another date is exactly equal to or after this one */
+    /** @instance Checks if another date is exactly equal to or after this one. */
     isEqualOrAfter(other: ChronosInput): boolean;
     /**
      * @instance Checks if another date is the same as this one in a specific unit.
@@ -489,7 +489,7 @@ export declare class Chronos {
      * - `Q3`: July to September
      * - `Q4`: October to December
      *
-     * This method strictly uses the **calendar year**. For fiscal quarters, use `toFiscalQuarter()` instead.
+     * This method strictly uses the **calendar year**. For fiscal quarters, use {@link toFiscalQuarter} instead.
      *
      * @example
      * new Chronos('2025-02-14').toQuarter(); // 1
@@ -752,12 +752,12 @@ export declare class Chronos {
      */
     static getDatesForDay(day: WeekDay, options?: DateRangeOptions): string[];
     /**
-     * @static Returns earliest Chronos
+     * @static Returns earliest Chronos.
      * @param dates Date inputs.
      */
     static min(...dates: ChronosInput[]): Chronos;
     /**
-     * @static Returns latest Chronos
+     * @static Returns latest Chronos.
      * @param dates Date inputs.
      */
     static max(...dates: ChronosInput[]): Chronos;

package/dist/dts/date/plugins/businessPlugin.d.ts

@@ -107,13 +107,13 @@ declare module '../Chronos' {
          */
         isBusinessHour(options?: BusinessOptionsWeekends): boolean;
         /**
-         * @instance Returns the academic year based on a typical start in July and end in June.
+         * @instance Returns the academic year based on a typical start in `July` and end in `June`.
          * @returns The academic year in format `YYYY-YYYY`.
          */
         toAcademicYear(): AcademicYear;
         /**
          * @instance Returns the fiscal quarter based on custom fiscal year start (defaults to July).
-         * @param startMonth - The fiscal year start month (1-12), default is July (7).
+         * @param startMonth - The fiscal year start month (1-12), default is July (`7`).
          * @returns The fiscal quarter (1-4).
          */
         toFiscalQuarter(startMonth?: NumberRange<1, 12>): Quarter;

package/dist/dts/date/plugins/durationPlugin.d.ts

@@ -4,6 +4,9 @@ declare module '../Chronos' {
     interface Chronos {
         /**
          * @instance Returns the full time duration breakdown between current input (start) and another time (to) as {@link TimeDuration} object.
+         *
+         * @remarks This method calculates the elapsed time difference (excludes the end day), if you need an inclusive calendar-style difference (counting both start and end days), adjust one day manually before calling `duration()`.
+         *
          * @param toTime The time to compare with. Defaults to `now`.
          * @param absolute If true, returns all values as positive numbers. Defaults to `true`.
          * @returns An object of time units: `years`, `months`, `days`, `hours`, `minutes`, `seconds`, `milliseconds` ({@link TimeDuration}).
@@ -11,6 +14,9 @@ declare module '../Chronos' {
         duration(toTime?: ChronosInput, absolute?: boolean): TimeDuration;
         /**
          * @instance Returns a human-readable formatted duration string between the current instance (start) and another time (to).
+         *
+         * @remarks This method calculates the elapsed time difference (excludes the end day), if you need an inclusive calendar-style difference (counting both start and end days), adjust one day manually before calling `durationString()`.
+         *
          * @param options {@link DurationOptions} to format duration string, including the time to compare with.
          * @returns A formatted duration string, e.g. `"2 hours, 5 minutes"` or `"2h 5m"`.
          */

package/dist/dts/date/plugins/timeZonePlugin.d.ts

@@ -34,23 +34,20 @@ declare module '../Chronos' {
         /**
          * @instance Returns the current time zone name as a full descriptive string (e.g. `"Bangladesh Standard Time"`).
          *
-         * @param utc Optional UTC offset in `"UTC+06:00"` format. When passed, it bypasses the current time zone offset.
-         * @returns Time zone name in full descriptive string or UTC offset if it is not a valid time zone.
-         *
          * @remarks
          * - This method uses a predefined mapping of UTC offsets to time zone names.
          * - If multiple time zones share the same UTC offset, it returns the **first match** from the predefined list.
          * - If no match is found (which is rare), it falls back to returning the UTC offset (e.g. `"UTC+06:00"`).
          * - To retrieve the local system's native time zone name (or its identifier if the name is unavailable), use the {@link $getNativeTimeZone} instance method.
          * - To retrieve the local system's native time zone identifier, use the {@link $getNativeTimeZoneId} instance method.
+         *
+         * @param utc Optional UTC offset in `"UTC+06:00"` format. When passed, it bypasses the current time zone offset.
+         * @returns Time zone name in full descriptive string or UTC offset if it is not a valid time zone.
          */
         getTimeZoneName(utc?: UTCOffset): LooseLiteral<TimeZoneName | UTCOffset>;
         /**
          * @instance Returns the current time zone abbreviation (e.g. `"BST"` for `Bangladesh Standard Time`).
          *
-         * @param utc Optional UTC offset in `"UTC+06:00"` format. When passed, it bypasses the current time zone offset.
-         * @returns Time zone name in full descriptive string or UTC offset if it is not a valid time zone.
-         *
          * @remarks
          * - This method uses a predefined mapping of UTC offsets to abbreviated time zone codes.
          * - If multiple time zones share the same UTC offset, it returns the **first abbreviation** from the list.
@@ -58,8 +55,20 @@ declare module '../Chronos' {
          * - If no match is found (for unlisted or fictional utc offset), it returns the UTC offset (e.g. `"UTC+06:00"`).
          * - To retrieve the local system's native time zone name (or its identifier if the name is unavailable), use the {@link $getNativeTimeZone} instance method.
          * - To retrieve the local system's native time zone identifier, use the {@link $getNativeTimeZoneId} instance method.
+         *
+         * @param utc Optional UTC offset in `"UTC+06:00"` format. When passed, it bypasses the current time zone offset.
+         * @returns Time zone name in full descriptive string or UTC offset if it is not a valid time zone.
          */
         getTimeZoneNameShort(utc?: UTCOffset): LooseLiteral<TimeZone | UTCOffset>;
+        /**
+         * @instance Returns the current time zone abbreviation (e.g. `"BST"` for `Bangladesh Standard Time`).
+         *
+         * @remarks This method is an alias for {@link getTimeZoneNameShort}.
+         *
+         * @param utc Optional UTC offset in `"UTC+06:00"` format. When passed, it bypasses the current time zone offset.
+         * @returns Time zone name in full descriptive string or UTC offset if it is not a valid time zone.
+         */
+        getTimeZoneNameAbbr(utc?: UTCOffset): LooseLiteral<TimeZone | UTCOffset>;
     }
 }
 /** * Plugin to inject `timeZone` related methods */

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

@@ -249,7 +249,7 @@ export declare const TIME_ZONES: Readonly<{
         readonly offset: "UTC+07:00";
     };
     readonly DDUT: {
-        readonly tzName: "Dumont d'Urville Time (in French Antarctic Station)";
+        readonly tzName: "Dumont d'Urville Time (Antarctic Station in French)";
         readonly offset: "UTC+10:00";
     };
     readonly DFT: {
@@ -397,7 +397,7 @@ export declare const TIME_ZONES: Readonly<{
         readonly offset: "UTC+07:00";
     };
     readonly IDLW: {
-        readonly tzName: "International Date Line West time zone";
+        readonly tzName: "International Date Line West";
         readonly offset: "UTC-12:00";
     };
     readonly IDT: {
@@ -891,7 +891,7 @@ export declare const TIME_ZONE_LABELS: Readonly<{
     readonly 'UTC+10:30': "Lord Howe Standard Time";
     readonly 'UTC+11:00': "Central Pacific Standard Time";
     readonly 'UTC+12:00': "New Zealand Standard Time";
-    readonly 'UTC+12:45': "Chatham Islands Time";
+    readonly 'UTC+12:45': "Chatham Standard Time";
     readonly 'UTC+13:00': "Phoenix Island Time";
     readonly 'UTC+14:00': "Line Islands Time";
 }>;

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

@@ -214,6 +214,7 @@ export type ChronosMethods = $InstanceMethods | $StaticMethods | $PluginMethods;
 export type ChronosInput = number | string | Date | Chronos;
 /** Represents key of `ChronosStatics` (each static method and property) */
 export type ChronosStaticKey = keyof ChronosStatics;
+/** Key of {@link TIME_ZONE_LABELS} ({@link UTCOffset}) */
 export type $TZLabelKey = keyof typeof TIME_ZONE_LABELS;
 /** Abbreviated time-zone names (from {@link https://en.wikipedia.org/wiki/List_of_time_zone_abbreviations time zone abbreviations on Wikipedia}) */
 export type TimeZone = keyof typeof TIME_ZONES;

package/dist/esm/date/Chronos.js

@@ -281,7 +281,7 @@ export class Chronos {
         return this.getTimeStamp();
     }
     clone() {
-        return new _a(this.#date).#withOrigin(this.#ORIGIN);
+        return new _a(this.#date).#withOrigin(this.#ORIGIN, this.#offset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     }
     toDate() {
         switch (this.#ORIGIN) {

package/dist/esm/date/plugins/timeZonePlugin.js

@@ -4,6 +4,13 @@ import { TIME_ZONES, TIME_ZONE_IDS, TIME_ZONE_LABELS } from '../timezone.js';
 import { extractMinutesFromUTC } from '../utils.js';
 export const timeZonePlugin = (ChronosClass) => {
     const { internalDate: $Date, withOrigin } = ChronosClass[INTERNALS];
+    const _isGMT = (factor) => {
+        return factor === 'UTC+00:00' || factor === 'UTC-00:00';
+    };
+    const TZ_NAME_ABBR_MAP = new Map(Object.entries(TIME_ZONES).map(([tzAbbr, { offset, tzName }]) => [
+        offset,
+        { tzAbbr, tzName },
+    ]));
     const _isLabelKey = (offset) => {
         return offset in TIME_ZONE_LABELS;
     };
@@ -14,8 +21,14 @@ export const timeZonePlugin = (ChronosClass) => {
         return undefined;
     };
     const _getTimeZoneName = (zone) => {
+        if (_isGMT(zone))
+            return 'Greenwich Mean Time';
         if (isValidUTCOffset(zone)) {
-            return _resolveTzName(zone);
+            const tzName = _resolveTzName(zone);
+            if (!tzName && TZ_NAME_ABBR_MAP.has(zone)) {
+                return TZ_NAME_ABBR_MAP.get(zone)?.tzName;
+            }
+            return tzName;
         }
         else if (isValidTimeZoneId(zone)) {
             const record = TIME_ZONE_IDS[zone];
@@ -24,17 +37,17 @@ export const timeZonePlugin = (ChronosClass) => {
         else {
             return zone in TIME_ZONES ?
                 TIME_ZONES[zone].tzName
-                : _resolveTzName(TIME_ZONES[zone].offset);
+                : _resolveTzName(TIME_ZONES[zone]?.offset);
         }
     };
-    const TZ_ID_CACHE = new Map(Object.entries(TIME_ZONE_IDS).reduce((acc, [id, { offset }]) => {
+    const TZ_ID_MAP = new Map(Object.entries(TIME_ZONE_IDS).reduce((acc, [id, { offset }]) => {
         const arr = acc.get(offset) ?? [];
         arr.push(id);
         acc.set(offset, arr);
         return acc;
     }, new Map()));
     const _getTimeZoneId = (utc) => {
-        const tzIds = TZ_ID_CACHE.get(utc);
+        const tzIds = TZ_ID_MAP.get(utc);
         if (!tzIds || tzIds?.length === 0)
             return undefined;
         if (tzIds?.length === 1)
@@ -56,51 +69,72 @@ export const timeZonePlugin = (ChronosClass) => {
             offset = zone in TIME_ZONES ? TIME_ZONES[zone].offset : TIME_ZONES['UTC'].offset;
             tzId = _getTimeZoneId(offset) || offset;
         }
-        const tzName = _getTimeZoneName(zone) ?? TIME_ZONES['UTC'].offset;
+        const $zone = zone || offset;
+        const tzName = _getTimeZoneName($zone) ?? offset;
         const targetOffset = extractMinutesFromUTC(offset);
         const previousOffset = this.getTimeZoneOffsetMinutes();
         const relativeOffset = targetOffset - previousOffset;
         const adjustedTime = new Date($Date(this).getTime() + relativeOffset * 60 * 1000);
         const instance = new ChronosClass(adjustedTime);
-        return withOrigin(instance, `timeZone`, offset, tzName, tzId, zone);
+        return withOrigin(instance, `timeZone`, offset, tzName, tzId, $zone);
     };
     ChronosClass.prototype.getTimeZoneName = function (utc) {
         const UTC = utc || this.utcOffset;
         return _getTimeZoneName(utc || this?.$tzTracker || this.utcOffset) ?? UTC;
     };
-    const TZ_SHORT_CACHE = new Map();
+    const TZ_ABBR_CACHE = new Map();
+    const _abbreviate = (name) => {
+        return name
+            .split(/\s+/)
+            .map((w) => w[0])
+            .join('')
+            .replace(/\W/g, '');
+    };
     ChronosClass.prototype.getTimeZoneNameShort = function (utc) {
         const tracker = this?.$tzTracker;
+        const UTC = utc || this.utcOffset;
+        const tzMapKey = utc || tracker || this.utcOffset;
+        if (_isGMT(tzMapKey))
+            return 'GMT';
         if (!utc && tracker && tracker in TIME_ZONES)
             return tracker;
-        const zone = this.getTimeZoneName(utc);
-        if (TZ_SHORT_CACHE.has(zone))
-            return TZ_SHORT_CACHE.get(zone);
-        const customAbbr = isValidUTCOffset(zone) || isValidTimeZoneId(zone) ?
-            zone
-            : zone
-                .split(/\s+/)
-                .map((w) => w?.[0])
-                .join('')
-                .replace(/\W/g, '');
-        TZ_SHORT_CACHE.set(zone, customAbbr);
+        if (isValidUTCOffset(tzMapKey)) {
+            if (TZ_ABBR_CACHE.has(tzMapKey))
+                return TZ_ABBR_CACHE.get(tzMapKey);
+            if (TZ_NAME_ABBR_MAP.has(tzMapKey)) {
+                return TZ_NAME_ABBR_MAP.get(tzMapKey)?.tzAbbr;
+            }
+            const tzName = _resolveTzName(tzMapKey);
+            if (tzName) {
+                const tzAbbr = _abbreviate(tzName);
+                TZ_ABBR_CACHE.set(tzMapKey, tzAbbr);
+                return tzAbbr;
+            }
+        }
+        const zone = _getTimeZoneName(tzMapKey) ?? UTC;
+        if (TZ_ABBR_CACHE.has(`name-${zone}`))
+            return TZ_ABBR_CACHE.get(zone);
+        const customAbbr = isValidUTCOffset(zone) || isValidTimeZoneId(zone) ? zone : _abbreviate(zone);
+        TZ_ABBR_CACHE.set(`name-${zone}`, customAbbr);
         return customAbbr;
     };
+    ChronosClass.prototype.getTimeZoneNameAbbr = function (utc) {
+        return this.getTimeZoneNameShort(utc);
+    };
     ChronosClass.prototype.toString = function () {
         const offset = this.utcOffset;
+        const search = /GMT[+-]\d{4}\s+\([^)]+\)/;
         switch (this.origin) {
             case 'timeZone': {
                 const gmt = offset.replace('UTC', 'GMT').replace(':', '');
                 const label = this.getTimeZoneName();
-                return $Date(this)
-                    .toString()
-                    .replace(/GMT[+-]\d{4}\s+\([^)]+\)/, `${gmt} (${label})`);
+                return $Date(this).toString().replace(search, `${gmt} (${label})`);
             }
             case 'toUTC':
             case 'utc': {
                 return $Date(this)
                     .toString()
-                    .replace(/GMT[+-]\d{4}\s+\([^)]+\)/, `GMT+0000 (Coordinated Universal Time)`);
+                    .replace(search, `GMT+0000 (Coordinated Universal Time)`);
             }
             default:
                 return $Date(this).toString();

package/dist/esm/date/timezone.js

@@ -248,7 +248,7 @@ export const TIME_ZONES = Object.freeze({
         offset: 'UTC+07:00',
     },
     DDUT: {
-        tzName: "Dumont d'Urville Time (in French Antarctic Station)",
+        tzName: "Dumont d'Urville Time (Antarctic Station in French)",
         offset: 'UTC+10:00',
     },
     DFT: {
@@ -396,7 +396,7 @@ export const TIME_ZONES = Object.freeze({
         offset: 'UTC+07:00',
     },
     IDLW: {
-        tzName: 'International Date Line West time zone',
+        tzName: 'International Date Line West',
         offset: 'UTC-12:00',
     },
     IDT: {
@@ -889,7 +889,7 @@ export const TIME_ZONE_LABELS = Object.freeze({
     'UTC+10:30': 'Lord Howe Standard Time',
     'UTC+11:00': 'Central Pacific Standard Time',
     'UTC+12:00': 'New Zealand Standard Time',
-    'UTC+12:45': 'Chatham Islands Time',
+    'UTC+12:45': 'Chatham Standard Time',
     'UTC+13:00': 'Phoenix Island Time',
     'UTC+14:00': 'Line Islands Time',
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.26.21",
+  "version": "4.26.30",
   "description": "A versatile collection of smart, efficient, and reusable utility functions, classes and types for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -42,8 +42,8 @@
     "@eslint/js": "^9.39.1",
     "@types/jest": "^30.0.0",
     "@types/node": "^24.10.0",
-    "@typescript-eslint/eslint-plugin": "^8.46.3",
-    "@typescript-eslint/parser": "^8.46.3",
+    "@typescript-eslint/eslint-plugin": "^8.46.4",
+    "@typescript-eslint/parser": "^8.46.4",
     "eslint": "^9.39.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
@@ -56,7 +56,7 @@
     "ts-jest": "^29.4.5",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.46.3"
+    "typescript-eslint": "^8.46.4"
   },
   "keywords": [
     "toolbox",