nhb-toolbox 4.13.7 → 4.13.9

package/CHANGELOG.md

@@ -6,6 +6,11 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.13.9] - 2025-07-31
+
+- **Added** new `Chronos` method `getTimeZoneName()` to get full time-zone name.
+- **Added** new `Chronos` `timeZonePlugin` method `getTimeZoneNameShort()` to get abbreviated time-zone name.
+
 ## [4.13.7] - 2025-07-23
 
 - **Updated** `isPlural` and `isSingular` methods in `Pluralizer` class to handle more cases.

package/dist/cjs/date/Chronos.js

@@ -1076,6 +1076,17 @@ class Chronos {
     getTimeZoneOffsetMinutes() {
         return (0, utils_1.extractMinutesFromUTC)(this.#offset);
     }
+    /**
+     * @instance Returns the current time zone name as a full descriptive string (e.g. `"Bangladesh Standard Time"`).
+     * @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"`).
+     */
+    getTimeZoneName() {
+        const UTC = `UTC${this.getTimeZoneOffset()}`;
+        return constants_1.TIME_ZONE_LABELS?.[UTC] ?? UTC;
+    }
     /** @instance Returns new Chronos instance in UTC */
     toUTC() {
         if (this.#offset === 'UTC+00:00') {

package/dist/cjs/date/constants.js

@@ -206,7 +206,7 @@ exports.TIME_ZONES = Object.freeze({
     /** Israel Standard Time */
     'IST-ISRAEL': 2 * 60,
     /** Israel Daylight Time (DST) */
-    'IST-IL': 2 * 60,
+    'IST-DST': 3 * 60,
     /** Eastern European Summer Time */
     EEST: 3 * 60,
     /** Moscow Time (Russia-West) */

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

@@ -14,7 +14,7 @@ const timeZonePlugin = (ChronosClass) => {
             stringOffset = zone;
         }
         else {
-            targetOffset = constants_1.TIME_ZONES[zone] ?? constants_1.TIME_ZONES['UTC'];
+            targetOffset = constants_1.TIME_ZONES?.[zone] ?? constants_1.TIME_ZONES['UTC'];
             stringOffset = (0, utils_1.formatUTCOffset)(targetOffset);
         }
         const previousOffset = this.getTimeZoneOffsetMinutes();
@@ -24,5 +24,21 @@ const timeZonePlugin = (ChronosClass) => {
         const instance = new ChronosClass(adjustedTime);
         return ChronosClass[constants_1.INTERNALS].withOrigin(instance, 'timeZone', stringOffset);
     };
+    ChronosClass.prototype.getTimeZoneNameShort = function () {
+        const mins = this.getTimeZoneOffsetMinutes();
+        const UTC = (0, utils_1.formatUTCOffset)(mins);
+        const timeZone = constants_1.TIME_ZONE_LABELS?.[UTC];
+        let result = timeZone
+            ?.split(' ')
+            ?.filter(Boolean)
+            ?.map((part) => part?.charAt(0))
+            ?.join('')
+            ?.replace(/\W/g, '');
+        if (!result) {
+            const zones = Object.entries(constants_1.TIME_ZONES);
+            result = zones.find((zone) => zone?.[1] === mins)?.[0];
+        }
+        return result ?? (0, utils_1.formatUTCOffset)(mins);
+    };
 };
 exports.timeZonePlugin = timeZonePlugin;

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

@@ -492,6 +492,14 @@ export declare class Chronos {
      * @returns The UTC offset in minutes maintaining the current timezone regardless of system having different one.
      */
     getTimeZoneOffsetMinutes(): number;
+    /**
+     * @instance Returns the current time zone name as a full descriptive string (e.g. `"Bangladesh Standard Time"`).
+     * @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"`).
+     */
+    getTimeZoneName(): string;
     /** @instance Returns new Chronos instance in UTC */
     toUTC(): Chronos;
     /** @instance Returns new Chronos instance in local time */

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

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

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

@@ -137,7 +137,7 @@ export declare const TIME_ZONES: Readonly<{
     /** Israel Standard Time */
     readonly 'IST-ISRAEL': number;
     /** Israel Daylight Time (DST) */
-    readonly 'IST-IL': number;
+    readonly 'IST-DST': number;
     /** Eastern European Summer Time */
     readonly EEST: number;
     /** Moscow Time (Russia-West) */

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

@@ -10,6 +10,14 @@ declare module '../Chronos' {
          * @returns A new instance of `Chronos` with time in the given timezone. Invalid input sets time-zone to `UTC`.
          */
         timeZone(zone: TimeZone | UTCOffSet): ChronosConstructor;
+        /**
+         * @instance Returns the current time zone abbreviation (e.g. `"BST"` for `Bangladesh Standard Time`).
+         * @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.
+         * - If no match is found (which is rare), it returns the UTC offset (e.g. `"UTC+06:00"`).
+         */
+        getTimeZoneNameShort(): TimeZone | UTCOffSet;
     }
 }
 /** * Plugin to inject `timeZone` method */

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

@@ -1 +1 @@
-{"version":3,"file":"timeZonePlugin.d.ts","sourceRoot":"","sources":["../../../../src/date/plugins/timeZonePlugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGpD,KAAK,kBAAkB,GAAG,OAAO,YAAY,EAAE,OAAO,CAAC;AACvD,KAAK,WAAW,GAAG,cAAc,YAAY,EAAE,OAAO,CAAC;AAEvD,OAAO,QAAQ,YAAY,CAAC;IAC3B,UAAU,OAAO;QAChB;;;;;WAKG;QACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,kBAAkB,CAAC;KACzD;CACD;AAED,2CAA2C;AAC3C,eAAO,MAAM,cAAc,GAAI,cAAc,WAAW,KAAG,IAgC1D,CAAC"}
+{"version":3,"file":"timeZonePlugin.d.ts","sourceRoot":"","sources":["../../../../src/date/plugins/timeZonePlugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGpD,KAAK,kBAAkB,GAAG,OAAO,YAAY,EAAE,OAAO,CAAC;AACvD,KAAK,WAAW,GAAG,cAAc,YAAY,EAAE,OAAO,CAAC;AAEvD,OAAO,QAAQ,YAAY,CAAC;IAC3B,UAAU,OAAO;QAChB;;;;;WAKG;QACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,kBAAkB,CAAC;QAEzD;;;;;;WAMG;QACH,oBAAoB,IAAI,QAAQ,GAAG,SAAS,CAAC;KAC7C;CACD;AAED,2CAA2C;AAC3C,eAAO,MAAM,cAAc,GAAI,cAAc,WAAW,KAAG,IA2D1D,CAAC"}

package/dist/esm/date/Chronos.js

@@ -1073,6 +1073,17 @@ export class Chronos {
     getTimeZoneOffsetMinutes() {
         return extractMinutesFromUTC(this.#offset);
     }
+    /**
+     * @instance Returns the current time zone name as a full descriptive string (e.g. `"Bangladesh Standard Time"`).
+     * @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"`).
+     */
+    getTimeZoneName() {
+        const UTC = `UTC${this.getTimeZoneOffset()}`;
+        return TIME_ZONE_LABELS?.[UTC] ?? UTC;
+    }
     /** @instance Returns new Chronos instance in UTC */
     toUTC() {
         if (this.#offset === 'UTC+00:00') {

package/dist/esm/date/constants.js

@@ -203,7 +203,7 @@ export const TIME_ZONES = /* @__PURE__ */ Object.freeze({
     /** Israel Standard Time */
     'IST-ISRAEL': 2 * 60,
     /** Israel Daylight Time (DST) */
-    'IST-IL': 2 * 60,
+    'IST-DST': 3 * 60,
     /** Eastern European Summer Time */
     EEST: 3 * 60,
     /** Moscow Time (Russia-West) */

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

@@ -1,4 +1,4 @@
-import { INTERNALS, TIME_ZONES } from '../constants.js';
+import { INTERNALS, TIME_ZONE_LABELS, TIME_ZONES } from '../constants.js';
 import { isValidUTCOffSet } from '../guards.js';
 import { extractMinutesFromUTC, formatUTCOffset } from '../utils.js';
 /** * Plugin to inject `timeZone` method */
@@ -11,7 +11,7 @@ export const timeZonePlugin = (ChronosClass) => {
             stringOffset = zone;
         }
         else {
-            targetOffset = TIME_ZONES[zone] ?? TIME_ZONES['UTC'];
+            targetOffset = TIME_ZONES?.[zone] ?? TIME_ZONES['UTC'];
             stringOffset = formatUTCOffset(targetOffset);
         }
         const previousOffset = this.getTimeZoneOffsetMinutes();
@@ -21,4 +21,20 @@ export const timeZonePlugin = (ChronosClass) => {
         const instance = new ChronosClass(adjustedTime);
         return ChronosClass[INTERNALS].withOrigin(instance, 'timeZone', stringOffset);
     };
+    ChronosClass.prototype.getTimeZoneNameShort = function () {
+        const mins = this.getTimeZoneOffsetMinutes();
+        const UTC = formatUTCOffset(mins);
+        const timeZone = TIME_ZONE_LABELS?.[UTC];
+        let result = timeZone
+            ?.split(' ')
+            ?.filter(Boolean)
+            ?.map((part) => part?.charAt(0))
+            ?.join('')
+            ?.replace(/\W/g, '');
+        if (!result) {
+            const zones = Object.entries(TIME_ZONES);
+            result = zones.find((zone) => zone?.[1] === mins)?.[0];
+        }
+        return result ?? formatUTCOffset(mins);
+    };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.13.7",
+  "version": "4.13.9",
   "description": "A versatile collection of smart, efficient, and reusable utility functions and classes for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -48,7 +48,7 @@
     "eslint-plugin-prettier": "^5.4.1",
     "globals": "^16.2.0",
     "jest": "^29.7.0",
-    "nhb-scripts": "^1.8.6",
+    "nhb-scripts": "^1.8.23",
     "prettier": "^3.5.3",
     "ts-jest": "^29.3.4",
     "typescript": "^5.8.3",
@@ -250,6 +250,7 @@
     "build": "nhb-build",
     "commit": "nhb-commit",
     "module": "nhb-module",
-    "count": "nhb-count"
+    "count": "nhb-count",
+    "delete": "nhb-delete"
   }
 }