date-and-time 3.4.1 → 3.6.0

package/PLUGINS.md

@@ -76,7 +76,7 @@ date.plugin('foobar');
   - It adds `timeSpan()` function that calculates the difference of two dates to the library.
 
 - [timezone](#timezone)
-  - It adds `formatTZ()`, `parseTZ()` and `transformTZ()` that support `IANA time zone names` to the library.
+  - It adds `formatTZ()`, `parseTZ()`, `transformTZ()`, `addYearsTZ()`, `addMonthsTZ()` and `addDaysTZ()` that support `IANA time zone names` to the library.
 
 - [two-digit-year](#two-digit-year)
   - It adds two-digit year notation to the parser.
@@ -290,7 +290,7 @@ In these functions can be available some tokens to format the calculation result
 
 ### timezone
 
-It adds `formatTZ()`, `parseTZ()` and `transformTZ()` that support `IANA time zone names` (`America/Los_Angeles`, `Asia/Tokyo`, and so on) to the library.
+It adds `formatTZ()`, `parseTZ()`, `transformTZ()`, `addYearsTZ()`, `addMonthsTZ()` and `addDaysTZ()` that support `IANA time zone names` (`America/Los_Angeles`, `Asia/Tokyo`, and so on) to the library.
 
 #### formatTZ(dateObj, arg[, timeZone])
 
@@ -299,7 +299,7 @@ It adds `formatTZ()`, `parseTZ()` and `transformTZ()` that support `IANA time zo
 - @param {**string**} [timeZone] - Output as this time zone
 - @returns {**string**} A formatted string
 
-`formatTZ()` is upward compatible with `format()`. Tokens available for `arg` are the same as those for `format()`. If `timeZone` is omitted, this function assumes `timeZone` to be a local time zone and outputs a string. This means that the result is the same as when `format()` is used.
+`formatTZ()` is upward compatible with `format()`. Tokens available for `arg` are the same as those for `format()`. If `timeZone` is omitted, this function assumes `timeZone` to be the local time zone and outputs a string. This means that the result is the same as when `format()` is used.
 
 #### parseTZ(dateString, arg[, timeZone])
 
@@ -308,7 +308,7 @@ It adds `formatTZ()`, `parseTZ()` and `transformTZ()` that support `IANA time zo
 - @param {**string**} [timeZone] - Input as this time zone
 - @returns {**Date**} A Date object
 
-`parseTZ()` is upward compatible with `parse()`. Tokens available for `arg` are the same as those for `parse()`. `timeZone` in this function is used as supplemental information. if `dateString` contains a time zone offset value (i.e. -0800, +0900), `timeZone` is not be used. If `dateString` doesn't contain a time zone offset value and `timeZone` is omitted, this function assumes `timeZone` to be a local time zone. This means that the result is the same as when `parse()` is used.
+`parseTZ()` is upward compatible with `parse()`. Tokens available for `arg` are the same as those for `parse()`. `timeZone` in this function is used as supplemental information. if `dateString` contains a time zone offset value (i.e. -0800, +0900), `timeZone` is not be used. If `dateString` doesn't contain a time zone offset value and `timeZone` is omitted, this function assumes `timeZone` to be the local time zone. This means that the result is the same as when `parse()` is used.
 
 #### transformTZ(dateString, arg1, arg2[, timeZone])
 
@@ -318,7 +318,34 @@ It adds `formatTZ()`, `parseTZ()` and `transformTZ()` that support `IANA time zo
 - @param {**string**} [timeZone] - Output as this time zone
 - @returns {**string**} A formatted string
 
-`transformTZ()` is upward compatible with `transform()`. `dateString` must itself contain a time zone offset value (i.e. -0800, +0900), otherwise this function assumes it is a local time zone. Tokens available for `arg1` are the same as those for `parse()`, also tokens available for `arg2` are the same as those for `format()`. `timeZone` is a `IANA time zone names`, which is required to output a new formatted string. If it is omitted, this function assumes `timeZone` to be a local time zone. This means that the result is the same as when `transform()` is used.
+`transformTZ()` is upward compatible with `transform()`. `dateString` must itself contain a time zone offset value (i.e. -0800, +0900), otherwise this function assumes it is the local time zone. Tokens available for `arg1` are the same as those for `parse()`, also tokens available for `arg2` are the same as those for `format()`. `timeZone` is a `IANA time zone names`, which is required to output a new formatted string. If it is omitted, this function assumes `timeZone` to be the local time zone. This means that the result is the same as when `transform()` is used.
+
+#### addYearsTZ(dateObj, years[, timeZone])
+
+- @param {**Date**} dateObj - A Date object
+- @param {**number**} years - The number of years to add
+- @param {**string**} [timeZone] - The time zone to use for the calculation
+- @returns {**Date**} The Date object after adding the specified number of years
+
+`addYearsTZ()` can calculate adding years in the specified time zone regardless of the execution environment.
+
+#### addMonthsTZ(dateObj, months[, timeZone])
+
+- @param {**Date**} dateObj - A Date object
+- @param {**number**} months - The number of months to add
+- @param {**string**} [timeZone] - The time zone to use for the calculation
+- @returns {**Date**} The Date object after adding the specified number of months
+
+`addMonthsTZ()` can calculate adding months in the specified time zone regardless of the execution environment.
+
+#### addDaysTZ(dateObj, days[, timeZone])
+
+- @param {**Date**} dateObj - A Date object
+- @param {**number**} days - The number of days to add
+- @param {**string**} [timeZone] - The time zone to use for the calculation
+- @returns {**Date**} The Date object after adding the specified number of days
+
+`addDaysTZ()` can calculate adding days in the specified time zone regardless of the execution environment.
 
 ```javascript
 const date = require('date-and-time');
@@ -354,18 +381,20 @@ date.transformTZ('2021-03-14T03:00:00 UTC-0700', 'YYYY-MM-DD[T]HH:mm:ss [UTC]Z',
 
 #### Start of DST (Daylight Saving Time)
 
-For example, in the US, when local standard time is about to reach Sunday, 14 March 2021, `02:00:00` clocks are turned `forward` 1 hour to Sunday, 14 March 2021, `03:00:00` local daylight time instead. Thus there is no `02:00:00` to `02:59:59` on 14 March 2021. In such edge cases, `parseTZ()` will parse like this:
+For example, in the US, when local standard time is about to reach `02:00:00` on Sunday, 14 March 2021, the clocks are set `forward` by 1 hour to `03:00:00` local daylight time instead. As a result, the time from `02:00:00` to `02:59:59` on 14 March 2021 does not exist. In such edge cases, `parseTZ()` will handle the case in the following way:
 
 ```javascript
 date.parseTZ('Mar 14 2021 1:59:59', 'MMM D YYYY H:mm:ss', 'America/Los_Angeles'); // => 2021-03-14T09:59:59Z
-date.parseTZ('Mar 14 2021 2:00:00', 'MMM D YYYY H:mm:ss', 'America/Los_Angeles'); // => NaN
-date.parseTZ('Mar 14 2021 2:59:59', 'MMM D YYYY H:mm:ss', 'America/Los_Angeles'); // => NaN
 date.parseTZ('Mar 14 2021 3:00:00', 'MMM D YYYY H:mm:ss', 'America/Los_Angeles'); // => 2021-03-14T10:00:00Z
+
+// These times don't actually exist, but parseTZ() will handle as follows:
+date.parseTZ('Mar 14 2021 2:00:00', 'MMM D YYYY H:mm:ss', 'America/Los_Angeles'); // => 2021-03-14T10:00:00Z
+date.parseTZ('Mar 14 2021 2:59:59', 'MMM D YYYY H:mm:ss', 'America/Los_Angeles'); // => 2021-03-14T10:59:59Z
 ```
 
 #### End of DST
 
-Also, when local daylight time is about to reach Sunday, 7 November 2021, `02:00:00` clocks are turned `backward` 1 hour to Sunday, 7 November 2021, `01:00:00` local standard time instead. Thus `01:00:00` to `01:59:59` on November 7 2021 is repeated twice. Since there are two possible times here, `parseTZ()` assumes that the time is the former (DST) in order to make the result unique:
+Also, when local daylight time is about to reach `02:00:00` on Sunday, 7 November 2021, the clocks are set `back` by 1 hour to `01:00:00` local standard time instead. As a result, the time from `01:00:00` to `01:59:59` on 7 November 2021 occurs twice. Because this time period happens twice, `parseTZ()` assumes that the time is the earlier one (during DST) in order to make the result unique:
 
 ```javascript
 // This time is DST or PST? The parseTZ() always assumes that it is DST.

package/README.md

@@ -25,15 +25,16 @@ npm i date-and-time
 
 ## Recent Changes
 
-- 3.4.1
-  - Fixed an issue where `formatTZ()` would output 0:00 as 24:00 in 24-hour format in Node.js.
+- 3.6.0
+  - In `parseTZ()`, enabled parsing of the missing hour during the transition from standard time to daylight saving time into a Date type.
+  - In `format()` with the `z` token, fixed an issue where some short time zone names were incorrect.
 
-- 3.4.0
-  - Added `zz` (time zone name) and `z` (time zone name abbreviation) tokens to the `timezone` plugin.
-  - Fixed an issue where token extensions by other plugins were not reflected in functions provided by the `timezone` plugin.
+- 3.5.0
+  - Added `addYearsTZ()`, `addMonthsTZ()`, and `addDaysTZ()` to the `timezone` plugin.
+  - Revised the approach to adding time and removed the third parameter from `addHours()`, `addMinutes()`, `addSeconds()`, and `addMilliseconds()`.
 
-- 3.3.0
-  - Refactored `format()`, `isValid()`, and `preparse()`, further improved performance.
+- 3.4.1
+  - Fixed an issue where `formatTZ()` would output 0:00 as 24:00 in 24-hour format in Node.js.
 
 ## Usage
 
@@ -68,6 +69,16 @@ import date from '/path/to/date-and-time.es.min.js';
 ### Note
 
 - If you want to use ES Modules in Node.js without the transpiler, you need to add `"type": "module"` in your `package.json` or change your file extension from `.js` to `.mjs`.
+- If you are using TypeScript and having trouble building, please ensure that the following settings in the `compilerOptions` of your `tsconfig.json` are set to `true`.
+
+```json
+{
+  "compilerOptions": {
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true
+  }
+}
+```
 
 ## API
 
@@ -98,16 +109,16 @@ import date from '/path/to/date-and-time.es.min.js';
 - [addDays](#adddaysdateobj-days-utc)
   - Adding days
 
-- [addHours](#addhoursdateobj-hours-utc)
+- [addHours](#addhoursdateobj-hours)
   - Adding hours
 
-- [addMinutes](#addminutesdateobj-minutes-utc)
+- [addMinutes](#addminutesdateobj-minutes)
   - Adding minutes
 
-- [addSeconds](#addsecondsdateobj-seconds-utc)
+- [addSeconds](#addsecondsdateobj-seconds)
   - Adding seconds
 
-- [addMilliseconds](#addmillisecondsdateobj-milliseconds-utc)
+- [addMilliseconds](#addmillisecondsdateobj-milliseconds)
   - Adding milliseconds
 
 - [subtract](#subtractdate1-date2)
@@ -434,11 +445,11 @@ date.transform('13:05', 'HH:mm', 'hh:mm A');
 ### addYears(dateObj, years[, utc])
 
 - @param {**Date**} dateObj - A Date object
-- @param {**number**} years - Number of years to add
-- @param {**boolean**} [utc] - Calculates as UTC `Added in: v3.0.0`
-- @returns {**Date**} The Date object after adding the value
+- @param {**number**} years - The number of years to add
+- @param {**boolean**} [utc] - If true, calculates the date in UTC `Added in: v3.0.0`
+- @returns {**Date**} The Date object after adding the specified number of years
 
-Adds years to the date object.
+Adds years to a date object. Subtraction is also possible by specifying a negative value. If the third parameter is false or omitted, this function calculates based on the system's default time zone. If you need to obtain calculation results based on a specific time zone regardless of the execution system, consider using the `addYearsTZ()`, which allows you to specify a time zone name as the third parameter. See [PLUGINS.md](./PLUGINS.md) for details.
 
 ```javascript
 const now = new Date();
@@ -456,11 +467,11 @@ const next_next_year = date.addYears(next_year, 1, true);   // => Feb 28 2022
 ### addMonths(dateObj, months[, utc])
 
 - @param {**Date**} dateObj - A Date object
-- @param {**number**} months - Number of months to add
-- @param {**boolean**} [utc] - Calculates as UTC `Added in: v3.0.0`
-- @returns {**Date**} The Date object after adding the value
+- @param {**number**} months - The number of months to add
+- @param {**boolean**} [utc] - If true, calculates the date in UTC `Added in: v3.0.0`
+- @returns {**Date**} The Date object after adding the specified number of months
 
-Adds months to the date object.
+Adds months to a date object. Subtraction is also possible by specifying a negative value. If the third parameter is false or omitted, this function calculates based on the system's default time zone. If you need to obtain calculation results based on a specific time zone regardless of the execution system, consider using the `addMonthsTZ()`, which allows you to specify a time zone name as the third parameter. See [PLUGINS.md](./PLUGINS.md) for details.
 
 ```javascript
 const now = new Date();
@@ -478,57 +489,67 @@ const next_next_month = date.addMonths(next_month, 1, true);    // => Mar 28 202
 ### addDays(dateObj, days[, utc])
 
 - @param {**Date**} dateObj - A Date object
-- @param {**number**} days - Number of days to add
-- @param {**boolean**} [utc] - Calculates as UTC `Added in: v3.0.0`
-- @returns {**Date**} The Date object after adding the value
+- @param {**number**} days - The number of days to add
+- @param {**boolean**} [utc] - If true, calculates the date in UTC `Added in: v3.0.0`
+- @returns {**Date**} The Date object after adding the specified number of days
+
+Adds days to a date object. Subtraction is also possible by specifying a negative value. If the third parameter is false or omitted, this function calculates based on the system's default time zone. If you need to obtain calculation results based on a specific time zone regardless of the execution system, consider using the `addDaysTZ()`, which allows you to specify a time zone name as the third parameter. See [PLUGINS.md](./PLUGINS.md) for details.
 
 ```javascript
 const now = new Date();
 const yesterday = date.addDays(now, -1);
 ```
 
-### addHours(dateObj, hours[, utc])
+### addHours(dateObj, hours)
 
 - @param {**Date**} dateObj - A Date object
-- @param {**number**} hours - Number of hours to add
-- @param {**boolean**} [utc] - Calculates as UTC `Added in: v3.0.0`
-- @returns {**Date**} The Date object after adding the value
+- @param {**number**} hours - The number of hours to add
+- ~~@param {**boolean**} [utc] - If true, calculates the date in UTC `Added in: v3.0.0`~~ `Removed in: v3.5.0`
+- @returns {**Date**} The Date object after adding the specified number of hours
+
+Adds hours to a date object. Subtraction is also possible by specifying a negative value. The third parameter was deprecated in version 3.5.0. Regardless of what is specified for this parameter, the calculation results will not change.
 
 ```javascript
 const now = new Date();
 const an_hour_ago = date.addHours(now, -1);
 ```
 
-### addMinutes(dateObj, minutes[, utc])
+### addMinutes(dateObj, minutes)
 
 - @param {**Date**} dateObj - A Date object
-- @param {**number**} minutes - Number of minutes to add
-- @param {**boolean**} [utc] - Calculates as UTC `Added in: v3.0.0`
-- @returns {**Date**} The Date object after adding the value
+- @param {**number**} minutes - The number of minutes to add
+- ~~@param {**boolean**} [utc] - If true, calculates the date in UTC `Added in: v3.0.0`~~ `Removed in: v3.5.0`
+- @returns {**Date**} The Date object after adding the specified number of minutes
+
+Adds minutes to a date object. Subtraction is also possible by specifying a negative value. The third parameter was deprecated in version 3.5.0. Regardless of what is specified for this parameter, the calculation results will not change.
 
 ```javascript
 const now = new Date();
 const two_minutes_later = date.addMinutes(now, 2);
 ```
 
-### addSeconds(dateObj, seconds[, utc])
+### addSeconds(dateObj, seconds)
 
 - @param {**Date**} dateObj - A Date object
-- @param {**number**} seconds - Number of seconds to add
-- @param {**boolean**} [utc] - Calculates as UTC `Added in: v3.0.0`
-- @returns {**Date**} The Date object after adding the value
+- @param {**number**} seconds - The number of seconds to add
+- ~~@param {**boolean**} [utc] - If true, calculates the date in UTC `Added in: v3.0.0`~~ `Removed in: v3.5.0`
+- @returns {**Date**} The Date object after adding the specified number of seconds
+
+Adds seconds to a date object. Subtraction is also possible by specifying a negative value. The third parameter was deprecated in version 3.5.0. Regardless of what is specified for this parameter, the calculation results will not change.
 
 ```javascript
 const now = new Date();
 const three_seconds_ago = date.addSeconds(now, -3);
 ```
 
-### addMilliseconds(dateObj, milliseconds[, utc])
+### addMilliseconds(dateObj, milliseconds)
 
 - @param {**Date**} dateObj - A Date object
-- @param {**number**} milliseconds - Number of milliseconds to add
-- @param {**boolean**} [utc] - Calculates as UTC `Added in: v3.0.0`
-- @returns {**Date**} The Date object after adding the value
+- @param {**number**} milliseconds - The number of milliseconds to add
+- ~~@param {**boolean**} [utc] - If true, calculates the date in UTC `Added in: v3.0.0`~~ `Removed in: v3.5.0`
+- @returns {**Date**} The Date object after adding the specified number of milliseconds
+
+Adds milliseconds to a date object. Subtraction is also possible by specifying a negative value. The third parameter was deprecated in version 3.5.0. Regardless of what is specified for this parameter, the calculation results will not change.
 
 ```javascript
 const now = new Date();

package/date-and-time.d.ts

@@ -153,63 +153,95 @@ export function transform(dateString: string, compiledObj1: string[], compiledOb
 /**
  * Adding years
  * @param dateObj - A Date object
- * @param years - Number of years to add
- * @param [utc] - Calculates as UTC
- * @returns The Date object after adding the value
+ * @param years - The number of years to add
+ * @param [utc] - If true, calculates the date in UTC
+ * @returns The Date object after adding the specified number of years
  */
 export function addYears(dateObj: Date, years: number, utc?: boolean): Date;
 
 /**
  * Adding months
  * @param dateObj - A Date object
- * @param months - Number of months to add
- * @param [utc] - Calculates as UTC
- * @returns The Date object after adding the value
+ * @param months - The number of months to add
+ * @param [utc] - If true, calculates the date in UTC
+ * @returns The Date object after adding the specified number of months
  */
 export function addMonths(dateObj: Date, months: number, utc?: boolean): Date;
 
 /**
  * Adding days
  * @param dateObj - A Date object
- * @param days - Number of days to add
- * @param [utc] - Calculates as UTC
- * @returns The Date object after adding the value
+ * @param days - The number of days to add
+ * @param [utc] - If true, calculates the date in UTC
+ * @returns The Date object after adding the specified number of days
  */
 export function addDays(dateObj: Date, days: number, utc?: boolean): Date;
 
 /**
  * Adding hours
  * @param dateObj - A Date object
- * @param hours - Number of hours to add
- * @param [utc] - Calculates as UTC
- * @returns The Date object after adding the value
+ * @param hours - The number of hours to add
+ * @returns The Date object after adding the specified number of hours
+ */
+export function addHours(dateObj: Date, hours: number): Date;
+
+/**
+ * @deprecated The `utc` parameter is ignored. The function always returns the same result regardless of this value.
+ * @param dateObj - A Date object
+ * @param hours - The number of hours to add
+ * @param [utc] - If true, calculates the date in UTC
+ * @returns The Date object after adding the specified number of hours
  */
 export function addHours(dateObj: Date, hours: number, utc?: boolean): Date;
 
 /**
  * Adding minutes
  * @param dateObj - A Date object
- * @param minutes - Number of minutes to add
- * @param [utc] - Calculates as UTC
- * @returns The Date object after adding the value
+ * @param minutes - The number of minutes to add
+ * @returns The Date object after adding the specified number of minutes
+ */
+export function addMinutes(dateObj: Date, minutes: number): Date;
+
+/**
+ * @deprecated The `utc` parameter is ignored. The function always returns the same result regardless of this value.
+ * @param dateObj - A Date object
+ * @param minutes - The number of minutes to add
+ * @param [utc] - If true, calculates the date in UTC
+ * @returns The Date object after adding the specified number of minutes
  */
 export function addMinutes(dateObj: Date, minutes: number, utc?: boolean): Date;
 
 /**
  * Adding seconds
  * @param dateObj - A Date object
- * @param seconds - Number of seconds to add
- * @param [utc] - Calculates as UTC
- * @returns The Date object after adding the value
+ * @param seconds - The number of seconds to add
+ * @returns The Date object after adding the specified number of seconds
+ */
+export function addSeconds(dateObj: Date, seconds: number): Date;
+
+/**
+ * @deprecated The `utc` parameter is ignored. The function always returns the same result regardless of this value.
+ * @param dateObj - A Date object
+ * @param seconds - The number of seconds to add
+ * @param [utc] - If true, calculates the date in UTC
+ * @returns The Date object after adding the specified number of seconds
  */
 export function addSeconds(dateObj: Date, seconds: number, utc?: boolean): Date;
 
 /**
  * Adding milliseconds
  * @param dateObj - A Date object
- * @param milliseconds - Number of milliseconds to add
- * @param [utc] - Calculates as UTC
- * @returns The Date object after adding the value
+ * @param milliseconds - The number of milliseconds to add
+ * @returns The Date object after adding the specified number of milliseconds
+ */
+export function addMilliseconds(dateObj: Date, milliseconds: number): Date;
+
+/**
+ * @deprecated The `utc` parameter is ignored. The function always returns the same result regardless of this value.
+ * @param dateObj - A Date object
+ * @param milliseconds - The number of milliseconds to add
+ * @param [utc] - If true, calculates the date in UTC
+ * @returns The Date object after adding the specified number of milliseconds
  */
 export function addMilliseconds(dateObj: Date, milliseconds: number, utc?: boolean): Date;
 

package/date-and-time.js

@@ -309,12 +309,14 @@
         if (utc) {
             d.setUTCMonth(d.getUTCMonth() + months);
             if (d.getUTCDate() < dateObj.getUTCDate()) {
-                return (this || date).addDays(d, -d.getUTCDate(), utc);
+                d.setUTCDate(0);
+                return d;
             }
         } else {
             d.setMonth(d.getMonth() + months);
             if (d.getDate() < dateObj.getDate()) {
-                return (this || date).addDays(d, -d.getDate(), utc);
+                d.setDate(0);
+                return d;
             }
         }
         return d;
@@ -328,58 +330,54 @@
      * @returns {Date} The Date object after adding the value
      */
     proto.addDays = function (dateObj, days, utc) {
-        return (this || date).addHours(dateObj, days * 24, utc);
+        var d = new Date(dateObj.getTime());
+
+        if (utc) {
+            d.setUTCDate(d.getUTCDate() + days);
+        } else {
+            d.setDate(d.getDate() + days);
+        }
+        return d;
     };
 
     /**
      * Adding hours
      * @param {Date} dateObj - A Date object
      * @param {number} hours - Number of hours to add
-     * @param {boolean} [utc] - Calculates as UTC
      * @returns {Date} The Date object after adding the value
      */
-    proto.addHours = function (dateObj, hours, utc) {
-        return (this || date).addMinutes(dateObj, hours * 60, utc);
+    proto.addHours = function (dateObj, hours) {
+        return new Date(dateObj.getTime() + hours * 60 * 60 * 1000);
     };
 
     /**
      * Adding minutes
      * @param {Date} dateObj - A Date object
      * @param {number} minutes - Number of minutes to add
-     * @param {boolean} [utc] - Calculates as UTC
      * @returns {Date} The Date object after adding the value
      */
-    proto.addMinutes = function (dateObj, minutes, utc) {
-        return (this || date).addSeconds(dateObj, minutes * 60, utc);
+    proto.addMinutes = function (dateObj, minutes) {
+        return new Date(dateObj.getTime() + minutes * 60 * 1000);
     };
 
     /**
      * Adding seconds
      * @param {Date} dateObj - A Date object
      * @param {number} seconds - Number of seconds to add
-     * @param {boolean} [utc] - Calculates as UTC
      * @returns {Date} The Date object after adding the value
      */
-    proto.addSeconds = function (dateObj, seconds, utc) {
-        return (this || date).addMilliseconds(dateObj, seconds * 1000, utc);
+    proto.addSeconds = function (dateObj, seconds) {
+        return new Date(dateObj.getTime() + seconds * 1000);
     };
 
     /**
      * Adding milliseconds
      * @param {Date} dateObj - A Date object
      * @param {number} milliseconds - Number of milliseconds to add
-     * @param {boolean} [utc] - Calculates as UTC
      * @returns {Date} The Date object after adding the value
      */
-    proto.addMilliseconds = function (dateObj, milliseconds, utc) {
-        var d = new Date(dateObj.getTime());
-
-        if (utc) {
-            d.setUTCMilliseconds(d.getUTCMilliseconds() + milliseconds);
-        } else {
-            d.setMilliseconds(d.getMilliseconds() + milliseconds);
-        }
-        return d;
+    proto.addMilliseconds = function (dateObj, milliseconds) {
+        return new Date(dateObj.getTime() + milliseconds);
     };
 
     /**

package/date-and-time.min.js

@@ -1,4 +1,4 @@
 !function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define(t):(e="undefined"!=typeof globalThis?globalThis:e||self).date=t()}(this,(function(){"use strict";
 /**
      * @preserve date-and-time (c) KNOWLEDGECODE | MIT
-     */var e,t={},n={},r="en",i={MMMM:["January","February","March","April","May","June","July","August","September","October","November","December"],MMM:["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"],dddd:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],ddd:["Sun","Mon","Tue","Wed","Thu","Fri","Sat"],dd:["Su","Mo","Tu","We","Th","Fr","Sa"],A:["AM","PM"]},u={YYYY:function(e){return("000"+e.getFullYear()).slice(-4)},YY:function(e){return("0"+e.getFullYear()).slice(-2)},Y:function(e){return""+e.getFullYear()},MMMM:function(e){return this.res.MMMM[e.getMonth()]},MMM:function(e){return this.res.MMM[e.getMonth()]},MM:function(e){return("0"+(e.getMonth()+1)).slice(-2)},M:function(e){return""+(e.getMonth()+1)},DD:function(e){return("0"+e.getDate()).slice(-2)},D:function(e){return""+e.getDate()},HH:function(e){return("0"+e.getHours()).slice(-2)},H:function(e){return""+e.getHours()},A:function(e){return this.res.A[e.getHours()>11|0]},hh:function(e){return("0"+(e.getHours()%12||12)).slice(-2)},h:function(e){return""+(e.getHours()%12||12)},mm:function(e){return("0"+e.getMinutes()).slice(-2)},m:function(e){return""+e.getMinutes()},ss:function(e){return("0"+e.getSeconds()).slice(-2)},s:function(e){return""+e.getSeconds()},SSS:function(e){return("00"+e.getMilliseconds()).slice(-3)},SS:function(e){return("0"+(e.getMilliseconds()/10|0)).slice(-2)},S:function(e){return""+(e.getMilliseconds()/100|0)},dddd:function(e){return this.res.dddd[e.getDay()]},ddd:function(e){return this.res.ddd[e.getDay()]},dd:function(e){return this.res.dd[e.getDay()]},Z:function(e){var t=e.getTimezoneOffset()/.6|0;return(t>0?"-":"+")+("000"+Math.abs(t-(t%100*.4|0))).slice(-4)},ZZ:function(e){var t=e.getTimezoneOffset(),n=Math.abs(t);return(t>0?"-":"+")+("0"+(n/60|0)).slice(-2)+":"+("0"+n%60).slice(-2)},post:function(e){return e},res:i},o={YYYY:function(e){return this.exec(/^\d{4}/,e)},Y:function(e){return this.exec(/^\d{1,4}/,e)},MMMM:function(e){var t=this.find(this.res.MMMM,e);return t.value++,t},MMM:function(e){var t=this.find(this.res.MMM,e);return t.value++,t},MM:function(e){return this.exec(/^\d\d/,e)},M:function(e){return this.exec(/^\d\d?/,e)},DD:function(e){return this.exec(/^\d\d/,e)},D:function(e){return this.exec(/^\d\d?/,e)},HH:function(e){return this.exec(/^\d\d/,e)},H:function(e){return this.exec(/^\d\d?/,e)},A:function(e){return this.find(this.res.A,e)},hh:function(e){return this.exec(/^\d\d/,e)},h:function(e){return this.exec(/^\d\d?/,e)},mm:function(e){return this.exec(/^\d\d/,e)},m:function(e){return this.exec(/^\d\d?/,e)},ss:function(e){return this.exec(/^\d\d/,e)},s:function(e){return this.exec(/^\d\d?/,e)},SSS:function(e){return this.exec(/^\d{1,3}/,e)},SS:function(e){var t=this.exec(/^\d\d?/,e);return t.value*=10,t},S:function(e){var t=this.exec(/^\d/,e);return t.value*=100,t},Z:function(e){var t=this.exec(/^[+-]\d{2}[0-5]\d/,e);return t.value=-60*(t.value/100|0)-t.value%100,t},ZZ:function(e){var t=/^([+-])(\d{2}):([0-5]\d)/.exec(e)||["","","",""];return{value:0-(60*(t[1]+t[2]|0)+(t[1]+t[3]|0)),length:t[0].length}},h12:function(e,t){return(12===e?0:e)+12*t},exec:function(e,t){var n=(e.exec(t)||[""])[0];return{value:0|n,length:n.length}},find:function(e,t){for(var n,r=-1,i=0,u=0,o=e.length;u<o;u++)n=e[u],!t.indexOf(n)&&n.length>i&&(r=u,i=n.length);return{value:r,length:i}},pre:function(e){return e},res:i},s=function(e,t,n,r){var i,u={};for(i in e)u[i]=e[i];for(i in t||{})!!n^!!u[i]||(u[i]=t[i]);return r&&(u.res=r),u},c={_formatter:u,_parser:o};return c.compile=function(e){return[e].concat(e.match(/\[(?:[^[\]]|\[[^[\]]*])*]|([A-Za-z])\1*|\.{3}|./g)||[])},c.format=function(t,n,r){for(var i,u=this||e,o="string"==typeof n?u.compile(n):n,s=u._formatter,c=function(){if(r){var e=new Date(t.getTime());return e.getFullYear=e.getUTCFullYear,e.getMonth=e.getUTCMonth,e.getDate=e.getUTCDate,e.getHours=e.getUTCHours,e.getMinutes=e.getUTCMinutes,e.getSeconds=e.getUTCSeconds,e.getMilliseconds=e.getUTCMilliseconds,e.getDay=e.getUTCDay,e.getTimezoneOffset=function(){return 0},e.getTimezoneName=function(){return"UTC"},e}return t}(),a=/^\[(.*)\]$/,d="",f=1,l=o.length;f<l;f++)d+=s[i=o[f]]?s.post(s[i](c,o[0])):a.test(i)?i.replace(a,"$1"):i;return d},c.preparse=function(t,n){var r=this||e,i="string"==typeof n?r.compile(n):n,u=r._parser,o={Y:1970,M:1,D:1,H:0,A:0,h:0,m:0,s:0,S:0,Z:0,_index:0,_length:0,_match:0},s=/^\[(.*)\]$/;t=u.pre(t);for(var c,a,d,f=1,l=i.length;f<l;f++)if(c=i[f],a=t.substring(o._index),u[c]){if(!(d=u[c](a,i[0])).length)break;o[d.token||c.charAt(0)]=d.value,o._index+=d.length,o._match++}else if(c===a.charAt(0)||" "===c)o._index++;else{if(!s.test(c)||a.indexOf(c.replace(s,"$1"))){if("..."===c){o._index=t.length;break}break}o._index+=c.length-2}return o.H=o.H||u.h12(o.h,o.A),o._length=t.length,o},c.parse=function(t,n,r){var i=this||e,u="string"==typeof n?i.compile(n):n,o=i.preparse(t,u);return i.isValid(o)?(o.M-=o.Y<100?22801:1,r||~i._parser.find(u,"ZZ").value?new Date(Date.UTC(o.Y,o.M,o.D,o.H,o.m+o.Z,o.s,o.S)):new Date(o.Y,o.M,o.D,o.H,o.m,o.s,o.S)):new Date(NaN)},c.isValid=function(t,n){var r="string"==typeof t?(this||e).preparse(t,n):t;return!(r._index<1||r._length<1||r._index-r._length||r._match<1||r.Y<1||r.Y>9999||r.M<1||r.M>12||r.D<1||r.D>new Date(r.Y,r.M,0).getDate()||r.H<0||r.H>23||r.m<0||r.m>59||r.s<0||r.s>59||r.S<0||r.S>999||r.Z<-840||r.Z>720)},c.transform=function(t,n,r,i){const u=this||e;return u.format(u.parse(t,n),r,i)},c.addYears=function(t,n,r){return(this||e).addMonths(t,12*n,r)},c.addMonths=function(t,n,r){var i=new Date(t.getTime());if(r){if(i.setUTCMonth(i.getUTCMonth()+n),i.getUTCDate()<t.getUTCDate())return(this||e).addDays(i,-i.getUTCDate(),r)}else if(i.setMonth(i.getMonth()+n),i.getDate()<t.getDate())return(this||e).addDays(i,-i.getDate(),r);return i},c.addDays=function(t,n,r){return(this||e).addHours(t,24*n,r)},c.addHours=function(t,n,r){return(this||e).addMinutes(t,60*n,r)},c.addMinutes=function(t,n,r){return(this||e).addSeconds(t,60*n,r)},c.addSeconds=function(t,n,r){return(this||e).addMilliseconds(t,1e3*n,r)},c.addMilliseconds=function(e,t,n){var r=new Date(e.getTime());return n?r.setUTCMilliseconds(r.getUTCMilliseconds()+t):r.setMilliseconds(r.getMilliseconds()+t),r},c.subtract=function(e,t){var n=e.getTime()-t.getTime();return{toMilliseconds:function(){return n},toSeconds:function(){return n/1e3},toMinutes:function(){return n/6e4},toHours:function(){return n/36e5},toDays:function(){return n/864e5}}},c.isLeapYear=function(e){return!((e%4||!(e%100))&&e%400)},c.isSameDay=function(e,t){return e.toDateString()===t.toDateString()},c.locale=function(e,n){t[e]||(t[e]=n)},c.plugin=function(e,t){n[e]||(n[e]=t)},(e=s(c)).locale=function(a){var d="function"==typeof a?a:e.locale[a];if(!d)return r;r=d(c);var f=t[r]||{},l=s(i,f.res,!0),h=s(u,f.formatter,!0,l),g=s(o,f.parser,!0,l);for(var M in e._formatter=h,e._parser=g,n)e.extend(n[M]);return r},e.extend=function(t){var n=s(e._parser.res,t.res),r=t.extender||{};for(var i in e._formatter=s(e._formatter,t.formatter,!1,n),e._parser=s(e._parser,t.parser,!1,n),r)e[i]||(e[i]=r[i])},e.plugin=function(t){var r="function"==typeof t?t:e.plugin[t];r&&e.extend(n[r(c,e)]||{})},e}));
+     */var e,t={},n={},r="en",u={MMMM:["January","February","March","April","May","June","July","August","September","October","November","December"],MMM:["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"],dddd:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],ddd:["Sun","Mon","Tue","Wed","Thu","Fri","Sat"],dd:["Su","Mo","Tu","We","Th","Fr","Sa"],A:["AM","PM"]},i={YYYY:function(e){return("000"+e.getFullYear()).slice(-4)},YY:function(e){return("0"+e.getFullYear()).slice(-2)},Y:function(e){return""+e.getFullYear()},MMMM:function(e){return this.res.MMMM[e.getMonth()]},MMM:function(e){return this.res.MMM[e.getMonth()]},MM:function(e){return("0"+(e.getMonth()+1)).slice(-2)},M:function(e){return""+(e.getMonth()+1)},DD:function(e){return("0"+e.getDate()).slice(-2)},D:function(e){return""+e.getDate()},HH:function(e){return("0"+e.getHours()).slice(-2)},H:function(e){return""+e.getHours()},A:function(e){return this.res.A[e.getHours()>11|0]},hh:function(e){return("0"+(e.getHours()%12||12)).slice(-2)},h:function(e){return""+(e.getHours()%12||12)},mm:function(e){return("0"+e.getMinutes()).slice(-2)},m:function(e){return""+e.getMinutes()},ss:function(e){return("0"+e.getSeconds()).slice(-2)},s:function(e){return""+e.getSeconds()},SSS:function(e){return("00"+e.getMilliseconds()).slice(-3)},SS:function(e){return("0"+(e.getMilliseconds()/10|0)).slice(-2)},S:function(e){return""+(e.getMilliseconds()/100|0)},dddd:function(e){return this.res.dddd[e.getDay()]},ddd:function(e){return this.res.ddd[e.getDay()]},dd:function(e){return this.res.dd[e.getDay()]},Z:function(e){var t=e.getTimezoneOffset()/.6|0;return(t>0?"-":"+")+("000"+Math.abs(t-(t%100*.4|0))).slice(-4)},ZZ:function(e){var t=e.getTimezoneOffset(),n=Math.abs(t);return(t>0?"-":"+")+("0"+(n/60|0)).slice(-2)+":"+("0"+n%60).slice(-2)},post:function(e){return e},res:u},o={YYYY:function(e){return this.exec(/^\d{4}/,e)},Y:function(e){return this.exec(/^\d{1,4}/,e)},MMMM:function(e){var t=this.find(this.res.MMMM,e);return t.value++,t},MMM:function(e){var t=this.find(this.res.MMM,e);return t.value++,t},MM:function(e){return this.exec(/^\d\d/,e)},M:function(e){return this.exec(/^\d\d?/,e)},DD:function(e){return this.exec(/^\d\d/,e)},D:function(e){return this.exec(/^\d\d?/,e)},HH:function(e){return this.exec(/^\d\d/,e)},H:function(e){return this.exec(/^\d\d?/,e)},A:function(e){return this.find(this.res.A,e)},hh:function(e){return this.exec(/^\d\d/,e)},h:function(e){return this.exec(/^\d\d?/,e)},mm:function(e){return this.exec(/^\d\d/,e)},m:function(e){return this.exec(/^\d\d?/,e)},ss:function(e){return this.exec(/^\d\d/,e)},s:function(e){return this.exec(/^\d\d?/,e)},SSS:function(e){return this.exec(/^\d{1,3}/,e)},SS:function(e){var t=this.exec(/^\d\d?/,e);return t.value*=10,t},S:function(e){var t=this.exec(/^\d/,e);return t.value*=100,t},Z:function(e){var t=this.exec(/^[+-]\d{2}[0-5]\d/,e);return t.value=-60*(t.value/100|0)-t.value%100,t},ZZ:function(e){var t=/^([+-])(\d{2}):([0-5]\d)/.exec(e)||["","","",""];return{value:0-(60*(t[1]+t[2]|0)+(t[1]+t[3]|0)),length:t[0].length}},h12:function(e,t){return(12===e?0:e)+12*t},exec:function(e,t){var n=(e.exec(t)||[""])[0];return{value:0|n,length:n.length}},find:function(e,t){for(var n,r=-1,u=0,i=0,o=e.length;i<o;i++)n=e[i],!t.indexOf(n)&&n.length>u&&(r=i,u=n.length);return{value:r,length:u}},pre:function(e){return e},res:u},s=function(e,t,n,r){var u,i={};for(u in e)i[u]=e[u];for(u in t||{})!!n^!!i[u]||(i[u]=t[u]);return r&&(i.res=r),i},a={_formatter:i,_parser:o};return a.compile=function(e){return[e].concat(e.match(/\[(?:[^[\]]|\[[^[\]]*])*]|([A-Za-z])\1*|\.{3}|./g)||[])},a.format=function(t,n,r){for(var u,i=this||e,o="string"==typeof n?i.compile(n):n,s=i._formatter,a=function(){if(r){var e=new Date(t.getTime());return e.getFullYear=e.getUTCFullYear,e.getMonth=e.getUTCMonth,e.getDate=e.getUTCDate,e.getHours=e.getUTCHours,e.getMinutes=e.getUTCMinutes,e.getSeconds=e.getUTCSeconds,e.getMilliseconds=e.getUTCMilliseconds,e.getDay=e.getUTCDay,e.getTimezoneOffset=function(){return 0},e.getTimezoneName=function(){return"UTC"},e}return t}(),c=/^\[(.*)\]$/,f="",d=1,l=o.length;d<l;d++)f+=s[u=o[d]]?s.post(s[u](a,o[0])):c.test(u)?u.replace(c,"$1"):u;return f},a.preparse=function(t,n){var r=this||e,u="string"==typeof n?r.compile(n):n,i=r._parser,o={Y:1970,M:1,D:1,H:0,A:0,h:0,m:0,s:0,S:0,Z:0,_index:0,_length:0,_match:0},s=/^\[(.*)\]$/;t=i.pre(t);for(var a,c,f,d=1,l=u.length;d<l;d++)if(a=u[d],c=t.substring(o._index),i[a]){if(!(f=i[a](c,u[0])).length)break;o[f.token||a.charAt(0)]=f.value,o._index+=f.length,o._match++}else if(a===c.charAt(0)||" "===a)o._index++;else{if(!s.test(a)||c.indexOf(a.replace(s,"$1"))){if("..."===a){o._index=t.length;break}break}o._index+=a.length-2}return o.H=o.H||i.h12(o.h,o.A),o._length=t.length,o},a.parse=function(t,n,r){var u=this||e,i="string"==typeof n?u.compile(n):n,o=u.preparse(t,i);return u.isValid(o)?(o.M-=o.Y<100?22801:1,r||~u._parser.find(i,"ZZ").value?new Date(Date.UTC(o.Y,o.M,o.D,o.H,o.m+o.Z,o.s,o.S)):new Date(o.Y,o.M,o.D,o.H,o.m,o.s,o.S)):new Date(NaN)},a.isValid=function(t,n){var r="string"==typeof t?(this||e).preparse(t,n):t;return!(r._index<1||r._length<1||r._index-r._length||r._match<1||r.Y<1||r.Y>9999||r.M<1||r.M>12||r.D<1||r.D>new Date(r.Y,r.M,0).getDate()||r.H<0||r.H>23||r.m<0||r.m>59||r.s<0||r.s>59||r.S<0||r.S>999||r.Z<-840||r.Z>720)},a.transform=function(t,n,r,u){const i=this||e;return i.format(i.parse(t,n),r,u)},a.addYears=function(t,n,r){return(this||e).addMonths(t,12*n,r)},a.addMonths=function(e,t,n){var r=new Date(e.getTime());if(n){if(r.setUTCMonth(r.getUTCMonth()+t),r.getUTCDate()<e.getUTCDate())return r.setUTCDate(0),r}else if(r.setMonth(r.getMonth()+t),r.getDate()<e.getDate())return r.setDate(0),r;return r},a.addDays=function(e,t,n){var r=new Date(e.getTime());return n?r.setUTCDate(r.getUTCDate()+t):r.setDate(r.getDate()+t),r},a.addHours=function(e,t){return new Date(e.getTime()+60*t*60*1e3)},a.addMinutes=function(e,t){return new Date(e.getTime()+60*t*1e3)},a.addSeconds=function(e,t){return new Date(e.getTime()+1e3*t)},a.addMilliseconds=function(e,t){return new Date(e.getTime()+t)},a.subtract=function(e,t){var n=e.getTime()-t.getTime();return{toMilliseconds:function(){return n},toSeconds:function(){return n/1e3},toMinutes:function(){return n/6e4},toHours:function(){return n/36e5},toDays:function(){return n/864e5}}},a.isLeapYear=function(e){return!((e%4||!(e%100))&&e%400)},a.isSameDay=function(e,t){return e.toDateString()===t.toDateString()},a.locale=function(e,n){t[e]||(t[e]=n)},a.plugin=function(e,t){n[e]||(n[e]=t)},(e=s(a)).locale=function(c){var f="function"==typeof c?c:e.locale[c];if(!f)return r;r=f(a);var d=t[r]||{},l=s(u,d.res,!0),g=s(i,d.formatter,!0,l),h=s(o,d.parser,!0,l);for(var M in e._formatter=g,e._parser=h,n)e.extend(n[M]);return r},e.extend=function(t){var n=s(e._parser.res,t.res),r=t.extender||{};for(var u in e._formatter=s(e._formatter,t.formatter,!1,n),e._parser=s(e._parser,t.parser,!1,n),r)e[u]||(e[u]=r[u])},e.plugin=function(t){var r="function"==typeof t?t:e.plugin[t];r&&e.extend(n[r(a,e)]||{})},e}));

