nhb-toolbox 4.26.20 → 4.26.30

package/CHANGELOG.md

@@ -6,6 +6,27 @@ 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
+
+### 🕧 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
 
 ### 🕧 Updates in Chronos

package/dist/cjs/date/Chronos.js

@@ -81,9 +81,9 @@ class Chronos {
             case 'timeZone':
             case 'toUTC':
             case 'utc':
-                return string.replace(this.#isoTzRemoved(), replacement);
+                return string.replace(this.#removeUTCFromISO(), replacement);
             default:
-                return string.replace(this.#isoTzRemoved(true), replacement);
+                return string.replace(this.#removeUTCFromISO(true), replacement);
         }
     }
     [Symbol.search](string) {
@@ -91,9 +91,9 @@ class Chronos {
             case 'timeZone':
             case 'toUTC':
             case 'utc':
-                return string.indexOf(this.#isoTzRemoved());
+                return string.indexOf(this.#removeUTCFromISO());
             default:
-                return string.indexOf(this.#isoTzRemoved(true));
+                return string.indexOf(this.#removeUTCFromISO(true));
         }
     }
     [Symbol.split](string) {
@@ -101,9 +101,9 @@ class Chronos {
             case 'timeZone':
             case 'toUTC':
             case 'utc':
-                return string.split(this.#isoTzRemoved());
+                return string.split(this.#removeUTCFromISO());
             default:
-                return string.split(this.#isoTzRemoved(true));
+                return string.split(this.#removeUTCFromISO(true));
         }
     }
     [Symbol.match](string) {
@@ -229,7 +229,7 @@ class Chronos {
         const pad = (n, p = 2) => String(n).padStart(p, '0');
         return `${this.year}-${pad(this.month + 1)}-${pad(this.date)}T${pad(this.hour)}:${pad(this.minute)}:${pad(this.second)}.${pad(this.millisecond, 3)}${this.getUTCOffset()}`;
     }
-    #isoTzRemoved(local = false) {
+    #removeUTCFromISO(local = false) {
         return local ?
             this.toLocalISOString().replace(/\.\d+(Z|[+-]\d{2}:\d{2})?$/, '')
             : this.toISOString().replace(/\.\d+(Z|[+-]\d{2}:\d{2})?$/, '');
@@ -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) {
@@ -449,7 +449,7 @@ class Chronos {
         }
     }
     isDST() {
-        const year = this.#date.getFullYear();
+        const year = this.year;
         const jan = new Date(year, 0, 1).getTimezoneOffset();
         const jul = new Date(year, 6, 1).getTimezoneOffset();
         return this.#date.getTimezoneOffset() < Math.max(jan, jul);
@@ -573,7 +573,7 @@ class Chronos {
                 d.setFullYear(value);
                 break;
             case 'month':
-                d.setMonth(value);
+                d.setMonth(value - 1);
                 break;
             case 'day':
                 d.setDate(value);
@@ -611,11 +611,16 @@ class Chronos {
                 return msDiff / 8.64e7;
             case 'week':
                 return msDiff / 6.048e8;
-            case 'month':
-                return ((this.get('year') - time.get('year')) * 12 +
-                    (this.get('month') - time.get('month')));
+            case 'month': {
+                const yearDiff = this.get('year') - time.get('year');
+                const monthDiff = this.get('month') - time.get('month');
+                const totalMonthDiff = yearDiff * 12 + monthDiff;
+                const dayDiff = this.get('day') - time.get('day');
+                const daysInMonth = new Date(this.get('year'), this.get('month'), 0).getDate();
+                return totalMonthDiff + dayDiff / daysInMonth;
+            }
             case 'year':
-                return this.get('year') - time.get('year');
+                return this.diff(time, 'month') / 12;
         }
     }
     calendar(baseDate) {
@@ -847,7 +852,7 @@ class Chronos {
             return now
                 .startOf('month')
                 .set('year', year ?? now.year)
-                .set('month', month ? month - 1 : now.month).lastDateOfMonth;
+                .set('month', month ?? now.isoMonth).lastDateOfMonth;
         };
         return new _a(year ?? now.year, month ?? now.isoMonth, date ? date
             : now.isLastDayOfMonth() && now.date >= nextLDoM() ? nextLDoM()

package/dist/cjs/date/guards.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isValidTime = isValidTime;
-exports.isValidUTCOffSet = isValidUTCOffSet;
+exports.isValidUTCOffset = isValidUTCOffset;
 exports.isValidTimeZoneId = isValidTimeZoneId;
 exports.isLeapYear = isLeapYear;
 exports.isDateLike = isDateLike;
@@ -19,7 +19,7 @@ function isValidTime(value) {
     const minute = Number(minuteStr);
     return hour >= 0 && hour <= 23 && minute >= 0 && minute <= 59;
 }
-function isValidUTCOffSet(value) {
+function isValidUTCOffset(value) {
     return (0, primitives_1.isString)(value) ? /^UTC[+-]?\d{1,2}:\d{2}$/.test(value) : false;
 }
 function isValidTimeZoneId(value) {

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 ((0, guards_1.isValidUTCOffSet)(zone)) {
-            return _resolveTzName(zone);
+        if (_isGMT(zone))
+            return 'Greenwich Mean Time';
+        if ((0, guards_1.isValidUTCOffset)(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)
@@ -47,7 +60,7 @@ const timeZonePlugin = (ChronosClass) => {
     ChronosClass.prototype.timeZone = function (zone) {
         let offset;
         let tzId;
-        if ((0, guards_1.isValidUTCOffSet)(zone)) {
+        if ((0, guards_1.isValidUTCOffset)(zone)) {
             offset = zone;
             tzId = _getTimeZoneId(offset) || offset;
         }
@@ -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(this?.$tzTracker ?? UTC) ?? UTC;
+        const UTC = utc || this.utcOffset;
+        return _getTimeZoneName(utc || this?.$tzTracker || this.utcOffset) ?? UTC;
+    };
+    const TZ_ABBR_CACHE = new Map();
+    const _abbreviate = (name) => {
+        return name
+            .split(/\s+/)
+            .map((w) => w[0])
+            .join('')
+            .replace(/\W/g, '');
     };
-    const TZ_SHORT_CACHE = new Map();
     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/cjs/index.js

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.convertToDecimal = exports.calculateLCM = exports.calculateLCD = exports.calculateHCF = exports.calculateGCD = exports.calculateFactorial = exports.calculateAverage = exports.verbalizer = exports.Verbalizer = exports.pluralizer = exports.Pluralizer = exports.VolumeConverter = exports.TimeConverter = exports.TemperatureConverter = exports.MassConverter = exports.LengthConverter = exports.DataConverter = exports.converter = exports.Converter = exports.AreaConverter = exports.wordCount = exports.parseNumbersFromText = exports.levenshteinDistance = exports.getLevenshteinDistance = exports.extractNumbersFromString = exports.extractNumbers = exports.countWordsInString = exports.countWords = exports.slugifyString = exports.reverseString = exports.replaceAllInString = exports.normalizeString = exports.maskString = exports.formatWithPlural = exports.formatUnitWithPlural = exports.formatNumberWithPluralUnit = exports.extractURLs = exports.extractEmails = exports.convertStringCase = exports.isSnakeCase = exports.isPascalCase = exports.isPalindrome = exports.isKebabCase = exports.isEmojiOnly = exports.isCamelCase = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
+exports.convertToDecimal = exports.calculateLCM = exports.calculateLCD = exports.calculateHCF = exports.calculateGCD = exports.calculateFactorial = exports.calculateAverage = exports.verbalizer = exports.Verbalizer = exports.pluralizer = exports.Pluralizer = exports.converter = exports.VolumeConverter = exports.TimeConverter = exports.TemperatureConverter = exports.MassConverter = exports.LengthConverter = exports.DataConverter = exports.Converter = exports.AreaConverter = exports.wordCount = exports.parseNumbersFromText = exports.levenshteinDistance = exports.getLevenshteinDistance = exports.extractNumbersFromString = exports.extractNumbers = exports.countWordsInString = exports.countWords = exports.slugifyString = exports.reverseString = exports.replaceAllInString = exports.normalizeString = exports.maskString = exports.formatWithPlural = exports.formatUnitWithPlural = exports.formatNumberWithPluralUnit = exports.extractURLs = exports.extractEmails = exports.convertStringCase = exports.isSnakeCase = exports.isPascalCase = exports.isPalindrome = exports.isKebabCase = exports.isEmojiOnly = exports.isCamelCase = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
 exports.convertRomanToNumeric = exports.convertRomanToInteger = exports.convertRomanToArabic = exports.convertNumberToWordsOrdinal = exports.convertNumberToWords = exports.cardinalWordsToOrdinal = exports.arabicToRoman = exports.isPerfectSquare = exports.isPartOfFibonacciSeries = exports.isPartOfFibonacci = exports.isOddNumber = exports.isOdd = exports.isNumberInvalid = exports.isMultiple = exports.isInvalidNumber = exports.isFibonacci = exports.isEvenNumber = exports.isEven = exports.areNumbersInvalid = exports.areInvalidNumbers = exports.getNthFibonacci = exports.getMemoizedFibonacciSeries = exports.getMemoizedFibonacci = exports.getFibonacciSeriesMemo = exports.getFibonacciSeries = exports.getFibonacciNumbers = exports.getFibonacci = exports.generateFibonacci = exports.fibonacciGenerator = exports.calculatePercentage = exports.UnitConverter = exports.Unit = exports.Currency = exports.sumOfNumbers = exports.sumNumbers = exports.sumDigits = exports.roundToDecimal = exports.roundNumber = exports.reverseNumber = exports.getSumOfNumbers = exports.getRandomNumber = exports.getRandomInt = exports.getFactors = exports.getFactorial = exports.getDivisors = exports.getAverageOfNumbers = exports.getAverage = exports.factorsOf = exports.factorial = exports.convertToFixed = void 0;
-exports.convertHslToHex = exports.convertHslaToRgba = exports.convertHslaToHex8 = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertHex8ToRgba = exports.convertHex8ToHsla = exports.convertColorCode = exports.getRandomHSL = exports.getRandomColor = exports.generateRandomHSLColor = exports.generateRandomHSL = exports.generateRandomColorInHexRGB = exports.generateRandomColor = exports.getColorForInitial = exports.getNumbersInRange = exports.roundToNearestInterval = exports.roundToNearest = exports.roundNumberToNearestInterval = exports.numberToOrdinal = exports.normalizeNumber = exports.getRandomFloat = exports.getRandomDecimal = exports.getOrdinalNumber = exports.getOrdinal = exports.formatCurrency = exports.convertToOrdinal = exports.convertNumberToOrdinal = exports.convertNumberToCurrency = exports.clampNumber = exports.cardinalToOrdinal = exports.isPrimeNumber = exports.isPrime = exports.getPrimeNumbers = exports.findPrimeNumbers = exports.wordToNumber = exports.wordsToNumber = exports.toRomanNumeral = exports.toRoman = exports.romanToNumeric = exports.romanToInteger = exports.romanToArabic = exports.numericToRoman = exports.numberToWordsOrdinal = exports.numberToWords = exports.numberToRoman = exports.integerToRoman = exports.convertWordToNumber = exports.convertWordsToNumber = exports.convertToRomanNumerals = void 0;
-exports.getTimeStringFromUTC = exports.getTimeFromMinutes = exports.getMinutesFromUTC = exports.getHourMinutesFromMinutes = exports.getCurrentTime = exports.getCurrentDateTime = exports.formatUTCOffset = exports.extractTotalMinutesFromTime = exports.extractTimeStringFromUTC = exports.extractTimeFromUTC = exports.extractMinutesFromUTC = exports.extractHourMinute = exports.convertMinutesToUTCOffset = exports.convertMinutesToTime = exports.convertMinutesToHourMinutes = exports.chronusts = exports.chronusjs = exports.chronus = exports.chronosts = exports.chronosjs = exports.chronos = exports.INTERNALS = exports.Chronus = exports.Chronos = exports.isValidTimeZoneId = exports.isValidUTCOffSet = exports.isValidUTC = exports.isValidTimeString = exports.isValidTime = exports.isLeapYear = exports.isDateLike = exports.greet = exports.getGreeting = exports.generateGreeting = exports.extractSolidColorValues = exports.extractAlphaColorValues = exports.Colour = exports.Color = exports.isRGBA = exports.isRGB = exports.isHSLA = exports.isHSL = exports.isHex8 = exports.isHex6 = exports.convertRgbToRgba = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertRgbaToHsla = exports.convertRgbaToHex8 = exports.convertHslToRgb = void 0;
-exports.isFileUpload = exports.isFileOrBlob = exports.isFileList = exports.isFileArray = exports.isCustomFileArray = exports.isCustomFile = exports.serializeForm = exports.parseFormData = exports.createFormData = exports.createControlledFormData = exports.convertIntoFormData = exports.naturalSortForString = exports.naturalSort = exports.compareSorter = exports.compareNaturally = exports.splitArrayByProperty = exports.splitArray = exports.rotateArray = exports.removeDuplicatesFromArray = exports.removeDuplicates = exports.moveArrayElement = exports.groupArrayByProperty = exports.getMissingElements = exports.getDuplicatesFromArray = exports.getDuplicates = exports.findMissingElements = exports.extractMissingElements = exports.extractDuplicatesFromArray = exports.extractDuplicates = exports.createOptionsArray = exports.sortAnArray = exports.Finder = exports.totalDeltaByField = exports.sumFieldDifference = exports.sumByField = exports.groupAndSumByField = exports.groupAndAvgByField = exports.groupAndAverageByField = exports.avgByField = exports.averageByField = exports.shuffleArray = exports.isValidEmptyArray = exports.isInvalidOrEmptyArray = exports.getLastArrayElement = exports.flattenArray = exports.filterArrayOfObjects = exports.minutesToUTCOffset = exports.getTotalMinutesFromUTC = exports.getTotalMinutesFromTime = exports.getTotalMinutes = void 0;
-exports.saveToLocalStorage = exports.removeFromSessionStorage = exports.removeFromLocalStorage = exports.getFromSessionStorage = exports.getFromLocalStorage = exports.toggleFullScreen = exports.smoothScrollTo = exports.copyToClipboard = exports.updateQueryParam = exports.queryStringToObject = exports.parseQueryStringLiteral = exports.parseQueryString = exports.literalQueryStringToObject = exports.getQueryStringAsObject = exports.getQueryParams = exports.generateQueryParams = exports.formatQueryParams = exports.createQueryParams = exports.removeObjectFields = exports.removeFields = exports.remapObjectFields = exports.remapFields = exports.pickObjectFieldsByCondition = exports.pickObjectFields = exports.pickFieldsByCondition = exports.pickFields = exports.omitObjectFields = exports.omitFields = exports.deleteObjectFields = exports.deleteFields = exports.convertObjectValues = exports.sanitizeData = exports.parseStringifiedObjectValues = exports.parseObjectValues = exports.parseJsonToObject = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObjectKeyValue = exports.flattenObjectDotNotation = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.extractObjectKeysDeep = exports.extractObjectKeys = exports.extractKeysDeep = exports.extractKeys = exports.countObjectFields = exports.cloneObject = exports.isValidFormData = exports.isOriginFileObj = void 0;
-exports.isObjectWithKeys = exports.isObjectEmpty = exports.isObject = exports.isNotEmptyObject = exports.isMethodDescriptor = exports.isMethod = exports.isMap = exports.isJSONObject = exports.isJSON = exports.isFunction = exports.isError = exports.isEmptyObjectGuard = exports.isEmptyObject = exports.isDate = exports.isArrayWithLength = exports.isArrayOfType = exports.isArray = exports.doesReturnPromise = exports.isUndefined = exports.isTruthy = exports.isSymbol = exports.isString = exports.isPrimitive = exports.isPositiveInteger = exports.isNumber = exports.isNull = exports.isNormalPrimitive = exports.isNonEmptyString = exports.isInteger = exports.isFalsy = exports.isBoolean = exports.isBigInt = exports.Paginator = exports.throttleAction = exports.parsePrimitivesDeep = exports.parseJsonDeep = exports.parseJSON = exports.joinArrayElements = exports.isDeepEqual = exports.getStaticMethodsCount = exports.getStaticMethodNames = exports.getInstanceMethodsCount = exports.getInstanceMethodNames = exports.getClassDetails = exports.deepParsePrimitives = exports.debounceAction = exports.countStaticMethods = exports.countInstanceMethods = exports.convertArrayToString = exports.saveToSessionStorage = void 0;
-exports.isValidURL = exports.isValidEmail = exports.isUUID = exports.isURL = exports.isPhoneNumber = exports.isNumericString = exports.isNodeEnvironment = exports.isNodeENV = exports.isNode = exports.isIPAddress = exports.isExpectedNodeENV = exports.isEnvironment = exports.isEmailArray = exports.isEmail = exports.isDateString = exports.isBrowser = exports.isBase64 = exports.httpStatus = exports.HttpStatus = exports.isValidSet = exports.isValidObject = exports.isValidMap = exports.isValidJSON = exports.isValidArray = exports.isSet = exports.isReturningPromise = exports.isRegularExpression = exports.isRegExp = exports.isPromise = void 0;
+exports.convertHslaToHex8 = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertHex8ToRgba = exports.convertHex8ToHsla = exports.convertColorCode = exports.getRandomHSL = exports.getRandomColor = exports.generateRandomHSLColor = exports.generateRandomHSL = exports.generateRandomColorInHexRGB = exports.generateRandomColor = exports.getColorForInitial = exports.getNumbersInRange = exports.roundToNearestInterval = exports.roundToNearest = exports.roundNumberToNearestInterval = exports.numberToOrdinal = exports.normalizeNumber = exports.getRandomFloat = exports.getRandomDecimal = exports.getOrdinalNumber = exports.getOrdinal = exports.formatCurrency = exports.convertToOrdinal = exports.convertNumberToOrdinal = exports.convertNumberToCurrency = exports.clampNumber = exports.cardinalToOrdinal = exports.isPrimeNumber = exports.isPrime = exports.getPrimeNumbers = exports.findPrimeNumbers = exports.wordsToNumber = exports.wordToNumber = exports.toRomanNumeral = exports.toRoman = exports.romanToNumeric = exports.romanToInteger = exports.romanToArabic = exports.numericToRoman = exports.numberToWordsOrdinal = exports.numberToWords = exports.numberToRoman = exports.integerToRoman = exports.convertWordsToNumber = exports.convertWordToNumber = exports.convertToRomanNumerals = void 0;
+exports.getTimeFromMinutes = exports.getMinutesFromUTC = exports.getHourMinutesFromMinutes = exports.getCurrentTime = exports.getCurrentDateTime = exports.formatUTCOffset = exports.extractTotalMinutesFromTime = exports.extractTimeStringFromUTC = exports.extractTimeFromUTC = exports.extractMinutesFromUTC = exports.extractHourMinute = exports.convertMinutesToUTCOffset = exports.convertMinutesToTime = exports.convertMinutesToHourMinutes = exports.chronusts = exports.chronusjs = exports.chronus = exports.chronosts = exports.chronosjs = exports.chronos = exports.INTERNALS = exports.Chronus = exports.Chronos = exports.isValidUTCOffSet = exports.isValidUTC = exports.isValidUTCOffset = exports.isValidTimeZoneId = exports.isValidTimeString = exports.isValidTime = exports.isLeapYear = exports.isDateLike = exports.greet = exports.getGreeting = exports.generateGreeting = exports.extractSolidColorValues = exports.extractAlphaColorValues = exports.Colour = exports.Color = exports.isRGBA = exports.isRGB = exports.isHex8 = exports.isHex6 = exports.isHSLA = exports.isHSL = exports.convertRgbaToHsla = exports.convertRgbaToHex8 = exports.convertRgbToRgba = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertHslaToRgba = void 0;
+exports.isFileOrBlob = exports.isFileList = exports.isFileArray = exports.isCustomFileArray = exports.isCustomFile = exports.serializeForm = exports.parseFormData = exports.createFormData = exports.createControlledFormData = exports.convertIntoFormData = exports.naturalSortForString = exports.naturalSort = exports.compareSorter = exports.compareNaturally = exports.splitArrayByProperty = exports.splitArray = exports.rotateArray = exports.removeDuplicatesFromArray = exports.removeDuplicates = exports.moveArrayElement = exports.groupArrayByProperty = exports.getMissingElements = exports.getDuplicatesFromArray = exports.getDuplicates = exports.findMissingElements = exports.extractMissingElements = exports.extractDuplicatesFromArray = exports.extractDuplicates = exports.createOptionsArray = exports.sortAnArray = exports.Finder = exports.totalDeltaByField = exports.sumFieldDifference = exports.sumByField = exports.groupAndSumByField = exports.groupAndAvgByField = exports.groupAndAverageByField = exports.avgByField = exports.averageByField = exports.shuffleArray = exports.isValidEmptyArray = exports.isInvalidOrEmptyArray = exports.getLastArrayElement = exports.flattenArray = exports.filterArrayOfObjects = exports.minutesToUTCOffset = exports.getTotalMinutesFromUTC = exports.getTotalMinutesFromTime = exports.getTotalMinutes = exports.getTimeStringFromUTC = void 0;
+exports.removeFromSessionStorage = exports.removeFromLocalStorage = exports.getFromSessionStorage = exports.getFromLocalStorage = exports.toggleFullScreen = exports.smoothScrollTo = exports.copyToClipboard = exports.updateQueryParam = exports.queryStringToObject = exports.parseQueryStringLiteral = exports.parseQueryString = exports.literalQueryStringToObject = exports.getQueryStringAsObject = exports.getQueryParams = exports.generateQueryParams = exports.formatQueryParams = exports.createQueryParams = exports.removeObjectFields = exports.removeFields = exports.remapObjectFields = exports.remapFields = exports.pickObjectFieldsByCondition = exports.pickObjectFields = exports.pickFieldsByCondition = exports.pickFields = exports.omitObjectFields = exports.omitFields = exports.deleteObjectFields = exports.deleteFields = exports.convertObjectValues = exports.sanitizeData = exports.parseStringifiedObjectValues = exports.parseObjectValues = exports.parseJsonToObject = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObjectKeyValue = exports.flattenObjectDotNotation = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.extractObjectKeysDeep = exports.extractObjectKeys = exports.extractKeysDeep = exports.extractKeys = exports.countObjectFields = exports.cloneObject = exports.isValidFormData = exports.isOriginFileObj = exports.isFileUpload = void 0;
+exports.isObjectEmpty = exports.isObject = exports.isNotEmptyObject = exports.isMethodDescriptor = exports.isMethod = exports.isMap = exports.isJSONObject = exports.isJSON = exports.isFunction = exports.isError = exports.isEmptyObjectGuard = exports.isEmptyObject = exports.isDate = exports.isArrayWithLength = exports.isArrayOfType = exports.isArray = exports.doesReturnPromise = exports.isUndefined = exports.isTruthy = exports.isSymbol = exports.isString = exports.isPrimitive = exports.isPositiveInteger = exports.isNumber = exports.isNull = exports.isNormalPrimitive = exports.isNonEmptyString = exports.isInteger = exports.isFalsy = exports.isBoolean = exports.isBigInt = exports.Paginator = exports.throttleAction = exports.parsePrimitivesDeep = exports.parseJsonDeep = exports.parseJSON = exports.joinArrayElements = exports.isDeepEqual = exports.getStaticMethodsCount = exports.getStaticMethodNames = exports.getInstanceMethodsCount = exports.getInstanceMethodNames = exports.getClassDetails = exports.deepParsePrimitives = exports.debounceAction = exports.countStaticMethods = exports.countInstanceMethods = exports.convertArrayToString = exports.saveToSessionStorage = exports.saveToLocalStorage = void 0;
+exports.isValidURL = exports.isValidEmail = exports.isUUID = exports.isURL = exports.isPhoneNumber = exports.isNumericString = exports.isNodeEnvironment = exports.isNodeENV = exports.isNode = exports.isIPAddress = exports.isExpectedNodeENV = exports.isEnvironment = exports.isEmailArray = exports.isEmail = exports.isDateString = exports.isBrowser = exports.isBase64 = exports.httpStatus = exports.HttpStatus = exports.isValidSet = exports.isValidObject = exports.isValidMap = exports.isValidJSON = exports.isValidArray = exports.isSet = exports.isReturningPromise = exports.isRegularExpression = exports.isRegExp = exports.isPromise = exports.isObjectWithKeys = void 0;
 var basics_1 = require("./string/basics");
 Object.defineProperty(exports, "capitalizeString", { enumerable: true, get: function () { return basics_1.capitalizeString; } });
 Object.defineProperty(exports, "generateRandomID", { enumerable: true, get: function () { return basics_1.generateRandomID; } });
@@ -47,13 +47,13 @@ Object.defineProperty(exports, "wordCount", { enumerable: true, get: function ()
 var Converter_1 = require("./converter/Converter");
 Object.defineProperty(exports, "AreaConverter", { enumerable: true, get: function () { return Converter_1.AreaConverter; } });
 Object.defineProperty(exports, "Converter", { enumerable: true, get: function () { return Converter_1.Converter; } });
-Object.defineProperty(exports, "converter", { enumerable: true, get: function () { return Converter_1.converter; } });
 Object.defineProperty(exports, "DataConverter", { enumerable: true, get: function () { return Converter_1.DataConverter; } });
 Object.defineProperty(exports, "LengthConverter", { enumerable: true, get: function () { return Converter_1.LengthConverter; } });
 Object.defineProperty(exports, "MassConverter", { enumerable: true, get: function () { return Converter_1.MassConverter; } });
 Object.defineProperty(exports, "TemperatureConverter", { enumerable: true, get: function () { return Converter_1.TemperatureConverter; } });
 Object.defineProperty(exports, "TimeConverter", { enumerable: true, get: function () { return Converter_1.TimeConverter; } });
 Object.defineProperty(exports, "VolumeConverter", { enumerable: true, get: function () { return Converter_1.VolumeConverter; } });
+Object.defineProperty(exports, "converter", { enumerable: true, get: function () { return Converter_1.converter; } });
 var Pluralizer_1 = require("./pluralizer/Pluralizer");
 Object.defineProperty(exports, "Pluralizer", { enumerable: true, get: function () { return Pluralizer_1.Pluralizer; } });
 Object.defineProperty(exports, "pluralizer", { enumerable: true, get: function () { return Pluralizer_1.pluralizer; } });
@@ -125,8 +125,8 @@ Object.defineProperty(exports, "convertRomanToArabic", { enumerable: true, get:
 Object.defineProperty(exports, "convertRomanToInteger", { enumerable: true, get: function () { return convert_2.romanToInteger; } });
 Object.defineProperty(exports, "convertRomanToNumeric", { enumerable: true, get: function () { return convert_2.romanToInteger; } });
 Object.defineProperty(exports, "convertToRomanNumerals", { enumerable: true, get: function () { return convert_2.convertToRomanNumerals; } });
-Object.defineProperty(exports, "convertWordsToNumber", { enumerable: true, get: function () { return convert_2.wordsToNumber; } });
 Object.defineProperty(exports, "convertWordToNumber", { enumerable: true, get: function () { return convert_2.wordsToNumber; } });
+Object.defineProperty(exports, "convertWordsToNumber", { enumerable: true, get: function () { return convert_2.wordsToNumber; } });
 Object.defineProperty(exports, "integerToRoman", { enumerable: true, get: function () { return convert_2.convertToRomanNumerals; } });
 Object.defineProperty(exports, "numberToRoman", { enumerable: true, get: function () { return convert_2.convertToRomanNumerals; } });
 Object.defineProperty(exports, "numberToWords", { enumerable: true, get: function () { return convert_2.numberToWords; } });
@@ -137,8 +137,8 @@ Object.defineProperty(exports, "romanToInteger", { enumerable: true, get: functi
 Object.defineProperty(exports, "romanToNumeric", { enumerable: true, get: function () { return convert_2.romanToInteger; } });
 Object.defineProperty(exports, "toRoman", { enumerable: true, get: function () { return convert_2.convertToRomanNumerals; } });
 Object.defineProperty(exports, "toRomanNumeral", { enumerable: true, get: function () { return convert_2.convertToRomanNumerals; } });
-Object.defineProperty(exports, "wordsToNumber", { enumerable: true, get: function () { return convert_2.wordsToNumber; } });
 Object.defineProperty(exports, "wordToNumber", { enumerable: true, get: function () { return convert_2.wordsToNumber; } });
+Object.defineProperty(exports, "wordsToNumber", { enumerable: true, get: function () { return convert_2.wordsToNumber; } });
 var prime_1 = require("./number/prime");
 Object.defineProperty(exports, "findPrimeNumbers", { enumerable: true, get: function () { return prime_1.findPrimeNumbers; } });
 Object.defineProperty(exports, "getPrimeNumbers", { enumerable: true, get: function () { return prime_1.findPrimeNumbers; } });
@@ -177,20 +177,20 @@ Object.defineProperty(exports, "convertHex8ToHsla", { enumerable: true, get: fun
 Object.defineProperty(exports, "convertHex8ToRgba", { enumerable: true, get: function () { return convert_3.convertHex8ToRgba; } });
 Object.defineProperty(exports, "convertHexToHsl", { enumerable: true, get: function () { return convert_3.convertHexToHsl; } });
 Object.defineProperty(exports, "convertHexToRgb", { enumerable: true, get: function () { return convert_3.convertHexToRgb; } });
-Object.defineProperty(exports, "convertHslaToHex8", { enumerable: true, get: function () { return convert_3.convertHslaToHex8; } });
-Object.defineProperty(exports, "convertHslaToRgba", { enumerable: true, get: function () { return convert_3.convertHslaToRgba; } });
 Object.defineProperty(exports, "convertHslToHex", { enumerable: true, get: function () { return convert_3.convertHslToHex; } });
 Object.defineProperty(exports, "convertHslToRgb", { enumerable: true, get: function () { return convert_3.convertHslToRgb; } });
-Object.defineProperty(exports, "convertRgbaToHex8", { enumerable: true, get: function () { return convert_3.convertRgbaToHex8; } });
-Object.defineProperty(exports, "convertRgbaToHsla", { enumerable: true, get: function () { return convert_3.convertRgbaToHsla; } });
+Object.defineProperty(exports, "convertHslaToHex8", { enumerable: true, get: function () { return convert_3.convertHslaToHex8; } });
+Object.defineProperty(exports, "convertHslaToRgba", { enumerable: true, get: function () { return convert_3.convertHslaToRgba; } });
 Object.defineProperty(exports, "convertRgbToHex", { enumerable: true, get: function () { return convert_3.convertRgbToHex; } });
 Object.defineProperty(exports, "convertRgbToHsl", { enumerable: true, get: function () { return convert_3.convertRgbToHsl; } });
 Object.defineProperty(exports, "convertRgbToRgba", { enumerable: true, get: function () { return convert_3.convertRgbToRgba; } });
+Object.defineProperty(exports, "convertRgbaToHex8", { enumerable: true, get: function () { return convert_3.convertRgbaToHex8; } });
+Object.defineProperty(exports, "convertRgbaToHsla", { enumerable: true, get: function () { return convert_3.convertRgbaToHsla; } });
 var helpers_1 = require("./colors/helpers");
-Object.defineProperty(exports, "isHex6", { enumerable: true, get: function () { return helpers_1._isHex6; } });
-Object.defineProperty(exports, "isHex8", { enumerable: true, get: function () { return helpers_1._isHex8; } });
 Object.defineProperty(exports, "isHSL", { enumerable: true, get: function () { return helpers_1._isHSL; } });
 Object.defineProperty(exports, "isHSLA", { enumerable: true, get: function () { return helpers_1._isHSLA; } });
+Object.defineProperty(exports, "isHex6", { enumerable: true, get: function () { return helpers_1._isHex6; } });
+Object.defineProperty(exports, "isHex8", { enumerable: true, get: function () { return helpers_1._isHex8; } });
 Object.defineProperty(exports, "isRGB", { enumerable: true, get: function () { return helpers_1._isRGB; } });
 Object.defineProperty(exports, "isRGBA", { enumerable: true, get: function () { return helpers_1._isRGBA; } });
 var Color_1 = require("./colors/Color");
@@ -208,9 +208,10 @@ Object.defineProperty(exports, "isDateLike", { enumerable: true, get: function (
 Object.defineProperty(exports, "isLeapYear", { enumerable: true, get: function () { return guards_3.isLeapYear; } });
 Object.defineProperty(exports, "isValidTime", { enumerable: true, get: function () { return guards_3.isValidTime; } });
 Object.defineProperty(exports, "isValidTimeString", { enumerable: true, get: function () { return guards_3.isValidTime; } });
-Object.defineProperty(exports, "isValidUTC", { enumerable: true, get: function () { return guards_3.isValidUTCOffSet; } });
-Object.defineProperty(exports, "isValidUTCOffSet", { enumerable: true, get: function () { return guards_3.isValidUTCOffSet; } });
 Object.defineProperty(exports, "isValidTimeZoneId", { enumerable: true, get: function () { return guards_3.isValidTimeZoneId; } });
+Object.defineProperty(exports, "isValidUTCOffset", { enumerable: true, get: function () { return guards_3.isValidUTCOffset; } });
+Object.defineProperty(exports, "isValidUTC", { enumerable: true, get: function () { return guards_3.isValidUTCOffset; } });
+Object.defineProperty(exports, "isValidUTCOffSet", { enumerable: true, get: function () { return guards_3.isValidUTCOffset; } });
 var Chronos_1 = require("./date/Chronos");
 Object.defineProperty(exports, "Chronos", { enumerable: true, get: function () { return Chronos_1.Chronos; } });
 Object.defineProperty(exports, "Chronus", { enumerable: true, get: function () { return Chronos_1.Chronos; } });

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

@@ -1,7 +1,7 @@
 import type { Enumerate, NumberRange } from '../number/types';
 import type { LooseLiteral, TupleOf } from '../utils/types';
 import { INTERNALS } from './constants';
-import type { $UTCOffset, ChronosInput, ChronosInternals, ChronosMethods, ChronosObject, ChronosPlugin, ChronosWithOptions, DateRangeOptions, DateTimeFormatOptions, FormatOptions, LocalesArguments, Milliseconds, MonthName, Quarter, RangeWithDates, RelativeDateRange, RelativeRangeOptions, StrictFormat, TimeParts, TimeUnit, TimeZone, TimeZoneId, TimeZoneIdentifier, TimeZoneName, UTCOffset, WeekDay } from './types';
+import type { $UTCOffset, ChronosInput, ChronosInternals, ChronosMethods, ChronosObject, ChronosPlugin, ChronosWithOptions, DateRangeOptions, DateTimeFormatOptions, FormatOptions, LocalesArguments, Milliseconds, MonthName, Quarter, RangeWithDates, RelativeDateRange, RelativeRangeOptions, StrictFormat, TimeParts, TimeUnit, TimeUnitValue, TimeZone, TimeZoneId, TimeZoneIdentifier, TimeZoneName, UTCOffset, WeekDay } from './types';
 /**
  * * Creates a new immutable `Chronos` instance.
  *
@@ -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,19 +198,19 @@ 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;
     /** @instance Returns ISO string with local machine's timezone offset. */
     toLocalISOString(): string;
-    /** @instance Returns a date as a string value in ISO format. Respects timezone. */
+    /** @instance Returns a date as a string value in ISO format. Respects timezone UTC. */
     toISOString(): string;
     /**
      * @instance Wrapper over native `toLocaleString` with improved type system.
@@ -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.
@@ -377,7 +377,7 @@ export declare class Chronos {
     isBetween(start: ChronosInput, end: ChronosInput, inclusive?: '[]' | '[)' | '(]' | '()'): boolean;
     /**
      * @instance Checks if the date is within daylight saving time (DST).
-     * @returns Whether the date is in DST.
+     * @returns Whether the date is in DST (`true` or `false`).
      */
     isDST(): boolean;
     /** @instance Checks if current day is the first day of the current month. */
@@ -419,14 +419,15 @@ export declare class Chronos {
     get(unit: TimeUnit): number;
     /**
      * @instance Returns a new `Chronos` instance with the specified unit set to the given value.
-     * @param unit The unit to modify.
-     * @param value The value to set for the unit.
+     * @param unit The unit to modify. Type of `value` is determined by `unit`.
+     * @param value The value to set for the unit. Type of `value` is determined by `unit`.
      */
-    set(unit: TimeUnit, value: number): Chronos;
+    set<Unit extends TimeUnit>(unit: Unit, value: TimeUnitValue<Unit>): Chronos;
     /**
-     * @instance Returns the difference between this and another date in the given unit.
+     * @instance Returns the difference between current and another date in the given unit.
      * @param other The other date to compare.
      * @param unit The unit in which to return the difference.
+     * @returns Difference in number (either `integer` or `float`).
      */
     diff(other: ChronosInput, unit: TimeUnit): number;
     /**
@@ -447,7 +448,7 @@ export declare class Chronos {
     /**
      * @instance Calculates the ISO 8601 week number of the year.
      *
-     * ISO weeks start on Monday, and the first week of the year is the one containing January 4th.
+     * @Remarks ISO weeks start on Monday, and the first week of the year is the one containing January 4th.
      *
      * @returns Week number (1–53).
      */
@@ -488,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
@@ -751,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/guards.d.ts

@@ -13,7 +13,7 @@ export declare function isValidTime(value: unknown): value is ClockTime;
  * @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;
+export declare function isValidUTCOffset(value: unknown): value is UTCOffset;
 /**
  * * Checks if the provided value is a valid timezone identifier from {@link https://en.wikipedia.org/wiki/List_of_tz_database_time_zones IANA TZ Database} (e.g. `"Africa/Harare"`).
  * @param value Timezone id to check.

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

@@ -47,10 +47,12 @@ export interface GreetingConfigs {
     /** Default greeting message if no period matches. */
     defaultMessage?: string;
 }
-/** Name of time unit from year to millisecond */
+/** Name of time unit from `year` to `millisecond` */
 export type TimeUnit = 'year' | 'month' | 'day' | 'week' | 'hour' | 'minute' | 'second' | 'millisecond';
 /** Name of time unit from `year` to `millisecond`, except `week` */
 export type FromNowUnit = Exclude<TimeUnit, 'week'>;
+/** Conditional value for {@link TimeUnit} */
+export type TimeUnitValue<Unit extends TimeUnit> = Unit extends 'month' ? NumberRange<1, 12> : Unit extends 'week' ? NumberRange<1, 53> : Unit extends 'day' ? NumberRange<1, 31> : Unit extends 'hour' ? Enumerate<24> : Unit extends 'minute' | 'second' ? Enumerate<60> : Unit extends 'millisecond' ? Milliseconds : number;
 /** Year in either 4 or 2 digits format */
 export type Year = (typeof YEAR_FORMATS)[number];
 /** Month in either 1 or 2 digits or 3 letters or full word format */
@@ -212,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/dts/index.d.ts

@@ -19,7 +19,7 @@ export { isCamelCase, isEmojiOnly, isKebabCase, isPalindrome, isPascalCase, isSn
 export { convertStringCase } from './string/case';
 export { extractEmails, extractURLs, formatUnitWithPlural as formatNumberWithPluralUnit, formatUnitWithPlural, formatUnitWithPlural as formatWithPlural, maskString, normalizeString, replaceAllInString, reverseString, slugifyString, } from './string/convert';
 export { countWords, countWords as countWordsInString, extractNumbersFromString as extractNumbers, extractNumbersFromString, getLevenshteinDistance, getLevenshteinDistance as levenshteinDistance, extractNumbersFromString as parseNumbersFromText, countWords as wordCount, } from './string/utilities';
-export { AreaConverter, Converter, converter, DataConverter, LengthConverter, MassConverter, TemperatureConverter, TimeConverter, VolumeConverter, } from './converter/Converter';
+export { AreaConverter, Converter, DataConverter, LengthConverter, MassConverter, TemperatureConverter, TimeConverter, VolumeConverter, converter, } from './converter/Converter';
 export { Pluralizer, pluralizer } from './pluralizer/Pluralizer';
 export { Verbalizer, verbalizer } from './verbalizer/Verbalizer';
 export { getAverage as calculateAverage, factorial as calculateFactorial, calculateHCF as calculateGCD, calculateHCF, calculateLCM as calculateLCD, calculateLCM, convertToDecimal, convertToDecimal as convertToFixed, factorial, getFactors as factorsOf, getAverage, getAverage as getAverageOfNumbers, getFactors as getDivisors, factorial as getFactorial, getFactors, getRandomNumber as getRandomInt, getRandomNumber, sumNumbers as getSumOfNumbers, reverseNumber, roundNumber, roundNumber as roundToDecimal, sumDigits, sumNumbers, sumNumbers as sumOfNumbers, } from './number/basics';
@@ -28,18 +28,18 @@ export { Unit, Unit as UnitConverter } from './number/Unit';
 export { calculatePercentage } from './number/percent';
 export { fibonacciGenerator, fibonacciGenerator as generateFibonacci, getFibonacciSeries as getFibonacci, getFibonacciSeries as getFibonacciNumbers, getFibonacciSeries, getFibonacciSeriesMemo, getFibonacciSeriesMemo as getMemoizedFibonacci, getFibonacciSeriesMemo as getMemoizedFibonacciSeries, getNthFibonacci, } from './number/fibonacci';
 export { areInvalidNumbers, areInvalidNumbers as areNumbersInvalid, isEven, isEven as isEvenNumber, isFibonacci, areInvalidNumbers as isInvalidNumber, isMultiple, areInvalidNumbers as isNumberInvalid, isOdd, isOdd as isOddNumber, isFibonacci as isPartOfFibonacci, isFibonacci as isPartOfFibonacciSeries, isPerfectSquare, } from './number/guards';
-export { convertToRomanNumerals as arabicToRoman, numberToWordsOrdinal as cardinalWordsToOrdinal, numberToWords as convertNumberToWords, numberToWordsOrdinal as convertNumberToWordsOrdinal, romanToInteger as convertRomanToArabic, romanToInteger as convertRomanToInteger, romanToInteger as convertRomanToNumeric, convertToRomanNumerals, wordsToNumber as convertWordsToNumber, wordsToNumber as convertWordToNumber, convertToRomanNumerals as integerToRoman, convertToRomanNumerals as numberToRoman, numberToWords, numberToWordsOrdinal, convertToRomanNumerals as numericToRoman, romanToInteger as romanToArabic, romanToInteger, romanToInteger as romanToNumeric, convertToRomanNumerals as toRoman, convertToRomanNumerals as toRomanNumeral, wordsToNumber, wordsToNumber as wordToNumber, } from './number/convert';
+export { convertToRomanNumerals as arabicToRoman, numberToWordsOrdinal as cardinalWordsToOrdinal, numberToWords as convertNumberToWords, numberToWordsOrdinal as convertNumberToWordsOrdinal, romanToInteger as convertRomanToArabic, romanToInteger as convertRomanToInteger, romanToInteger as convertRomanToNumeric, convertToRomanNumerals, wordsToNumber as convertWordToNumber, wordsToNumber as convertWordsToNumber, convertToRomanNumerals as integerToRoman, convertToRomanNumerals as numberToRoman, numberToWords, numberToWordsOrdinal, convertToRomanNumerals as numericToRoman, romanToInteger as romanToArabic, romanToInteger, romanToInteger as romanToNumeric, convertToRomanNumerals as toRoman, convertToRomanNumerals as toRomanNumeral, wordsToNumber as wordToNumber, wordsToNumber, } from './number/convert';
 export { findPrimeNumbers, findPrimeNumbers as getPrimeNumbers, isPrime, isPrime as isPrimeNumber, } from './number/prime';
 export { getOrdinal as cardinalToOrdinal, clampNumber, formatCurrency as convertNumberToCurrency, getOrdinal as convertNumberToOrdinal, getOrdinal as convertToOrdinal, formatCurrency, getOrdinal, getOrdinal as getOrdinalNumber, getRandomFloat as getRandomDecimal, getRandomFloat, normalizeNumber, getOrdinal as numberToOrdinal, roundToNearest as roundNumberToNearestInterval, roundToNearest, roundToNearest as roundToNearestInterval, } from './number/utilities';
 export { getNumbersInRange } from './number/range';
 export { getColorForInitial } from './colors/initials';
 export { generateRandomColor, generateRandomColorInHexRGB, generateRandomHSLColor as generateRandomHSL, generateRandomHSLColor, generateRandomColor as getRandomColor, generateRandomHSLColor as getRandomHSL, } from './colors/random';
-export { convertColorCode, convertHex8ToHsla, convertHex8ToRgba, convertHexToHsl, convertHexToRgb, convertHslaToHex8, convertHslaToRgba, convertHslToHex, convertHslToRgb, convertRgbaToHex8, convertRgbaToHsla, convertRgbToHex, convertRgbToHsl, convertRgbToRgba, } from './colors/convert';
-export { _isHex6 as isHex6, _isHex8 as isHex8, _isHSL as isHSL, _isHSLA as isHSLA, _isRGB as isRGB, _isRGBA as isRGBA, } from './colors/helpers';
+export { convertColorCode, convertHex8ToHsla, convertHex8ToRgba, convertHexToHsl, convertHexToRgb, convertHslToHex, convertHslToRgb, convertHslaToHex8, convertHslaToRgba, convertRgbToHex, convertRgbToHsl, convertRgbToRgba, convertRgbaToHex8, convertRgbaToHsla, } from './colors/convert';
+export { _isHSL as isHSL, _isHSLA as isHSLA, _isHex6 as isHex6, _isHex8 as isHex8, _isRGB as isRGB, _isRGBA as isRGBA, } from './colors/helpers';
 export { Color, Color as Colour } from './colors/Color';
 export { extractAlphaColorValues, extractSolidColorValues } from './colors/utils';
 export { getGreeting as generateGreeting, getGreeting, getGreeting as greet, } from './date/greet';
-export { isDateLike, isLeapYear, isValidTime, isValidTime as isValidTimeString, isValidUTCOffSet as isValidUTC, isValidUTCOffSet, isValidTimeZoneId, } from './date/guards';
+export { isDateLike, isLeapYear, isValidTime, isValidTime as isValidTimeString, isValidTimeZoneId, isValidUTCOffset, isValidUTCOffset as isValidUTC, isValidUTCOffset as isValidUTCOffSet, } from './date/guards';
 export { Chronos, Chronos as Chronus } from './date/Chronos';
 export { INTERNALS } from './date/constants';
 export { chronos, chronos as chronosjs, chronos as chronosts, chronos as chronus, chronos as chronusjs, chronos as chronusts, } from './date/chronos-fn';

package/dist/esm/date/Chronos.js

@@ -78,9 +78,9 @@ export class Chronos {
             case 'timeZone':
             case 'toUTC':
             case 'utc':
-                return string.replace(this.#isoTzRemoved(), replacement);
+                return string.replace(this.#removeUTCFromISO(), replacement);
             default:
-                return string.replace(this.#isoTzRemoved(true), replacement);
+                return string.replace(this.#removeUTCFromISO(true), replacement);
         }
     }
     [Symbol.search](string) {
@@ -88,9 +88,9 @@ export class Chronos {
             case 'timeZone':
             case 'toUTC':
             case 'utc':
-                return string.indexOf(this.#isoTzRemoved());
+                return string.indexOf(this.#removeUTCFromISO());
             default:
-                return string.indexOf(this.#isoTzRemoved(true));
+                return string.indexOf(this.#removeUTCFromISO(true));
         }
     }
     [Symbol.split](string) {
@@ -98,9 +98,9 @@ export class Chronos {
             case 'timeZone':
             case 'toUTC':
             case 'utc':
-                return string.split(this.#isoTzRemoved());
+                return string.split(this.#removeUTCFromISO());
             default:
-                return string.split(this.#isoTzRemoved(true));
+                return string.split(this.#removeUTCFromISO(true));
         }
     }
     [Symbol.match](string) {
@@ -226,7 +226,7 @@ export class Chronos {
         const pad = (n, p = 2) => String(n).padStart(p, '0');
         return `${this.year}-${pad(this.month + 1)}-${pad(this.date)}T${pad(this.hour)}:${pad(this.minute)}:${pad(this.second)}.${pad(this.millisecond, 3)}${this.getUTCOffset()}`;
     }
-    #isoTzRemoved(local = false) {
+    #removeUTCFromISO(local = false) {
         return local ?
             this.toLocalISOString().replace(/\.\d+(Z|[+-]\d{2}:\d{2})?$/, '')
             : this.toISOString().replace(/\.\d+(Z|[+-]\d{2}:\d{2})?$/, '');
@@ -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) {
@@ -446,7 +446,7 @@ export class Chronos {
         }
     }
     isDST() {
-        const year = this.#date.getFullYear();
+        const year = this.year;
         const jan = new Date(year, 0, 1).getTimezoneOffset();
         const jul = new Date(year, 6, 1).getTimezoneOffset();
         return this.#date.getTimezoneOffset() < Math.max(jan, jul);
@@ -570,7 +570,7 @@ export class Chronos {
                 d.setFullYear(value);
                 break;
             case 'month':
-                d.setMonth(value);
+                d.setMonth(value - 1);
                 break;
             case 'day':
                 d.setDate(value);
@@ -608,11 +608,16 @@ export class Chronos {
                 return msDiff / 8.64e7;
             case 'week':
                 return msDiff / 6.048e8;
-            case 'month':
-                return ((this.get('year') - time.get('year')) * 12 +
-                    (this.get('month') - time.get('month')));
+            case 'month': {
+                const yearDiff = this.get('year') - time.get('year');
+                const monthDiff = this.get('month') - time.get('month');
+                const totalMonthDiff = yearDiff * 12 + monthDiff;
+                const dayDiff = this.get('day') - time.get('day');
+                const daysInMonth = new Date(this.get('year'), this.get('month'), 0).getDate();
+                return totalMonthDiff + dayDiff / daysInMonth;
+            }
             case 'year':
-                return this.get('year') - time.get('year');
+                return this.diff(time, 'month') / 12;
         }
     }
     calendar(baseDate) {
@@ -844,7 +849,7 @@ export class Chronos {
             return now
                 .startOf('month')
                 .set('year', year ?? now.year)
-                .set('month', month ? month - 1 : now.month).lastDateOfMonth;
+                .set('month', month ?? now.isoMonth).lastDateOfMonth;
         };
         return new _a(year ?? now.year, month ?? now.isoMonth, date ? date
             : now.isLastDayOfMonth() && now.date >= nextLDoM() ? nextLDoM()

package/dist/esm/date/guards.js

@@ -12,7 +12,7 @@ export function isValidTime(value) {
     const minute = Number(minuteStr);
     return hour >= 0 && hour <= 23 && minute >= 0 && minute <= 59;
 }
-export function isValidUTCOffSet(value) {
+export function isValidUTCOffset(value) {
     return isString(value) ? /^UTC[+-]?\d{1,2}:\d{2}$/.test(value) : false;
 }
 export function isValidTimeZoneId(value) {

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

@@ -1,9 +1,16 @@
 import { INTERNALS } from '../constants.js';
-import { isValidTimeZoneId, isValidUTCOffSet } from '../guards.js';
+import { isValidTimeZoneId, isValidUTCOffset } from '../guards.js';
 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 (isValidUTCOffSet(zone)) {
-            return _resolveTzName(zone);
+        if (_isGMT(zone))
+            return 'Greenwich Mean Time';
+        if (isValidUTCOffset(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)
@@ -44,7 +57,7 @@ export const timeZonePlugin = (ChronosClass) => {
     ChronosClass.prototype.timeZone = function (zone) {
         let offset;
         let tzId;
-        if (isValidUTCOffSet(zone)) {
+        if (isValidUTCOffset(zone)) {
             offset = zone;
             tzId = _getTimeZoneId(offset) || offset;
         }
@@ -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(this?.$tzTracker ?? UTC) ?? UTC;
+        const UTC = utc || this.utcOffset;
+        return _getTimeZoneName(utc || this?.$tzTracker || this.utcOffset) ?? UTC;
+    };
+    const TZ_ABBR_CACHE = new Map();
+    const _abbreviate = (name) => {
+        return name
+            .split(/\s+/)
+            .map((w) => w[0])
+            .join('')
+            .replace(/\W/g, '');
     };
-    const TZ_SHORT_CACHE = new Map();
     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/dist/esm/index.js

@@ -4,7 +4,7 @@ export { isCamelCase, isEmojiOnly, isKebabCase, isPalindrome, isPascalCase, isSn
 export { convertStringCase } from './string/case.js';
 export { extractEmails, extractURLs, formatUnitWithPlural as formatNumberWithPluralUnit, formatUnitWithPlural, formatUnitWithPlural as formatWithPlural, maskString, normalizeString, replaceAllInString, reverseString, slugifyString, } from './string/convert.js';
 export { countWords, countWords as countWordsInString, extractNumbersFromString as extractNumbers, extractNumbersFromString, getLevenshteinDistance, getLevenshteinDistance as levenshteinDistance, extractNumbersFromString as parseNumbersFromText, countWords as wordCount, } from './string/utilities.js';
-export { AreaConverter, Converter, converter, DataConverter, LengthConverter, MassConverter, TemperatureConverter, TimeConverter, VolumeConverter, } from './converter/Converter.js';
+export { AreaConverter, Converter, DataConverter, LengthConverter, MassConverter, TemperatureConverter, TimeConverter, VolumeConverter, converter, } from './converter/Converter.js';
 export { Pluralizer, pluralizer } from './pluralizer/Pluralizer.js';
 export { Verbalizer, verbalizer } from './verbalizer/Verbalizer.js';
 export { getAverage as calculateAverage, factorial as calculateFactorial, calculateHCF as calculateGCD, calculateHCF, calculateLCM as calculateLCD, calculateLCM, convertToDecimal, convertToDecimal as convertToFixed, factorial, getFactors as factorsOf, getAverage, getAverage as getAverageOfNumbers, getFactors as getDivisors, factorial as getFactorial, getFactors, getRandomNumber as getRandomInt, getRandomNumber, sumNumbers as getSumOfNumbers, reverseNumber, roundNumber, roundNumber as roundToDecimal, sumDigits, sumNumbers, sumNumbers as sumOfNumbers, } from './number/basics.js';
@@ -13,18 +13,18 @@ export { Unit, Unit as UnitConverter } from './number/Unit.js';
 export { calculatePercentage } from './number/percent.js';
 export { fibonacciGenerator, fibonacciGenerator as generateFibonacci, getFibonacciSeries as getFibonacci, getFibonacciSeries as getFibonacciNumbers, getFibonacciSeries, getFibonacciSeriesMemo, getFibonacciSeriesMemo as getMemoizedFibonacci, getFibonacciSeriesMemo as getMemoizedFibonacciSeries, getNthFibonacci, } from './number/fibonacci.js';
 export { areInvalidNumbers, areInvalidNumbers as areNumbersInvalid, isEven, isEven as isEvenNumber, isFibonacci, areInvalidNumbers as isInvalidNumber, isMultiple, areInvalidNumbers as isNumberInvalid, isOdd, isOdd as isOddNumber, isFibonacci as isPartOfFibonacci, isFibonacci as isPartOfFibonacciSeries, isPerfectSquare, } from './number/guards.js';
-export { convertToRomanNumerals as arabicToRoman, numberToWordsOrdinal as cardinalWordsToOrdinal, numberToWords as convertNumberToWords, numberToWordsOrdinal as convertNumberToWordsOrdinal, romanToInteger as convertRomanToArabic, romanToInteger as convertRomanToInteger, romanToInteger as convertRomanToNumeric, convertToRomanNumerals, wordsToNumber as convertWordsToNumber, wordsToNumber as convertWordToNumber, convertToRomanNumerals as integerToRoman, convertToRomanNumerals as numberToRoman, numberToWords, numberToWordsOrdinal, convertToRomanNumerals as numericToRoman, romanToInteger as romanToArabic, romanToInteger, romanToInteger as romanToNumeric, convertToRomanNumerals as toRoman, convertToRomanNumerals as toRomanNumeral, wordsToNumber, wordsToNumber as wordToNumber, } from './number/convert.js';
+export { convertToRomanNumerals as arabicToRoman, numberToWordsOrdinal as cardinalWordsToOrdinal, numberToWords as convertNumberToWords, numberToWordsOrdinal as convertNumberToWordsOrdinal, romanToInteger as convertRomanToArabic, romanToInteger as convertRomanToInteger, romanToInteger as convertRomanToNumeric, convertToRomanNumerals, wordsToNumber as convertWordToNumber, wordsToNumber as convertWordsToNumber, convertToRomanNumerals as integerToRoman, convertToRomanNumerals as numberToRoman, numberToWords, numberToWordsOrdinal, convertToRomanNumerals as numericToRoman, romanToInteger as romanToArabic, romanToInteger, romanToInteger as romanToNumeric, convertToRomanNumerals as toRoman, convertToRomanNumerals as toRomanNumeral, wordsToNumber as wordToNumber, wordsToNumber, } from './number/convert.js';
 export { findPrimeNumbers, findPrimeNumbers as getPrimeNumbers, isPrime, isPrime as isPrimeNumber, } from './number/prime.js';
 export { getOrdinal as cardinalToOrdinal, clampNumber, formatCurrency as convertNumberToCurrency, getOrdinal as convertNumberToOrdinal, getOrdinal as convertToOrdinal, formatCurrency, getOrdinal, getOrdinal as getOrdinalNumber, getRandomFloat as getRandomDecimal, getRandomFloat, normalizeNumber, getOrdinal as numberToOrdinal, roundToNearest as roundNumberToNearestInterval, roundToNearest, roundToNearest as roundToNearestInterval, } from './number/utilities.js';
 export { getNumbersInRange } from './number/range.js';
 export { getColorForInitial } from './colors/initials.js';
 export { generateRandomColor, generateRandomColorInHexRGB, generateRandomHSLColor as generateRandomHSL, generateRandomHSLColor, generateRandomColor as getRandomColor, generateRandomHSLColor as getRandomHSL, } from './colors/random.js';
-export { convertColorCode, convertHex8ToHsla, convertHex8ToRgba, convertHexToHsl, convertHexToRgb, convertHslaToHex8, convertHslaToRgba, convertHslToHex, convertHslToRgb, convertRgbaToHex8, convertRgbaToHsla, convertRgbToHex, convertRgbToHsl, convertRgbToRgba, } from './colors/convert.js';
-export { _isHex6 as isHex6, _isHex8 as isHex8, _isHSL as isHSL, _isHSLA as isHSLA, _isRGB as isRGB, _isRGBA as isRGBA, } from './colors/helpers.js';
+export { convertColorCode, convertHex8ToHsla, convertHex8ToRgba, convertHexToHsl, convertHexToRgb, convertHslToHex, convertHslToRgb, convertHslaToHex8, convertHslaToRgba, convertRgbToHex, convertRgbToHsl, convertRgbToRgba, convertRgbaToHex8, convertRgbaToHsla, } from './colors/convert.js';
+export { _isHSL as isHSL, _isHSLA as isHSLA, _isHex6 as isHex6, _isHex8 as isHex8, _isRGB as isRGB, _isRGBA as isRGBA, } from './colors/helpers.js';
 export { Color, Color as Colour } from './colors/Color.js';
 export { extractAlphaColorValues, extractSolidColorValues } from './colors/utils.js';
 export { getGreeting as generateGreeting, getGreeting, getGreeting as greet, } from './date/greet.js';
-export { isDateLike, isLeapYear, isValidTime, isValidTime as isValidTimeString, isValidUTCOffSet as isValidUTC, isValidUTCOffSet, isValidTimeZoneId, } from './date/guards.js';
+export { isDateLike, isLeapYear, isValidTime, isValidTime as isValidTimeString, isValidTimeZoneId, isValidUTCOffset, isValidUTCOffset as isValidUTC, isValidUTCOffset as isValidUTCOffSet, } from './date/guards.js';
 export { Chronos, Chronos as Chronus } from './date/Chronos.js';
 export { INTERNALS } from './date/constants.js';
 export { chronos, chronos as chronosjs, chronos as chronosts, chronos as chronus, chronos as chronusjs, chronos as chronusts, } from './date/chronos-fn.js';

package/package.json

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