nhb-toolbox 4.26.44 → 4.26.46-beta.1

package/CHANGELOG.md

@@ -6,9 +6,13 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.26.45] - 2025-11-13
+
+- **Removed** *time zone id* `'Factory'` from `TIME_ZONE_IDS` and **replaced** `'EDT'` with `'EST5EDT'` to fix the *issue with getting time zone details* using `Intl` API.
+
 ## [4.26.44] - 2025-11-13
 
-- **Fixed** issues with passing optional *time zone id* in `Chronos` method `$getNativeTimeZoneName` and `getTimeZoneDetails` utility
+- **Fixed** issues with passing optional *time zone id* in `Chronos` method `$getNativeTimeZoneName` and `getTimeZoneDetails` utility.
 
 ## [4.26.41] - 2025-11-12
 

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

@@ -10,6 +10,25 @@ const timeZonePlugin = (ChronosClass) => {
     const _isGMT = (factor) => {
         return factor === 'UTC+00:00' || factor === 'UTC-00:00';
     };
+    const _getTimeZoneDetails = (tzId, date) => {
+        const TZ_NAME_TYPES = ['long', 'longOffset'];
+        const obj = { tzId };
+        for (const type of TZ_NAME_TYPES) {
+            const parts = new Intl.DateTimeFormat('en', {
+                timeZone: tzId,
+                timeZoneName: type,
+            }).formatToParts(date);
+            const tzPart = parts.find((p) => p.type === 'timeZoneName');
+            const key = type === 'long' ? 'tzName' : 'offset';
+            const value = type === 'longOffset' ?
+                tzPart?.value === 'GMT' ?
+                    'UTC+00:00'
+                    : tzPart?.value?.replace(/^GMT/, 'UTC')
+                : tzPart?.value;
+            obj[key] = value;
+        }
+        return obj;
+    };
     const TZ_NAME_ABBR_MAP = new Map(Object.entries(timezone_1.TIME_ZONES).map(([tzAbbr, { offset, tzName }]) => [
         offset,
         { tzAbbr, tzName },
@@ -17,6 +36,9 @@ const timeZonePlugin = (ChronosClass) => {
     const _isLabelKey = (offset) => {
         return offset in timezone_1.TIME_ZONE_LABELS;
     };
+    const _isValidTzAbbr = (tz) => {
+        return tz in timezone_1.TIME_ZONES;
+    };
     const _resolveTzName = (offset) => {
         if (_isLabelKey(offset)) {
             return timezone_1.TIME_ZONE_LABELS[offset];
@@ -33,21 +55,16 @@ const timeZonePlugin = (ChronosClass) => {
             }
             return tzName;
         }
-        else if ((0, guards_1.isValidTimeZoneId)(zone)) {
-            const { offset, tzName } = timezone_1.TIME_ZONE_IDS[zone];
-            const { tzNameLongOffset, tzNameLong } = (0, utils_1.getTimeZoneDetails)(zone, date);
-            const convertedOffset = tzNameLongOffset?.replace(/^GMT/, 'UTC') ?? '';
-            const resolvedName = _resolveTzName(offset);
-            const priorityName = convertedOffset === offset ? tzNameLong : resolvedName;
-            return tzName || priorityName || resolvedName || tzNameLong;
+        else if (_isValidTzAbbr(zone)) {
+            return timezone_1.TIME_ZONES[zone].tzName;
         }
         else {
-            return zone in timezone_1.TIME_ZONES ?
-                timezone_1.TIME_ZONES[zone].tzName
-                : _resolveTzName(timezone_1.TIME_ZONES[zone]?.offset);
+            const { offset, tzName } = _getTimeZoneDetails(zone, date);
+            return tzName || _resolveTzName(offset);
         }
     };
-    const TZ_ID_MAP = new Map(Object.entries(timezone_1.TIME_ZONE_IDS).reduce((acc, [id, { offset }]) => {
+    const TZ_ID_MAP = new Map(Intl.supportedValuesOf('timeZone').reduce((acc, id) => {
+        const { offset } = _getTimeZoneDetails(id);
         const arr = acc.get(offset) ?? [];
         arr.push(id);
         acc.set(offset, arr);
@@ -68,13 +85,13 @@ const timeZonePlugin = (ChronosClass) => {
             offset = zone;
             tzId = _getTimeZoneId(offset) || offset;
         }
-        else if ((0, guards_1.isValidTimeZoneId)(zone)) {
-            offset = timezone_1.TIME_ZONE_IDS[zone].offset;
-            tzId = zone;
+        else if (_isValidTzAbbr(zone)) {
+            offset = timezone_1.TIME_ZONES[zone].offset;
+            tzId = _getTimeZoneId(offset) || offset;
         }
         else {
-            offset = zone in timezone_1.TIME_ZONES ? timezone_1.TIME_ZONES[zone].offset : timezone_1.TIME_ZONES['UTC'].offset;
-            tzId = _getTimeZoneId(offset) || offset;
+            offset = _getTimeZoneDetails(zone, $Date(this)).offset;
+            tzId = zone;
         }
         const $zone = zone || offset;
         const tzName = _getTimeZoneName($zone, $Date(this)) ?? offset;
@@ -121,7 +138,7 @@ const timeZonePlugin = (ChronosClass) => {
         const zone = _getTimeZoneName(tzMapKey, $Date(this)) ?? 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);
+        const customAbbr = (0, guards_1.isValidUTCOffset)(zone) ? zone : _abbreviate(zone);
         TZ_ABBR_CACHE.set(`name-${zone}`, customAbbr);
         return customAbbr;
     };

package/dist/cjs/date/timezone.js

@@ -2461,9 +2461,9 @@ exports.TIME_ZONE_IDS = /* @__PURE__ */ Object.freeze({
         tzName: 'Eastern Standard Time',
         offset: 'UTC-05:00',
     },
-    EDT: {
-        tzName: 'Eastern Daylight Time',
-        offset: 'UTC-04:00',
+    EST5EDT: {
+        tzName: 'Eastern Standard Tim',
+        offset: 'UTC-05:00',
     },
     'Etc/GMT': {
         tzName: 'Greenwich Mean Time',
@@ -2861,10 +2861,6 @@ exports.TIME_ZONE_IDS = /* @__PURE__ */ Object.freeze({
         tzName: 'Central European Time',
         offset: 'UTC+01:00',
     },
-    Factory: {
-        tzName: undefined,
-        offset: 'UTC+00:00',
-    },
     GB: {
         tzName: 'Greenwich Mean Time',
         offset: 'UTC+00:00',

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

@@ -849,7 +849,7 @@ export declare const TIME_ZONES: Readonly<{
         readonly offset: "UTC+05:00";
     };
 }>;
-/** Record of unique standard time-zone labels/names for their corresponding UTC offsets as (`{ UTCOffset: timeZoneName }`). */
+/** Record of unique standard time-zone labels/names for their corresponding UTC offsets as (`{ utcOffset: timeZoneName }`). */
 export declare const TIME_ZONE_LABELS: Readonly<{
     readonly 'UTC-12:00': "Baker Island Time";
     readonly 'UTC-11:00': "Samoa Standard Time";
@@ -895,7 +895,7 @@ export declare const TIME_ZONE_LABELS: Readonly<{
     readonly 'UTC+13:00': "Phoenix Island Time";
     readonly 'UTC+14:00': "Line Islands Time";
 }>;
-/** Record of timezone identifiers (from {@link https://en.wikipedia.org/wiki/List_of_tz_database_time_zones IANA TZ Database on Wikipedia}) against their corresponding UTC offsets and full timezone names. */
+/** Record of 597 timezone identifiers (from {@link https://en.wikipedia.org/wiki/List_of_tz_database_time_zones IANA TZ Database on Wikipedia}) against their corresponding UTC offsets and full timezone names. */
 export declare const TIME_ZONE_IDS: Readonly<{
     readonly 'Africa/Abidjan': {
         readonly tzName: "Greenwich Mean Time";
@@ -2461,9 +2461,9 @@ export declare const TIME_ZONE_IDS: Readonly<{
         readonly tzName: "Eastern Standard Time";
         readonly offset: "UTC-05:00";
     };
-    readonly EDT: {
-        readonly tzName: "Eastern Daylight Time";
-        readonly offset: "UTC-04:00";
+    readonly EST5EDT: {
+        readonly tzName: "Eastern Standard Tim";
+        readonly offset: "UTC-05:00";
     };
     readonly 'Etc/GMT': {
         readonly tzName: "Greenwich Mean Time";
@@ -2861,10 +2861,6 @@ export declare const TIME_ZONE_IDS: Readonly<{
         readonly tzName: "Central European Time";
         readonly offset: "UTC+01:00";
     };
-    readonly Factory: {
-        readonly tzName: undefined;
-        readonly offset: "UTC+00:00";
-    };
     readonly GB: {
         readonly tzName: "Greenwich Mean Time";
         readonly offset: "UTC+00:00";

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

@@ -1,12 +1,31 @@
 import { INTERNALS } from '../constants.js';
-import { isValidTimeZoneId, isValidUTCOffset } from '../guards.js';
-import { TIME_ZONES, TIME_ZONE_IDS, TIME_ZONE_LABELS } from '../timezone.js';
-import { getTimeZoneDetails, extractMinutesFromUTC } from '../utils.js';
+import { isValidUTCOffset } from '../guards.js';
+import { TIME_ZONES, 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 _getTimeZoneDetails = (tzId, date) => {
+        const TZ_NAME_TYPES = ['long', 'longOffset'];
+        const obj = { tzId };
+        for (const type of TZ_NAME_TYPES) {
+            const parts = new Intl.DateTimeFormat('en', {
+                timeZone: tzId,
+                timeZoneName: type,
+            }).formatToParts(date);
+            const tzPart = parts.find((p) => p.type === 'timeZoneName');
+            const key = type === 'long' ? 'tzName' : 'offset';
+            const value = type === 'longOffset' ?
+                tzPart?.value === 'GMT' ?
+                    'UTC+00:00'
+                    : tzPart?.value?.replace(/^GMT/, 'UTC')
+                : tzPart?.value;
+            obj[key] = value;
+        }
+        return obj;
+    };
     const TZ_NAME_ABBR_MAP = new Map(Object.entries(TIME_ZONES).map(([tzAbbr, { offset, tzName }]) => [
         offset,
         { tzAbbr, tzName },
@@ -14,6 +33,9 @@ export const timeZonePlugin = (ChronosClass) => {
     const _isLabelKey = (offset) => {
         return offset in TIME_ZONE_LABELS;
     };
+    const _isValidTzAbbr = (tz) => {
+        return tz in TIME_ZONES;
+    };
     const _resolveTzName = (offset) => {
         if (_isLabelKey(offset)) {
             return TIME_ZONE_LABELS[offset];
@@ -30,21 +52,16 @@ export const timeZonePlugin = (ChronosClass) => {
             }
             return tzName;
         }
-        else if (isValidTimeZoneId(zone)) {
-            const { offset, tzName } = TIME_ZONE_IDS[zone];
-            const { tzNameLongOffset, tzNameLong } = getTimeZoneDetails(zone, date);
-            const convertedOffset = tzNameLongOffset?.replace(/^GMT/, 'UTC') ?? '';
-            const resolvedName = _resolveTzName(offset);
-            const priorityName = convertedOffset === offset ? tzNameLong : resolvedName;
-            return tzName || priorityName || resolvedName || tzNameLong;
+        else if (_isValidTzAbbr(zone)) {
+            return TIME_ZONES[zone].tzName;
         }
         else {
-            return zone in TIME_ZONES ?
-                TIME_ZONES[zone].tzName
-                : _resolveTzName(TIME_ZONES[zone]?.offset);
+            const { offset, tzName } = _getTimeZoneDetails(zone, date);
+            return tzName || _resolveTzName(offset);
         }
     };
-    const TZ_ID_MAP = new Map(Object.entries(TIME_ZONE_IDS).reduce((acc, [id, { offset }]) => {
+    const TZ_ID_MAP = new Map(Intl.supportedValuesOf('timeZone').reduce((acc, id) => {
+        const { offset } = _getTimeZoneDetails(id);
         const arr = acc.get(offset) ?? [];
         arr.push(id);
         acc.set(offset, arr);
@@ -65,13 +82,13 @@ export const timeZonePlugin = (ChronosClass) => {
             offset = zone;
             tzId = _getTimeZoneId(offset) || offset;
         }
-        else if (isValidTimeZoneId(zone)) {
-            offset = TIME_ZONE_IDS[zone].offset;
-            tzId = zone;
+        else if (_isValidTzAbbr(zone)) {
+            offset = TIME_ZONES[zone].offset;
+            tzId = _getTimeZoneId(offset) || offset;
         }
         else {
-            offset = zone in TIME_ZONES ? TIME_ZONES[zone].offset : TIME_ZONES['UTC'].offset;
-            tzId = _getTimeZoneId(offset) || offset;
+            offset = _getTimeZoneDetails(zone, $Date(this)).offset;
+            tzId = zone;
         }
         const $zone = zone || offset;
         const tzName = _getTimeZoneName($zone, $Date(this)) ?? offset;
@@ -118,7 +135,7 @@ export const timeZonePlugin = (ChronosClass) => {
         const zone = _getTimeZoneName(tzMapKey, $Date(this)) ?? UTC;
         if (TZ_ABBR_CACHE.has(`name-${zone}`))
             return TZ_ABBR_CACHE.get(zone);
-        const customAbbr = isValidUTCOffset(zone) || isValidTimeZoneId(zone) ? zone : _abbreviate(zone);
+        const customAbbr = isValidUTCOffset(zone) ? zone : _abbreviate(zone);
         TZ_ABBR_CACHE.set(`name-${zone}`, customAbbr);
         return customAbbr;
     };

package/dist/esm/date/timezone.js

@@ -2458,9 +2458,9 @@ export const TIME_ZONE_IDS = /* @__PURE__ */ Object.freeze({
         tzName: 'Eastern Standard Time',
         offset: 'UTC-05:00',
     },
-    EDT: {
-        tzName: 'Eastern Daylight Time',
-        offset: 'UTC-04:00',
+    EST5EDT: {
+        tzName: 'Eastern Standard Tim',
+        offset: 'UTC-05:00',
     },
     'Etc/GMT': {
         tzName: 'Greenwich Mean Time',
@@ -2858,10 +2858,6 @@ export const TIME_ZONE_IDS = /* @__PURE__ */ Object.freeze({
         tzName: 'Central European Time',
         offset: 'UTC+01:00',
     },
-    Factory: {
-        tzName: undefined,
-        offset: 'UTC+00:00',
-    },
     GB: {
         tzName: 'Greenwich Mean Time',
         offset: 'UTC+00:00',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.26.44",
+  "version": "4.26.46-beta.1",
   "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",