package/esm/date-and-time.es.js

@@ -303,12 +303,14 @@ proto.addMonths = function (dateObj, months, utc) {
     if (utc) {
         d.setUTCMonth(d.getUTCMonth() + months);
         if (d.getUTCDate() < dateObj.getUTCDate()) {
-            return (this || date).addDays(d, -d.getUTCDate(), utc);
+            d.setUTCDate(0);
+            return d;
         }
     } else {
         d.setMonth(d.getMonth() + months);
         if (d.getDate() < dateObj.getDate()) {
-            return (this || date).addDays(d, -d.getDate(), utc);
+            d.setDate(0);
+            return d;
         }
     }
     return d;
@@ -322,58 +324,54 @@ proto.addMonths = function (dateObj, months, utc) {
  * @returns {Date} The Date object after adding the value
  */
 proto.addDays = function (dateObj, days, utc) {
-    return (this || date).addHours(dateObj, days * 24, utc);
+    var d = new Date(dateObj.getTime());
+
+    if (utc) {
+        d.setUTCDate(d.getUTCDate() + days);
+    } else {
+        d.setDate(d.getDate() + days);
+    }
+    return d;
 };
 
 /**
  * Adding hours
  * @param {Date} dateObj - A Date object
  * @param {number} hours - Number of hours to add
- * @param {boolean} [utc] - Calculates as UTC
  * @returns {Date} The Date object after adding the value
  */
-proto.addHours = function (dateObj, hours, utc) {
-    return (this || date).addMinutes(dateObj, hours * 60, utc);
+proto.addHours = function (dateObj, hours) {
+    return new Date(dateObj.getTime() + hours * 60 * 60 * 1000);
 };
 
 /**
  * Adding minutes
  * @param {Date} dateObj - A Date object
  * @param {number} minutes - Number of minutes to add
- * @param {boolean} [utc] - Calculates as UTC
  * @returns {Date} The Date object after adding the value
  */
-proto.addMinutes = function (dateObj, minutes, utc) {
-    return (this || date).addSeconds(dateObj, minutes * 60, utc);
+proto.addMinutes = function (dateObj, minutes) {
+    return new Date(dateObj.getTime() + minutes * 60 * 1000);
 };
 
 /**
  * Adding seconds
  * @param {Date} dateObj - A Date object
  * @param {number} seconds - Number of seconds to add
- * @param {boolean} [utc] - Calculates as UTC
  * @returns {Date} The Date object after adding the value
  */
-proto.addSeconds = function (dateObj, seconds, utc) {
-    return (this || date).addMilliseconds(dateObj, seconds * 1000, utc);
+proto.addSeconds = function (dateObj, seconds) {
+    return new Date(dateObj.getTime() + seconds * 1000);
 };
 
 /**
  * Adding milliseconds
  * @param {Date} dateObj - A Date object
  * @param {number} milliseconds - Number of milliseconds to add
- * @param {boolean} [utc] - Calculates as UTC
  * @returns {Date} The Date object after adding the value
  */
-proto.addMilliseconds = function (dateObj, milliseconds, utc) {
-    var d = new Date(dateObj.getTime());
-
-    if (utc) {
-        d.setUTCMilliseconds(d.getUTCMilliseconds() + milliseconds);
-    } else {
-        d.setMilliseconds(d.getMilliseconds() + milliseconds);
-    }
-    return d;
+proto.addMilliseconds = function (dateObj, milliseconds) {
+    return new Date(dateObj.getTime() + milliseconds);
 };
 
 /**