date-and-time 2.4.3 → 3.0.0

package/README.md

@@ -25,15 +25,15 @@ npm i date-and-time
 
 ## Recent Changes
 
+- 3.0.0
+  - **Breaking Changes!** Added `utc` option to the 3rd parameter of `addYears()`, `addMonths()`, `addDays()`, `addHours()`, `addMinutes()`, `addSeconds()` and `addMilliseconds()`. If you use these functions in timezones with daylight savings time, you may get different results depending on the 3rd parameter.
+
 - 2.4.3
-  - Fixed an issue where using the `addMonths` function in regions with daylight saving time would return incorrect results.
+  - Fixed an issue where using `addMonths()` in timezones with daylight saving time returned incorrect results.
 
 - 2.4.2
   - Fixed an issue where the timezone plugin stopped working due to Node.js timezone update.
 
-- 2.4.1
-  - Fixed the previous Jest support.
-
 ## Usage
 
 - ES Modules:
@@ -88,25 +88,25 @@ import date from '/path/to/date-and-time.es.min.js';
 - [transform](#transformdatestring-arg1-arg2-utc)
   - Format transformation of date and time strings (String -> String)
 
-- [addYears](#addyearsdateobj-years)
+- [addYears](#addyearsdateobj-years-utc)
   - Adding years
 
-- [addMonths](#addmonthsdateobj-months)
+- [addMonths](#addmonthsdateobj-months-utc)
   - Adding months
 
-- [addDays](#adddaysdateobj-days)
+- [addDays](#adddaysdateobj-days-utc)
   - Adding days
 
-- [addHours](#addhoursdateobj-hours)
+- [addHours](#addhoursdateobj-hours-utc)
   - Adding hours
 
-- [addMinutes](#addminutesdateobj-minutes)
+- [addMinutes](#addminutesdateobj-minutes-utc)
   - Adding minutes
 
-- [addSeconds](#addsecondsdateobj-seconds)
+- [addSeconds](#addsecondsdateobj-seconds-utc)
   - Adding seconds
 
-- [addMilliseconds](#addmillisecondsdateobj-milliseconds)
+- [addMilliseconds](#addmillisecondsdateobj-milliseconds-utc)
   - Adding milliseconds
 
 - [subtract](#subtractdate1-date2)
@@ -428,10 +428,11 @@ date.transform('3/8/2020', 'D/M/YYYY', 'M/D/YYYY');
 date.transform('13:05', 'HH:mm', 'hh:mm A');
 ```
 
-### addYears(dateObj, years)
+### addYears(dateObj, years[, utc])
 
 - @param {**Date**} dateObj - A Date object
 - @param {**number**} years - Number of years to add
+- @param {**boolean**} [utc] - Calculates as UTC
 - @returns {**Date**} The Date object after adding the value
 
 ```javascript
@@ -439,10 +440,11 @@ const now = new Date();
 const next_year = date.addYears(now, 1);
 ```
 
-### addMonths(dateObj, months)
+### addMonths(dateObj, months[, utc])
 
 - @param {**Date**} dateObj - A Date object
 - @param {**number**} months - Number of months to add
+- @param {**boolean**} [utc] - Calculates as UTC
 - @returns {**Date**} The Date object after adding the value
 
 ```javascript
@@ -450,10 +452,11 @@ const now = new Date();
 const next_month = date.addMonths(now, 1);
 ```
 
-### addDays(dateObj, days)
+### addDays(dateObj, days[, utc])
 
 - @param {**Date**} dateObj - A Date object
 - @param {**number**} days - Number of days to add
+- @param {**boolean**} [utc] - Calculates as UTC
 - @returns {**Date**} The Date object after adding the value
 
 ```javascript
@@ -461,10 +464,11 @@ const now = new Date();
 const yesterday = date.addDays(now, -1);
 ```
 
-### addHours(dateObj, hours)
+### addHours(dateObj, hours[, utc])
 
 - @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
 
 ```javascript
@@ -472,10 +476,11 @@ const now = new Date();
 const an_hour_ago = date.addHours(now, -1);
 ```
 
-### addMinutes(dateObj, minutes)
+### addMinutes(dateObj, minutes[, utc])
 
 - @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
 
 ```javascript
@@ -483,10 +488,11 @@ const now = new Date();
 const two_minutes_later = date.addMinutes(now, 2);
 ```
 
-### addSeconds(dateObj, seconds)
+### addSeconds(dateObj, seconds[, utc])
 
 - @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
 
 ```javascript
@@ -494,10 +500,11 @@ const now = new Date();
 const three_seconds_ago = date.addSeconds(now, -3);
 ```
 
-### addMilliseconds(dateObj, milliseconds)
+### addMilliseconds(dateObj, milliseconds[, utc])
 
 - @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
 
 ```javascript

package/date-and-time.d.ts

@@ -154,57 +154,64 @@ 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
  */
-export function addYears(dateObj: Date, years: number): Date;
+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
  */
-export function addMonths(dateObj: Date, months: number): Date;
+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
  */
-export function addDays(dateObj: Date, days: number): Date;
+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
  */
-export function addHours(dateObj: Date, hours: number): Date;
+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
  */
-export function addMinutes(dateObj: Date, minutes: number): Date;
+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
  */
-export function addSeconds(dateObj: Date, seconds: number): Date;
+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
  */
-export function addMilliseconds(dateObj: Date, milliseconds: number): Date;
+export function addMilliseconds(dateObj: Date, milliseconds: number, utc?: boolean): Date;
 
 /** Subtraction result object */
 export type SubtractResult = {

package/date-and-time.js

@@ -276,22 +276,28 @@
      * Adding years
      * @param {Date} dateObj - A Date object
      * @param {number} years - Number of years to add
+     * @param {boolean} [utc] - Calculates as UTC
      * @returns {Date} The Date object after adding the value
      */
-    proto.addYears = function (dateObj, years) {
-        return (this || date).addMonths(dateObj, years * 12);
+    proto.addYears = function (dateObj, years, utc) {
+        return (this || date).addMonths(dateObj, years * 12, utc);
     };
 
     /**
      * Adding months
      * @param {Date} dateObj - A Date object
      * @param {number} months - Number of months to add
+     * @param {boolean} [utc] - Calculates as UTC
      * @returns {Date} The Date object after adding the value
      */
-    proto.addMonths = function (dateObj, months) {
+    proto.addMonths = function (dateObj, months, utc) {
         var d = new Date(dateObj.getTime());
 
-        d.setUTCMonth(d.getUTCMonth() + months);
+        if (utc) {
+            d.setUTCMonth(d.getUTCMonth() + months);
+        } else {
+            d.setMonth(d.getMonth() + months);
+        }
         return d;
     };
 
@@ -299,53 +305,62 @@
      * Adding days
      * @param {Date} dateObj - A Date object
      * @param {number} days - Number of days to add
+     * @param {boolean} [utc] - Calculates as UTC
      * @returns {Date} The Date object after adding the value
      */
-    proto.addDays = function (dateObj, days) {
-        var d = new Date(dateObj.getTime());
-
-        d.setUTCDate(d.getUTCDate() + days);
-        return d;
+    proto.addDays = function (dateObj, days, utc) {
+        return (this || date).addHours(dateObj, days * 24, utc);
     };
 
     /**
      * 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) {
-        return (this || date).addMinutes(dateObj, hours * 60);
+    proto.addHours = function (dateObj, hours, utc) {
+        return (this || date).addMinutes(dateObj, hours * 60, utc);
     };
 
     /**
      * 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) {
-        return (this || date).addSeconds(dateObj, minutes * 60);
+    proto.addMinutes = function (dateObj, minutes, utc) {
+        return (this || date).addSeconds(dateObj, minutes * 60, utc);
     };
 
     /**
      * 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) {
-        return (this || date).addMilliseconds(dateObj, seconds * 1000);
+    proto.addSeconds = function (dateObj, seconds, utc) {
+        return (this || date).addMilliseconds(dateObj, seconds * 1000, utc);
     };
 
     /**
      * 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) {
-        return new Date(dateObj.getTime() + milliseconds);
+    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;
     };
 
     /**

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={},i="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"]},o={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},s={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:u},c=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},a={_formatter:o,_parser:s};return a.compile=function(e){for(var t,n=/\[([^\[\]]|\[[^\[\]]*])*]|([A-Za-z])\2+|\.{3}|./g,r=[e];t=n.exec(e);)r[r.length]=t[0];return r},a.format=function(e,n,r){var i=this||t,u="string"==typeof n?i.compile(n):n,o=e.getTimezoneOffset(),s=i.addMinutes(e,r?o:0),c=i._formatter,a="";s.getTimezoneOffset=function(){return r?0:o};for(var f,d=1,l=u.length;d<l;d++)a+=c[f=u[d]]?c.post(c[f](s,u[0])):f.replace(/\[(.*)]/,"$1");return a},a.preparse=function(e,n){var r=this||t,i="string"==typeof n?r.compile(n):n,u={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},o=/\[(.*)]/,s=r._parser,c=0;e=s.pre(e);for(var a,f,d=1,l=i.length;d<l;d++)if(s[a=i[d]]){if(!(f=s[a](e.slice(c),i[0])).length)break;c+=f.length,u[f.token||a.charAt(0)]=f.value,u._match++}else if(a===e.charAt(c)||" "===a)c++;else{if(!o.test(a)||e.slice(c).indexOf(o.exec(a)[1])){if("..."===a){c=e.length;break}break}c+=a.length-2}return u.H=u.H||s.h12(u.h,u.A),u._index=c,u._length=e.length,u},a.parse=function(e,n,r){var i=this||t,u="string"==typeof n?i.compile(n):n,o=i.preparse(e,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)},a.isValid=function(e,n){var r=this||t,i="string"==typeof e?r.preparse(e,n):e,u=[31,28+r.isLeapYear(i.Y)|0,31,30,31,30,31,31,30,31,30,31][i.M-1];return!(i._index<1||i._length<1||i._index-i._length||i._match<1||i.Y<1||i.Y>9999||i.M<1||i.M>12||i.D<1||i.D>u||i.H<0||i.H>23||i.m<0||i.m>59||i.s<0||i.s>59||i.S<0||i.S>999||i.Z<-840||i.Z>720)},a.transform=function(e,n,r,i){const u=this||t;return u.format(u.parse(e,n),r,i)},a.addYears=function(e,n){return(this||t).addMonths(e,12*n)},a.addMonths=function(e,t){var n=new Date(e.getTime());return n.setUTCMonth(n.getUTCMonth()+t),n},a.addDays=function(e,t){var n=new Date(e.getTime());return n.setUTCDate(n.getUTCDate()+t),n},a.addHours=function(e,n){return(this||t).addMinutes(e,60*n)},a.addMinutes=function(e,n){return(this||t).addSeconds(e,60*n)},a.addSeconds=function(e,n){return(this||t).addMilliseconds(e,1e3*n)},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,t){n[e]||(n[e]=t)},a.plugin=function(e,t){r[e]||(r[e]=t)},e=c(a),(t=c(a)).locale=function(f){var d="function"==typeof f?f:t.locale[f];if(!d)return i;i=d(a);var l=n[i]||{},h=c(u,l.res,!0),M=c(o,l.formatter,!0,h),g=c(s,l.parser,!0,h);for(var p in t._formatter=e._formatter=M,t._parser=e._parser=g,r)t.extend(r[p]);return i},t.extend=function(e){var n=c(t._parser.res,e.res),r=e.extender||{};for(var i in t._formatter=c(t._formatter,e.formatter,!1,n),t._parser=c(t._parser,e.parser,!1,n),r)t[i]||(t[i]=r[i])},t.plugin=function(n){var i="function"==typeof n?n:t.plugin[n];i&&t.extend(r[i(a,e)]||{})},t}));
+     */var e,t,n={},r={},i="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"]},o={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},s={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:u},c=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},a={_formatter:o,_parser:s};return a.compile=function(e){for(var t,n=/\[([^\[\]]|\[[^\[\]]*])*]|([A-Za-z])\2+|\.{3}|./g,r=[e];t=n.exec(e);)r[r.length]=t[0];return r},a.format=function(e,n,r){var i=this||t,u="string"==typeof n?i.compile(n):n,o=e.getTimezoneOffset(),s=i.addMinutes(e,r?o:0),c=i._formatter,a="";s.getTimezoneOffset=function(){return r?0:o};for(var f,d=1,l=u.length;d<l;d++)a+=c[f=u[d]]?c.post(c[f](s,u[0])):f.replace(/\[(.*)]/,"$1");return a},a.preparse=function(e,n){var r=this||t,i="string"==typeof n?r.compile(n):n,u={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},o=/\[(.*)]/,s=r._parser,c=0;e=s.pre(e);for(var a,f,d=1,l=i.length;d<l;d++)if(s[a=i[d]]){if(!(f=s[a](e.slice(c),i[0])).length)break;c+=f.length,u[f.token||a.charAt(0)]=f.value,u._match++}else if(a===e.charAt(c)||" "===a)c++;else{if(!o.test(a)||e.slice(c).indexOf(o.exec(a)[1])){if("..."===a){c=e.length;break}break}c+=a.length-2}return u.H=u.H||s.h12(u.h,u.A),u._index=c,u._length=e.length,u},a.parse=function(e,n,r){var i=this||t,u="string"==typeof n?i.compile(n):n,o=i.preparse(e,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)},a.isValid=function(e,n){var r=this||t,i="string"==typeof e?r.preparse(e,n):e,u=[31,28+r.isLeapYear(i.Y)|0,31,30,31,30,31,31,30,31,30,31][i.M-1];return!(i._index<1||i._length<1||i._index-i._length||i._match<1||i.Y<1||i.Y>9999||i.M<1||i.M>12||i.D<1||i.D>u||i.H<0||i.H>23||i.m<0||i.m>59||i.s<0||i.s>59||i.S<0||i.S>999||i.Z<-840||i.Z>720)},a.transform=function(e,n,r,i){const u=this||t;return u.format(u.parse(e,n),r,i)},a.addYears=function(e,n,r){return(this||t).addMonths(e,12*n,r)},a.addMonths=function(e,t,n){var r=new Date(e.getTime());return n?r.setUTCMonth(r.getUTCMonth()+t):r.setMonth(r.getMonth()+t),r},a.addDays=function(e,n,r){return(this||t).addHours(e,24*n,r)},a.addHours=function(e,n,r){return(this||t).addMinutes(e,60*n,r)},a.addMinutes=function(e,n,r){return(this||t).addSeconds(e,60*n,r)},a.addSeconds=function(e,n,r){return(this||t).addMilliseconds(e,1e3*n,r)},a.addMilliseconds=function(e,t,n){var r=new Date(e.getTime());return n?r.setUTCMilliseconds(r.getUTCMilliseconds()+t):r.setMilliseconds(r.getMilliseconds()+t),r},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,t){n[e]||(n[e]=t)},a.plugin=function(e,t){r[e]||(r[e]=t)},e=c(a),(t=c(a)).locale=function(f){var d="function"==typeof f?f:t.locale[f];if(!d)return i;i=d(a);var l=n[i]||{},h=c(u,l.res,!0),M=c(o,l.formatter,!0,h),g=c(s,l.parser,!0,h);for(var p in t._formatter=e._formatter=M,t._parser=e._parser=g,r)t.extend(r[p]);return i},t.extend=function(e){var n=c(t._parser.res,e.res),r=e.extender||{};for(var i in t._formatter=c(t._formatter,e.formatter,!1,n),t._parser=c(t._parser,e.parser,!1,n),r)t[i]||(t[i]=r[i])},t.plugin=function(n){var i="function"==typeof n?n:t.plugin[n];i&&t.extend(r[i(a,e)]||{})},t}));

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

@@ -270,22 +270,28 @@ proto.transform = function (dateString, arg1, arg2, utc) {
  * Adding years
  * @param {Date} dateObj - A Date object
  * @param {number} years - Number of years to add
+ * @param {boolean} [utc] - Calculates as UTC
  * @returns {Date} The Date object after adding the value
  */
-proto.addYears = function (dateObj, years) {
-    return (this || date).addMonths(dateObj, years * 12);
+proto.addYears = function (dateObj, years, utc) {
+    return (this || date).addMonths(dateObj, years * 12, utc);
 };
 
 /**
  * Adding months
  * @param {Date} dateObj - A Date object
  * @param {number} months - Number of months to add
+ * @param {boolean} [utc] - Calculates as UTC
  * @returns {Date} The Date object after adding the value
  */
-proto.addMonths = function (dateObj, months) {
+proto.addMonths = function (dateObj, months, utc) {
     var d = new Date(dateObj.getTime());
 
-    d.setUTCMonth(d.getUTCMonth() + months);
+    if (utc) {
+        d.setUTCMonth(d.getUTCMonth() + months);
+    } else {
+        d.setMonth(d.getMonth() + months);
+    }
     return d;
 };
 
@@ -293,53 +299,62 @@ proto.addMonths = function (dateObj, months) {
  * Adding days
  * @param {Date} dateObj - A Date object
  * @param {number} days - Number of days to add
+ * @param {boolean} [utc] - Calculates as UTC
  * @returns {Date} The Date object after adding the value
  */
-proto.addDays = function (dateObj, days) {
-    var d = new Date(dateObj.getTime());
-
-    d.setUTCDate(d.getUTCDate() + days);
-    return d;
+proto.addDays = function (dateObj, days, utc) {
+    return (this || date).addHours(dateObj, days * 24, utc);
 };
 
 /**
  * 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) {
-    return (this || date).addMinutes(dateObj, hours * 60);
+proto.addHours = function (dateObj, hours, utc) {
+    return (this || date).addMinutes(dateObj, hours * 60, utc);
 };
 
 /**
  * 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) {
-    return (this || date).addSeconds(dateObj, minutes * 60);
+proto.addMinutes = function (dateObj, minutes, utc) {
+    return (this || date).addSeconds(dateObj, minutes * 60, utc);
 };
 
 /**
  * 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) {
-    return (this || date).addMilliseconds(dateObj, seconds * 1000);
+proto.addSeconds = function (dateObj, seconds, utc) {
+    return (this || date).addMilliseconds(dateObj, seconds * 1000, utc);
 };
 
 /**
  * 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) {
-    return new Date(dateObj.getTime() + milliseconds);
+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;
 };
 
 /**

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

@@ -1,4 +1,4 @@
 /**
  * @preserve date-and-time (c) KNOWLEDGECODE | MIT
  */
-var e,t,n={},r={},u="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"]},o={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},s={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:i},c=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:o,_parser:s};a.compile=function(e){for(var t,n=/\[([^\[\]]|\[[^\[\]]*])*]|([A-Za-z])\2+|\.{3}|./g,r=[e];t=n.exec(e);)r[r.length]=t[0];return r},a.format=function(e,n,r){var u=this||t,i="string"==typeof n?u.compile(n):n,o=e.getTimezoneOffset(),s=u.addMinutes(e,r?o:0),c=u._formatter,a="";s.getTimezoneOffset=function(){return r?0:o};for(var f,d=1,h=i.length;d<h;d++)a+=c[f=i[d]]?c.post(c[f](s,i[0])):f.replace(/\[(.*)]/,"$1");return a},a.preparse=function(e,n){var r=this||t,u="string"==typeof n?r.compile(n):n,i={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},o=/\[(.*)]/,s=r._parser,c=0;e=s.pre(e);for(var a,f,d=1,h=u.length;d<h;d++)if(s[a=u[d]]){if(!(f=s[a](e.slice(c),u[0])).length)break;c+=f.length,i[f.token||a.charAt(0)]=f.value,i._match++}else if(a===e.charAt(c)||" "===a)c++;else{if(!o.test(a)||e.slice(c).indexOf(o.exec(a)[1])){if("..."===a){c=e.length;break}break}c+=a.length-2}return i.H=i.H||s.h12(i.h,i.A),i._index=c,i._length=e.length,i},a.parse=function(e,n,r){var u=this||t,i="string"==typeof n?u.compile(n):n,o=u.preparse(e,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(e,n){var r=this||t,u="string"==typeof e?r.preparse(e,n):e,i=[31,28+r.isLeapYear(u.Y)|0,31,30,31,30,31,31,30,31,30,31][u.M-1];return!(u._index<1||u._length<1||u._index-u._length||u._match<1||u.Y<1||u.Y>9999||u.M<1||u.M>12||u.D<1||u.D>i||u.H<0||u.H>23||u.m<0||u.m>59||u.s<0||u.s>59||u.S<0||u.S>999||u.Z<-840||u.Z>720)},a.transform=function(e,n,r,u){const i=this||t;return i.format(i.parse(e,n),r,u)},a.addYears=function(e,n){return(this||t).addMonths(e,12*n)},a.addMonths=function(e,t){var n=new Date(e.getTime());return n.setUTCMonth(n.getUTCMonth()+t),n},a.addDays=function(e,t){var n=new Date(e.getTime());return n.setUTCDate(n.getUTCDate()+t),n},a.addHours=function(e,n){return(this||t).addMinutes(e,60*n)},a.addMinutes=function(e,n){return(this||t).addSeconds(e,60*n)},a.addSeconds=function(e,n){return(this||t).addMilliseconds(e,1e3*n)},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,t){n[e]||(n[e]=t)},a.plugin=function(e,t){r[e]||(r[e]=t)},e=c(a),(t=c(a)).locale=function(f){var d="function"==typeof f?f:t.locale[f];if(!d)return u;u=d(a);var h=n[u]||{},l=c(i,h.res,!0),M=c(o,h.formatter,!0,l),g=c(s,h.parser,!0,l);for(var p in t._formatter=e._formatter=M,t._parser=e._parser=g,r)t.extend(r[p]);return u},t.extend=function(e){var n=c(t._parser.res,e.res),r=e.extender||{};for(var u in t._formatter=c(t._formatter,e.formatter,!1,n),t._parser=c(t._parser,e.parser,!1,n),r)t[u]||(t[u]=r[u])},t.plugin=function(n){var u="function"==typeof n?n:t.plugin[n];u&&t.extend(r[u(a,e)]||{})};var f=t;export{f as default};
+var e,t,n={},r={},i="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"]},s={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,i=0,u=0,s=e.length;u<s;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:u},c=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},a={_formatter:s,_parser:o};a.compile=function(e){for(var t,n=/\[([^\[\]]|\[[^\[\]]*])*]|([A-Za-z])\2+|\.{3}|./g,r=[e];t=n.exec(e);)r[r.length]=t[0];return r},a.format=function(e,n,r){var i=this||t,u="string"==typeof n?i.compile(n):n,s=e.getTimezoneOffset(),o=i.addMinutes(e,r?s:0),c=i._formatter,a="";o.getTimezoneOffset=function(){return r?0:s};for(var f,d=1,l=u.length;d<l;d++)a+=c[f=u[d]]?c.post(c[f](o,u[0])):f.replace(/\[(.*)]/,"$1");return a},a.preparse=function(e,n){var r=this||t,i="string"==typeof n?r.compile(n):n,u={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=/\[(.*)]/,o=r._parser,c=0;e=o.pre(e);for(var a,f,d=1,l=i.length;d<l;d++)if(o[a=i[d]]){if(!(f=o[a](e.slice(c),i[0])).length)break;c+=f.length,u[f.token||a.charAt(0)]=f.value,u._match++}else if(a===e.charAt(c)||" "===a)c++;else{if(!s.test(a)||e.slice(c).indexOf(s.exec(a)[1])){if("..."===a){c=e.length;break}break}c+=a.length-2}return u.H=u.H||o.h12(u.h,u.A),u._index=c,u._length=e.length,u},a.parse=function(e,n,r){var i=this||t,u="string"==typeof n?i.compile(n):n,s=i.preparse(e,u);return i.isValid(s)?(s.M-=s.Y<100?22801:1,r||~i._parser.find(u,"ZZ").value?new Date(Date.UTC(s.Y,s.M,s.D,s.H,s.m+s.Z,s.s,s.S)):new Date(s.Y,s.M,s.D,s.H,s.m,s.s,s.S)):new Date(NaN)},a.isValid=function(e,n){var r=this||t,i="string"==typeof e?r.preparse(e,n):e,u=[31,28+r.isLeapYear(i.Y)|0,31,30,31,30,31,31,30,31,30,31][i.M-1];return!(i._index<1||i._length<1||i._index-i._length||i._match<1||i.Y<1||i.Y>9999||i.M<1||i.M>12||i.D<1||i.D>u||i.H<0||i.H>23||i.m<0||i.m>59||i.s<0||i.s>59||i.S<0||i.S>999||i.Z<-840||i.Z>720)},a.transform=function(e,n,r,i){const u=this||t;return u.format(u.parse(e,n),r,i)},a.addYears=function(e,n,r){return(this||t).addMonths(e,12*n,r)},a.addMonths=function(e,t,n){var r=new Date(e.getTime());return n?r.setUTCMonth(r.getUTCMonth()+t):r.setMonth(r.getMonth()+t),r},a.addDays=function(e,n,r){return(this||t).addHours(e,24*n,r)},a.addHours=function(e,n,r){return(this||t).addMinutes(e,60*n,r)},a.addMinutes=function(e,n,r){return(this||t).addSeconds(e,60*n,r)},a.addSeconds=function(e,n,r){return(this||t).addMilliseconds(e,1e3*n,r)},a.addMilliseconds=function(e,t,n){var r=new Date(e.getTime());return n?r.setUTCMilliseconds(r.getUTCMilliseconds()+t):r.setMilliseconds(r.getMilliseconds()+t),r},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,t){n[e]||(n[e]=t)},a.plugin=function(e,t){r[e]||(r[e]=t)},e=c(a),(t=c(a)).locale=function(f){var d="function"==typeof f?f:t.locale[f];if(!d)return i;i=d(a);var l=n[i]||{},h=c(u,l.res,!0),M=c(s,l.formatter,!0,h),g=c(o,l.parser,!0,h);for(var p in t._formatter=e._formatter=M,t._parser=e._parser=g,r)t.extend(r[p]);return i},t.extend=function(e){var n=c(t._parser.res,e.res),r=e.extender||{};for(var i in t._formatter=c(t._formatter,e.formatter,!1,n),t._parser=c(t._parser,e.parser,!1,n),r)t[i]||(t[i]=r[i])},t.plugin=function(n){var i="function"==typeof n?n:t.plugin[n];i&&t.extend(r[i(a,e)]||{})};var f=t;export{f as default};

package/esm/date-and-time.mjs

@@ -270,22 +270,28 @@ proto.transform = function (dateString, arg1, arg2, utc) {
  * Adding years
  * @param {Date} dateObj - A Date object
  * @param {number} years - Number of years to add
+ * @param {boolean} [utc] - Calculates as UTC
  * @returns {Date} The Date object after adding the value
  */
-proto.addYears = function (dateObj, years) {
-    return (this || date).addMonths(dateObj, years * 12);
+proto.addYears = function (dateObj, years, utc) {
+    return (this || date).addMonths(dateObj, years * 12, utc);
 };
 
 /**
  * Adding months
  * @param {Date} dateObj - A Date object
  * @param {number} months - Number of months to add
+ * @param {boolean} [utc] - Calculates as UTC
  * @returns {Date} The Date object after adding the value
  */
-proto.addMonths = function (dateObj, months) {
+proto.addMonths = function (dateObj, months, utc) {
     var d = new Date(dateObj.getTime());
 
-    d.setUTCMonth(d.getUTCMonth() + months);
+    if (utc) {
+        d.setUTCMonth(d.getUTCMonth() + months);
+    } else {
+        d.setMonth(d.getMonth() + months);
+    }
     return d;
 };
 
@@ -293,53 +299,62 @@ proto.addMonths = function (dateObj, months) {
  * Adding days
  * @param {Date} dateObj - A Date object
  * @param {number} days - Number of days to add
+ * @param {boolean} [utc] - Calculates as UTC
  * @returns {Date} The Date object after adding the value
  */
-proto.addDays = function (dateObj, days) {
-    var d = new Date(dateObj.getTime());
-
-    d.setUTCDate(d.getUTCDate() + days);
-    return d;
+proto.addDays = function (dateObj, days, utc) {
+    return (this || date).addHours(dateObj, days * 24, utc);
 };
 
 /**
  * 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) {
-    return (this || date).addMinutes(dateObj, hours * 60);
+proto.addHours = function (dateObj, hours, utc) {
+    return (this || date).addMinutes(dateObj, hours * 60, utc);
 };
 
 /**
  * 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) {
-    return (this || date).addSeconds(dateObj, minutes * 60);
+proto.addMinutes = function (dateObj, minutes, utc) {
+    return (this || date).addSeconds(dateObj, minutes * 60, utc);
 };
 
 /**
  * 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) {
-    return (this || date).addMilliseconds(dateObj, seconds * 1000);
+proto.addSeconds = function (dateObj, seconds, utc) {
+    return (this || date).addMilliseconds(dateObj, seconds * 1000, utc);
 };
 
 /**
  * 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) {
-    return new Date(dateObj.getTime() + milliseconds);
+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;
 };
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "date-and-time",
-  "version": "2.4.3",
+  "version": "3.0.0",
   "description": "A Minimalist DateTime utility for Node.js and the browser",
   "main": "date-and-time.js",
   "module": "esm/date-and-time.es.js",
@@ -46,11 +46,10 @@
   },
   "homepage": "https://github.com/knowledgecode/date-and-time",
   "devDependencies": {
-    "@rollup/plugin-terser": "^0.4.0",
+    "@rollup/plugin-terser": "^0.4.1",
     "expect.js": "^0.3.1",
     "mocha": "^10.2.0",
-    "mocha-headless-chrome": "^4.0.0",
-    "rollup": "^3.19.1",
-    "tsd": "^0.27.0"
+    "rollup": "^3.20.7",
+    "tsd": "^0.28.1"
   }
 }