@fr0st/datetime 8.0.1 → 8.0.3

package/README.md

@@ -398,7 +398,7 @@ DateTime.clearDataCache();
 
 ```bash
 npm test
-npm run js-lint
+npm run lint
 npm run build
 ```
 

package/dist/frost-datetime.js

@@ -141,7 +141,8 @@
         second: 60,
     };
 
-    /** @typedef {import('./date-time.js').default} DateTime */
+    /** @import DateTime from './date-time.js' */
+
 
     /**
      * DateTime Helpers
@@ -1711,6 +1712,12 @@
      * An immutable date and time object with locale-aware formatting and time-zone support.
      */
     class DateTime {
+        #date;
+        #dynamicTz;
+        #locale;
+        #offset;
+        #timeZone;
+
         /**
          * Clears cached formatter and locale data.
          */
@@ -2094,8 +2101,8 @@
                 throw new Error('Invalid date supplied');
             }
 
-            this._date = new Date(timestamp);
-            this._dynamicTz = false;
+            this.#date = new Date(timestamp);
+            this.#dynamicTz = false;
             this.isValid = true;
 
             let timeZone = options.timeZone;
@@ -2110,37 +2117,37 @@
 
             const match = timeZone.match(offsetRegExp);
             if (match) {
-                this._offset =
+                this.#offset =
                     match[2] * 60 +
                     parseInt(match[4] || 0, 10) +
                     parseInt(match[5] || 0, 10) / 60;
-                if (this._offset && match[1] === '+') {
-                    this._offset *= -1;
+                if (this.#offset && match[1] === '+') {
+                    this.#offset *= -1;
                 }
 
-                if (this._offset) {
-                    this._timeZone = formatOffset(this._offset);
+                if (this.#offset) {
+                    this.#timeZone = formatOffset(this.#offset);
                 } else {
-                    this._dynamicTz = true;
-                    this._timeZone = 'UTC';
+                    this.#dynamicTz = true;
+                    this.#timeZone = 'UTC';
                 }
             } else {
-                this._dynamicTz = true;
-                this._timeZone = timeZone;
+                this.#dynamicTz = true;
+                this.#timeZone = timeZone;
             }
 
-            this._locale = 'locale' in options ?
+            this.#locale = 'locale' in options ?
                 options.locale :
                 config.defaultLocale;
 
-            if (this._dynamicTz) {
-                this._offset = getOffset(this);
+            if (this.#dynamicTz) {
+                this.#offset = getOffset(this);
             }
 
-            if (adjustOffset && this._offset) {
+            if (adjustOffset && this.#offset) {
                 const resolvedDate = setOffsetTime(this, timestamp);
-                this._date.setTime(resolvedDate.getTime());
-                this._offset = resolvedDate.getTimeZoneOffset();
+                this.#date.setTime(resolvedDate.getTime());
+                this.#offset = resolvedDate.getTimeZoneOffset();
             }
         }
 
@@ -2571,7 +2578,7 @@
          * @returns {string} The locale.
          */
         getLocale() {
-            return this._locale;
+            return this.#locale;
         }
 
         /**
@@ -2619,7 +2626,7 @@
          * @returns {number} The number of milliseconds since the UNIX epoch.
          */
         getTime() {
-            return this._date.getTime();
+            return this.#date.getTime();
         }
 
         /**
@@ -2635,7 +2642,7 @@
          * @returns {string} The time zone.
          */
         getTimeZone() {
-            return this._timeZone;
+            return this.#timeZone;
         }
 
         /**
@@ -2643,7 +2650,7 @@
          * @returns {number} The UTC offset in minutes.
          */
         getTimeZoneOffset() {
-            return this._offset;
+            return this.#offset;
         }
 
         /**
@@ -3017,7 +3024,7 @@
          * @returns {boolean} Whether the current time is in daylight saving time.
          */
         isDst() {
-            if (!this._dynamicTz) {
+            if (!this.#dynamicTz) {
                 return false;
             }
 
@@ -3472,7 +3479,7 @@
          * @returns {string} The name of the time zone.
          */
         timeZoneName(type = 'long') {
-            return this._dynamicTz ?
+            return this.#dynamicTz ?
                 formatTimeZoneName(this.getLocale(), this.getTime(), this.getTimeZone(), type) :
                 'GMT' + formatOffset(this.getTimeZoneOffset(), true, type === 'short');
         }
@@ -3595,10 +3602,8 @@
 
         /**
          * Returns a copy with the hours changed in the current time zone.
-         * @param {number} hours The hours. (0-23)
-         * @param {number} [minutes] The minutes. (0-59)
-         * @param {number} [seconds] The seconds. (0-59)
-         * @param {number} [milliseconds] The milliseconds.
+         * @param {...number} args The hours (0-23), optionally followed by minutes
+         * (0-59), seconds (0-59), and milliseconds.
          * @returns {DateTime} A new DateTime instance.
          */
         withHours(...args) {
@@ -3616,7 +3621,7 @@
         withLocale(locale) {
             return new this.constructor(this.getTime(), {
                 locale,
-                timeZone: this._timeZone,
+                timeZone: this.#timeZone,
             });
         }
 
@@ -3634,9 +3639,8 @@
 
         /**
          * Returns a copy with the minutes changed in the current time zone.
-         * @param {number} minutes The minutes. (0-59)
-         * @param {number} [seconds] The seconds. (0-59)
-         * @param {number} [milliseconds] The milliseconds.
+         * @param {...number} args The minutes (0-59), optionally followed by seconds
+         * (0-59) and milliseconds.
          * @returns {DateTime} A new DateTime instance.
          */
         withMinutes(...args) {
@@ -3693,8 +3697,8 @@
 
         /**
          * Returns a copy with the seconds changed in the current time zone.
-         * @param {number} seconds The seconds. (0-59)
-         * @param {number} [milliseconds] The milliseconds.
+         * @param {...number} args The seconds (0-59), optionally followed by
+         * milliseconds.
          * @returns {DateTime} A new DateTime instance.
          */
         withSeconds(...args) {
@@ -3711,8 +3715,8 @@
          */
         withTime(time) {
             return new this.constructor(time, {
-                locale: this._locale,
-                timeZone: this._timeZone,
+                locale: this.#locale,
+                timeZone: this.#timeZone,
             });
         }
 
@@ -3732,7 +3736,7 @@
          */
         withTimeZone(timeZone) {
             return new this.constructor(this.getTime(), {
-                locale: this._locale,
+                locale: this.#locale,
                 timeZone,
             });
         }
@@ -3744,7 +3748,7 @@
          */
         withTimeZoneOffset(offset) {
             return new this.constructor(this.getTime(), {
-                locale: this._locale,
+                locale: this.#locale,
                 timeZone: formatOffset(offset),
             });
         }