nhb-toolbox 3.4.1 → 3.4.2

package/dist/date/Chronos.d.ts

@@ -1,10 +1,20 @@
 export declare class Chronos {
-    private readonly _date;
+    private readonly date;
     /**
      * * Creates a new immutable Chronos instance.
-     * @param value - A date value (`timestamp`, `string`, or `Date`).
+     * @param value - A date value (`timestamp`, `string`, `Date`, `Chronos`).
      */
     constructor(value?: number | string | Date | Chronos);
+    /** * Gets the native `Date` instance (read-only). */
+    toDate(): Date;
+    /** * Returns a string representation of a date. The format of the string depends on the locale. */
+    toString(): string;
+    /** * Returns a date as a string value in ISO format. */
+    toISOString(): string;
+    /** * Returns the time value in milliseconds since midnight, January 1, 1970 UTC. */
+    getTimeStamp(): number;
+    /** * Returns the number of milliseconds elapsed since midnight, January 1, 1970 Universal Coordinated Time (UTC). */
+    static now(): number;
     /**
      * * Formats the date into a custom string format.
      * @param format - The desired format (Default format is `DD-MM-YYYY` = `30-06-1995`).
@@ -33,7 +43,12 @@ export declare class Chronos {
      *  - Other positive or negative numbers for other relative days (e.g., `-2` for two days ago, `2` for two days ahead).
      */
     getRelativeDay(): number;
-    /** * Gets the native `Date` instance (read-only). */
-    toDate(): Date;
+    /**
+     * * Checks if the year is a leap year.
+     * - A year is a leap year if it is divisible by 4, but not divisible by 100, unless it is also divisible by 400.
+     * - For example, 2000 and 2400 are leap years, but 1900 and 2100 are not.
+     * @returns `true` if the year is a leap year, `false` otherwise.
+     */
+    isLeapYear(): boolean;
 }
 //# sourceMappingURL=Chronos.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Chronos.d.ts","sourceRoot":"","sources":["../../src/date/Chronos.ts"],"names":[],"mappings":"AAGA,qBAAa,OAAO;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAO;IAE7B;;;OAGG;gBACS,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO;IAcpD;;;;OAIG;IACH,MAAM,CAAC,MAAM,GAAE,MAAqB,GAAG,MAAM;IA2E7C;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAM9B;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInC;;;;;;;;OAQG;IACH,cAAc,IAAI,MAAM;IAexB,qDAAqD;IACrD,MAAM,IAAI,IAAI;CAGd"}
+{"version":3,"file":"Chronos.d.ts","sourceRoot":"","sources":["../../src/date/Chronos.ts"],"names":[],"mappings":"AAGA,qBAAa,OAAO;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;IAE5B;;;OAGG;gBACS,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO;IAcpD,qDAAqD;IACrD,MAAM,IAAI,IAAI;IAId,mGAAmG;IACnG,QAAQ,IAAI,MAAM;IAIlB,wDAAwD;IACxD,WAAW,IAAI,MAAM;IAIrB,oFAAoF;IACpF,YAAY,IAAI,MAAM;IAItB,qHAAqH;IACrH,MAAM,CAAC,GAAG,IAAI,MAAM;IAIpB;;;;OAIG;IACH,MAAM,CAAC,MAAM,GAAE,MAAqB,GAAG,MAAM;IA2E7C;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAM9B;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInC;;;;;;;;OAQG;IACH,cAAc,IAAI,MAAM;IAexB;;;;;OAKG;IACH,UAAU,IAAI,OAAO;CAKrB"}

package/dist/date/Chronos.js

@@ -1,9 +1,9 @@
 import { DAYS, MONTHS, sortedFormats } from './constants';
 export class Chronos {
-    _date;
+    date;
     /**
      * * Creates a new immutable Chronos instance.
-     * @param value - A date value (`timestamp`, `string`, or `Date`).
+     * @param value - A date value (`timestamp`, `string`, `Date`, `Chronos`).
      */
     constructor(value) {
         const date = value instanceof Chronos ?
@@ -13,7 +13,27 @@ export class Chronos {
         if (isNaN(date.getTime())) {
             throw new Error('Invalid date provided!');
         }
-        this._date = date;
+        this.date = date;
+    }
+    /** * Gets the native `Date` instance (read-only). */
+    toDate() {
+        return new Date(this.date);
+    }
+    /** * Returns a string representation of a date. The format of the string depends on the locale. */
+    toString() {
+        return this.date.toString();
+    }
+    /** * Returns a date as a string value in ISO format. */
+    toISOString() {
+        return this.date.toISOString();
+    }
+    /** * Returns the time value in milliseconds since midnight, January 1, 1970 UTC. */
+    getTimeStamp() {
+        return this.date.getTime();
+    }
+    /** * Returns the number of milliseconds elapsed since midnight, January 1, 1970 Universal Coordinated Time (UTC). */
+    static now() {
+        return Date.now();
     }
     /**
      * * Formats the date into a custom string format.
@@ -21,14 +41,14 @@ export class Chronos {
      * @returns Formatted date string in desired format.
      */
     format(format = 'DD-MM-YYYY') {
-        const year = this._date.getFullYear();
-        const month = this._date.getMonth();
-        const day = this._date.getDay();
-        const date = this._date.getDate();
-        const hours = this._date.getHours();
-        const minutes = this._date.getMinutes();
-        const seconds = this._date.getSeconds();
-        const milliseconds = this._date.getMilliseconds();
+        const year = this.date.getFullYear();
+        const month = this.date.getMonth();
+        const day = this.date.getDay();
+        const date = this.date.getDate();
+        const hours = this.date.getHours();
+        const minutes = this.date.getMinutes();
+        const seconds = this.date.getSeconds();
+        const milliseconds = this.date.getMilliseconds();
         const dateComponents = {
             YYYY: String(year),
             YY: String(year).slice(-2),
@@ -91,7 +111,7 @@ export class Chronos {
      * @returns A new `Chronos` instance with the updated date.
      */
     addDays(days) {
-        const newDate = new Date(this._date);
+        const newDate = new Date(this.date);
         newDate.setDate(newDate.getDate() + days);
         return new Chronos(newDate);
     }
@@ -117,14 +137,20 @@ export class Chronos {
         // Set the time of today to 00:00:00 for comparison purposes
         today.setHours(0, 0, 0, 0);
         // Normalize the input date to 00:00:00
-        const inputDate = new Date(this._date);
+        const inputDate = new Date(this.date);
         inputDate.setHours(0, 0, 0, 0);
         const diffTime = inputDate.getTime() - today.getTime();
         const diffDays = Math.floor(diffTime / (1000 * 60 * 60 * 24));
         return diffDays;
     }
-    /** * Gets the native `Date` instance (read-only). */
-    toDate() {
-        return new Date(this._date);
+    /**
+     * * Checks if the year is a leap year.
+     * - A year is a leap year if it is divisible by 4, but not divisible by 100, unless it is also divisible by 400.
+     * - For example, 2000 and 2400 are leap years, but 1900 and 2100 are not.
+     * @returns `true` if the year is a leap year, `false` otherwise.
+     */
+    isLeapYear() {
+        const year = this.date.getFullYear();
+        return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
     }
 }

package/package.json

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