date-and-time 3.4.0 → 3.5.0

package/esm/date-and-time.mjs

@@ -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);
 };
 
 /**

package/esm/plugin/timezone.es.js

@@ -535,34 +535,59 @@ var plugin = function (proto, date) {
     };
     var options = {
         hour12: false, weekday: 'short', year: 'numeric', month: 'numeric', day: 'numeric',
-        hour: 'numeric', minute: 'numeric', second: 'numeric', fractionalSecondDigits: 3
+        hour: 'numeric', minute: 'numeric', second: 'numeric', fractionalSecondDigits: 3,
+        timeZone: 'UTC'
     };
-    var formatTZ = function (dateObj, arg, timeZone) {
-        var parts = (function () {
-            options.timeZone = timeZone || undefined;
-            var array = new Intl.DateTimeFormat('en-US', options).formatToParts(dateObj);
-            var values = {};
+    var cache = {
+        utc: new Intl.DateTimeFormat('en-US', options)
+    };
+    var getDateTimeFormat = function (timeZone) {
+        if (timeZone) {
+            var tz = timeZone.toLowerCase();
 
-            for (var i = 0, len = array.length; i < len; i++) {
-                var type = array[i].type;
-                var value = array[i].value;
+            if (!cache[tz]) {
+                options.timeZone = timeZone;
+                cache[tz] = new Intl.DateTimeFormat('en-US', options);
+            }
+            return cache[tz];
+        }
+        options.timeZone = undefined;
+        return new Intl.DateTimeFormat('en-US', options);
+    };
+    var formatToParts = function (dateTimeFormat, dateObjOrTime) {
+        var array = dateTimeFormat.formatToParts(dateObjOrTime),
+            values = {};
 
-                switch (type) {
-                case 'weekday':
-                    values[type] = 'SunMonTueWedThuFriSat'.indexOf(value) / 3;
-                    break;
-                case 'year':
-                case 'month':
-                case 'day':
-                case 'hour':
-                case 'minute':
-                case 'second':
-                case 'fractionalSecond':
-                    values[type] = value | 0;
-                }
+        for (var i = 0, len = array.length; i < len; i++) {
+            var type = array[i].type,
+                value = array[i].value;
+
+            switch (type) {
+            case 'weekday':
+                values[type] = 'SunMonTueWedThuFriSat'.indexOf(value) / 3;
+                break;
+            case 'hour':
+                values[type] = value % 24;
+                break;
+            case 'year':
+            case 'month':
+            case 'day':
+            case 'minute':
+            case 'second':
+            case 'fractionalSecond':
+                values[type] = value | 0;
             }
-            return values;
-        }());
+        }
+        return values;
+    };
+    var getTimeFromParts = function (parts) {
+        return Date.UTC(
+            parts.year, parts.month - (parts.year < 100 ? 1900 * 12 + 1 : 1), parts.day,
+            parts.hour, parts.minute, parts.second, parts.fractionalSecond
+        );
+    };
+    var formatTZ = function (dateObj, arg, timeZone) {
+        var parts = formatToParts(getDateTimeFormat(timeZone), dateObj);
 
         return date.format({
             getFullYear: function () { return parts.year; },
@@ -575,18 +600,14 @@ var plugin = function (proto, date) {
             getDay: function () { return parts.weekday; },
             getTime: function () { return dateObj.getTime(); },
             getTimezoneOffset: function () {
-                return (dateObj.getTime() - Date.UTC(
-                    parts.year, parts.month - (parts.year < 100 ? 1900 * 12 + 1 : 1), parts.day,
-                    parts.hour, parts.minute, parts.second, parts.fractionalSecond
-                )) / 60000 | 0;
+                return (dateObj.getTime() - getTimeFromParts(parts)) / 60000 | 0;
             },
             getTimezoneName: function () { return timeZone || undefined; }
         }, arg);
     };
-    var parseTZ = function (dateString, arg, timeZone) {
-        var pattern = typeof arg === 'string' ? date.compile(arg) : arg;
-        var dateObj = date.parse(dateString, pattern, !!timeZone);
-
+    var parseTZ = function (arg1, arg2, timeZone) {
+        var pattern = typeof arg2 === 'string' ? date.compile(arg2) : arg2;
+        var dateObj = typeof arg1 === 'string' ? date.parse(arg1, pattern, !!timeZone) : arg1;
         var hasZ = function (array) {
             for (var i = 1, len = array.length; i < len; i++) {
                 if (!array[i].indexOf('Z')) {
@@ -610,10 +631,8 @@ var plugin = function (proto, date) {
             return Array.isArray(value) ? value : [];
         };
 
-        options.timeZone = 'UTC';
-        var dateString2 = new Intl.DateTimeFormat('en-US', options).format(dateObj);
-        options.timeZone = timeZone || undefined;
-        var dateTimeFormat = new Intl.DateTimeFormat('en-US', options);
+        var dateString2 = getDateTimeFormat('UTC').format(dateObj);
+        var dateTimeFormat = getDateTimeFormat(timeZone);
         var offset = getOffset(timeZone);
         var comparer = function (d) {
             return dateString2 === dateTimeFormat.format(d);
@@ -630,6 +649,39 @@ var plugin = function (proto, date) {
     var transformTZ = function (dateString, arg1, arg2, timeZone) {
         return formatTZ(date.parse(dateString, arg1), arg2, timeZone);
     };
+    var normalizeDateParts = function (parts, adjustEOM) {
+        var d = new Date(Date.UTC(
+            parts.year, parts.month - (parts.year < 100 ? 1900 * 12 + 1 : 1), parts.day
+        ));
+
+        if (adjustEOM && d.getUTCDate() < parts.day) {
+            d.setUTCDate(0);
+        }
+        parts.year = d.getUTCFullYear();
+        parts.month = d.getUTCMonth() + 1;
+        parts.day = d.getUTCDate();
+
+        return parts;
+    };
+    var addYearsTZ = function (dateObj, years, timeZone) {
+        return addMonthsTZ(dateObj, years * 12, timeZone);
+    };
+    var addMonthsTZ = function (dateObj, months, timeZone) {
+        var parts = formatToParts(getDateTimeFormat(timeZone), dateObj);
+
+        parts.month += months;
+        var dateObj2 = parseTZ(new Date(getTimeFromParts(normalizeDateParts(parts, true))), [], timeZone);
+
+        return isNaN(dateObj2.getTime()) ? date.addMonths(dateObj, months, true) : dateObj2;
+    };
+    var addDaysTZ = function (dateObj, days, timeZone) {
+        var parts = formatToParts(getDateTimeFormat(timeZone), dateObj);
+
+        parts.day += days;
+        var dateObj2 = parseTZ(new Date(getTimeFromParts(normalizeDateParts(parts, false))), [], timeZone);
+
+        return isNaN(dateObj2.getTime()) ? date.addDays(dateObj, days, true) : dateObj2;
+    };
 
     var name = 'timezone';
 
@@ -661,7 +713,10 @@ var plugin = function (proto, date) {
         extender: {
             formatTZ: formatTZ,
             parseTZ: parseTZ,
-            transformTZ: transformTZ
+            transformTZ: transformTZ,
+            addYearsTZ: addYearsTZ,
+            addMonthsTZ: addMonthsTZ,
+            addDaysTZ: addDaysTZ
         }
     });
     return name;

package/esm/plugin/timezone.mjs

@@ -535,34 +535,59 @@ var plugin = function (proto, date) {
     };
     var options = {
         hour12: false, weekday: 'short', year: 'numeric', month: 'numeric', day: 'numeric',
-        hour: 'numeric', minute: 'numeric', second: 'numeric', fractionalSecondDigits: 3
+        hour: 'numeric', minute: 'numeric', second: 'numeric', fractionalSecondDigits: 3,
+        timeZone: 'UTC'
     };
-    var formatTZ = function (dateObj, arg, timeZone) {
-        var parts = (function () {
-            options.timeZone = timeZone || undefined;
-            var array = new Intl.DateTimeFormat('en-US', options).formatToParts(dateObj);
-            var values = {};
+    var cache = {
+        utc: new Intl.DateTimeFormat('en-US', options)
+    };
+    var getDateTimeFormat = function (timeZone) {
+        if (timeZone) {
+            var tz = timeZone.toLowerCase();
 
-            for (var i = 0, len = array.length; i < len; i++) {
-                var type = array[i].type;
-                var value = array[i].value;
+            if (!cache[tz]) {
+                options.timeZone = timeZone;
+                cache[tz] = new Intl.DateTimeFormat('en-US', options);
+            }
+            return cache[tz];
+        }
+        options.timeZone = undefined;
+        return new Intl.DateTimeFormat('en-US', options);
+    };
+    var formatToParts = function (dateTimeFormat, dateObjOrTime) {
+        var array = dateTimeFormat.formatToParts(dateObjOrTime),
+            values = {};
 
-                switch (type) {
-                case 'weekday':
-                    values[type] = 'SunMonTueWedThuFriSat'.indexOf(value) / 3;
-                    break;
-                case 'year':
-                case 'month':
-                case 'day':
-                case 'hour':
-                case 'minute':
-                case 'second':
-                case 'fractionalSecond':
-                    values[type] = value | 0;
-                }
+        for (var i = 0, len = array.length; i < len; i++) {
+            var type = array[i].type,
+                value = array[i].value;
+
+            switch (type) {
+            case 'weekday':
+                values[type] = 'SunMonTueWedThuFriSat'.indexOf(value) / 3;
+                break;
+            case 'hour':
+                values[type] = value % 24;
+                break;
+            case 'year':
+            case 'month':
+            case 'day':
+            case 'minute':
+            case 'second':
+            case 'fractionalSecond':
+                values[type] = value | 0;
             }
-            return values;
-        }());
+        }
+        return values;
+    };
+    var getTimeFromParts = function (parts) {
+        return Date.UTC(
+            parts.year, parts.month - (parts.year < 100 ? 1900 * 12 + 1 : 1), parts.day,
+            parts.hour, parts.minute, parts.second, parts.fractionalSecond
+        );
+    };
+    var formatTZ = function (dateObj, arg, timeZone) {
+        var parts = formatToParts(getDateTimeFormat(timeZone), dateObj);
 
         return date.format({
             getFullYear: function () { return parts.year; },
@@ -575,18 +600,14 @@ var plugin = function (proto, date) {
             getDay: function () { return parts.weekday; },
             getTime: function () { return dateObj.getTime(); },
             getTimezoneOffset: function () {
-                return (dateObj.getTime() - Date.UTC(
-                    parts.year, parts.month - (parts.year < 100 ? 1900 * 12 + 1 : 1), parts.day,
-                    parts.hour, parts.minute, parts.second, parts.fractionalSecond
-                )) / 60000 | 0;
+                return (dateObj.getTime() - getTimeFromParts(parts)) / 60000 | 0;
             },
             getTimezoneName: function () { return timeZone || undefined; }
         }, arg);
     };
-    var parseTZ = function (dateString, arg, timeZone) {
-        var pattern = typeof arg === 'string' ? date.compile(arg) : arg;
-        var dateObj = date.parse(dateString, pattern, !!timeZone);
-
+    var parseTZ = function (arg1, arg2, timeZone) {
+        var pattern = typeof arg2 === 'string' ? date.compile(arg2) : arg2;
+        var dateObj = typeof arg1 === 'string' ? date.parse(arg1, pattern, !!timeZone) : arg1;
         var hasZ = function (array) {
             for (var i = 1, len = array.length; i < len; i++) {
                 if (!array[i].indexOf('Z')) {
@@ -610,10 +631,8 @@ var plugin = function (proto, date) {
             return Array.isArray(value) ? value : [];
         };
 
-        options.timeZone = 'UTC';
-        var dateString2 = new Intl.DateTimeFormat('en-US', options).format(dateObj);
-        options.timeZone = timeZone || undefined;
-        var dateTimeFormat = new Intl.DateTimeFormat('en-US', options);
+        var dateString2 = getDateTimeFormat('UTC').format(dateObj);
+        var dateTimeFormat = getDateTimeFormat(timeZone);
         var offset = getOffset(timeZone);
         var comparer = function (d) {
             return dateString2 === dateTimeFormat.format(d);
@@ -630,6 +649,39 @@ var plugin = function (proto, date) {
     var transformTZ = function (dateString, arg1, arg2, timeZone) {
         return formatTZ(date.parse(dateString, arg1), arg2, timeZone);
     };
+    var normalizeDateParts = function (parts, adjustEOM) {
+        var d = new Date(Date.UTC(
+            parts.year, parts.month - (parts.year < 100 ? 1900 * 12 + 1 : 1), parts.day
+        ));
+
+        if (adjustEOM && d.getUTCDate() < parts.day) {
+            d.setUTCDate(0);
+        }
+        parts.year = d.getUTCFullYear();
+        parts.month = d.getUTCMonth() + 1;
+        parts.day = d.getUTCDate();
+
+        return parts;
+    };
+    var addYearsTZ = function (dateObj, years, timeZone) {
+        return addMonthsTZ(dateObj, years * 12, timeZone);
+    };
+    var addMonthsTZ = function (dateObj, months, timeZone) {
+        var parts = formatToParts(getDateTimeFormat(timeZone), dateObj);
+
+        parts.month += months;
+        var dateObj2 = parseTZ(new Date(getTimeFromParts(normalizeDateParts(parts, true))), [], timeZone);
+
+        return isNaN(dateObj2.getTime()) ? date.addMonths(dateObj, months, true) : dateObj2;
+    };
+    var addDaysTZ = function (dateObj, days, timeZone) {
+        var parts = formatToParts(getDateTimeFormat(timeZone), dateObj);
+
+        parts.day += days;
+        var dateObj2 = parseTZ(new Date(getTimeFromParts(normalizeDateParts(parts, false))), [], timeZone);
+
+        return isNaN(dateObj2.getTime()) ? date.addDays(dateObj, days, true) : dateObj2;
+    };
 
     var name = 'timezone';
 
@@ -661,7 +713,10 @@ var plugin = function (proto, date) {
         extender: {
             formatTZ: formatTZ,
             parseTZ: parseTZ,
-            transformTZ: transformTZ
+            transformTZ: transformTZ,
+            addYearsTZ: addYearsTZ,
+            addMonthsTZ: addMonthsTZ,
+            addDaysTZ: addDaysTZ
         }
     });
     return name;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "date-and-time",
-  "version": "3.4.0",
+  "version": "3.5.0",
   "description": "A Minimalist DateTime utility for Node.js and the browser",
   "main": "date-and-time.js",
   "module": "esm/date-and-time.es.js",
@@ -51,8 +51,8 @@
   "devDependencies": {
     "@rollup/plugin-terser": "^0.4.4",
     "expect.js": "^0.3.1",
-    "mocha": "^10.6.0",
-    "rollup": "^4.18.0",
+    "mocha": "^10.7.3",
+    "rollup": "^4.20.0",
     "tsd": "^0.31.1"
   }
 }

package/plugin/timezone.d.ts

@@ -74,6 +74,33 @@ declare module '../date-and-time' {
      * @returns A formatted string
      */
     export function transformTZ(dateString: string, compiledObj1: string[], compiledObj2: string[], timeZone?: string): string;
+
+    /**
+     * Adding years considering time zones
+     * @param dateObj - A Date object
+     * @param years - The number of years to add
+     * @param [timeZone] - The time zone to use for the calculation
+     * @returns The Date object after adding the specified number of years
+     */
+    export function addYearsTZ(dateObj: Date, years: number, timeZone?: string): Date;
+
+    /**
+     * Adding months considering time zones
+     * @param dateObj - A Date object
+     * @param months - The number of months to add
+     * @param [timeZone] - The time zone to use for the calculation
+     * @returns The Date object after adding the specified number of months
+     */
+    export function addMonthsTZ(dateObj: Date, months: number, timeZone?: string): Date;
+
+    /**
+     * Adding days considering time zones
+     * @param dateObj - A Date object
+     * @param days - The number of days to add
+     * @param [timeZone] - The time zone to use for the calculation
+     * @returns The Date object after adding the specified number of days
+     */
+    export function addDaysTZ(dateObj: Date, days: number, timeZone?: string): Date;
 }
 
 export default function (proto: unknown, date?: unknown): string;

package/plugin/timezone.js

@@ -541,34 +541,59 @@
         };
         var options = {
             hour12: false, weekday: 'short', year: 'numeric', month: 'numeric', day: 'numeric',
-            hour: 'numeric', minute: 'numeric', second: 'numeric', fractionalSecondDigits: 3
+            hour: 'numeric', minute: 'numeric', second: 'numeric', fractionalSecondDigits: 3,
+            timeZone: 'UTC'
         };
-        var formatTZ = function (dateObj, arg, timeZone) {
-            var parts = (function () {
-                options.timeZone = timeZone || undefined;
-                var array = new Intl.DateTimeFormat('en-US', options).formatToParts(dateObj);
-                var values = {};
+        var cache = {
+            utc: new Intl.DateTimeFormat('en-US', options)
+        };
+        var getDateTimeFormat = function (timeZone) {
+            if (timeZone) {
+                var tz = timeZone.toLowerCase();
 
-                for (var i = 0, len = array.length; i < len; i++) {
-                    var type = array[i].type;
-                    var value = array[i].value;
+                if (!cache[tz]) {
+                    options.timeZone = timeZone;
+                    cache[tz] = new Intl.DateTimeFormat('en-US', options);
+                }
+                return cache[tz];
+            }
+            options.timeZone = undefined;
+            return new Intl.DateTimeFormat('en-US', options);
+        };
+        var formatToParts = function (dateTimeFormat, dateObjOrTime) {
+            var array = dateTimeFormat.formatToParts(dateObjOrTime),
+                values = {};
 
-                    switch (type) {
-                    case 'weekday':
-                        values[type] = 'SunMonTueWedThuFriSat'.indexOf(value) / 3;
-                        break;
-                    case 'year':
-                    case 'month':
-                    case 'day':
-                    case 'hour':
-                    case 'minute':
-                    case 'second':
-                    case 'fractionalSecond':
-                        values[type] = value | 0;
-                    }
+            for (var i = 0, len = array.length; i < len; i++) {
+                var type = array[i].type,
+                    value = array[i].value;
+
+                switch (type) {
+                case 'weekday':
+                    values[type] = 'SunMonTueWedThuFriSat'.indexOf(value) / 3;
+                    break;
+                case 'hour':
+                    values[type] = value % 24;
+                    break;
+                case 'year':
+                case 'month':
+                case 'day':
+                case 'minute':
+                case 'second':
+                case 'fractionalSecond':
+                    values[type] = value | 0;
                 }
-                return values;
-            }());
+            }
+            return values;
+        };
+        var getTimeFromParts = function (parts) {
+            return Date.UTC(
+                parts.year, parts.month - (parts.year < 100 ? 1900 * 12 + 1 : 1), parts.day,
+                parts.hour, parts.minute, parts.second, parts.fractionalSecond
+            );
+        };
+        var formatTZ = function (dateObj, arg, timeZone) {
+            var parts = formatToParts(getDateTimeFormat(timeZone), dateObj);
 
             return date.format({
                 getFullYear: function () { return parts.year; },
@@ -581,18 +606,14 @@
                 getDay: function () { return parts.weekday; },
                 getTime: function () { return dateObj.getTime(); },
                 getTimezoneOffset: function () {
-                    return (dateObj.getTime() - Date.UTC(
-                        parts.year, parts.month - (parts.year < 100 ? 1900 * 12 + 1 : 1), parts.day,
-                        parts.hour, parts.minute, parts.second, parts.fractionalSecond
-                    )) / 60000 | 0;
+                    return (dateObj.getTime() - getTimeFromParts(parts)) / 60000 | 0;
                 },
                 getTimezoneName: function () { return timeZone || undefined; }
             }, arg);
         };
-        var parseTZ = function (dateString, arg, timeZone) {
-            var pattern = typeof arg === 'string' ? date.compile(arg) : arg;
-            var dateObj = date.parse(dateString, pattern, !!timeZone);
-
+        var parseTZ = function (arg1, arg2, timeZone) {
+            var pattern = typeof arg2 === 'string' ? date.compile(arg2) : arg2;
+            var dateObj = typeof arg1 === 'string' ? date.parse(arg1, pattern, !!timeZone) : arg1;
             var hasZ = function (array) {
                 for (var i = 1, len = array.length; i < len; i++) {
                     if (!array[i].indexOf('Z')) {
@@ -616,10 +637,8 @@
                 return Array.isArray(value) ? value : [];
             };
 
-            options.timeZone = 'UTC';
-            var dateString2 = new Intl.DateTimeFormat('en-US', options).format(dateObj);
-            options.timeZone = timeZone || undefined;
-            var dateTimeFormat = new Intl.DateTimeFormat('en-US', options);
+            var dateString2 = getDateTimeFormat('UTC').format(dateObj);
+            var dateTimeFormat = getDateTimeFormat(timeZone);
             var offset = getOffset(timeZone);
             var comparer = function (d) {
                 return dateString2 === dateTimeFormat.format(d);
@@ -636,6 +655,39 @@
         var transformTZ = function (dateString, arg1, arg2, timeZone) {
             return formatTZ(date.parse(dateString, arg1), arg2, timeZone);
         };
+        var normalizeDateParts = function (parts, adjustEOM) {
+            var d = new Date(Date.UTC(
+                parts.year, parts.month - (parts.year < 100 ? 1900 * 12 + 1 : 1), parts.day
+            ));
+
+            if (adjustEOM && d.getUTCDate() < parts.day) {
+                d.setUTCDate(0);
+            }
+            parts.year = d.getUTCFullYear();
+            parts.month = d.getUTCMonth() + 1;
+            parts.day = d.getUTCDate();
+
+            return parts;
+        };
+        var addYearsTZ = function (dateObj, years, timeZone) {
+            return addMonthsTZ(dateObj, years * 12, timeZone);
+        };
+        var addMonthsTZ = function (dateObj, months, timeZone) {
+            var parts = formatToParts(getDateTimeFormat(timeZone), dateObj);
+
+            parts.month += months;
+            var dateObj2 = parseTZ(new Date(getTimeFromParts(normalizeDateParts(parts, true))), [], timeZone);
+
+            return isNaN(dateObj2.getTime()) ? date.addMonths(dateObj, months, true) : dateObj2;
+        };
+        var addDaysTZ = function (dateObj, days, timeZone) {
+            var parts = formatToParts(getDateTimeFormat(timeZone), dateObj);
+
+            parts.day += days;
+            var dateObj2 = parseTZ(new Date(getTimeFromParts(normalizeDateParts(parts, false))), [], timeZone);
+
+            return isNaN(dateObj2.getTime()) ? date.addDays(dateObj, days, true) : dateObj2;
+        };
 
         var name = 'timezone';
 
@@ -667,7 +719,10 @@
             extender: {
                 formatTZ: formatTZ,
                 parseTZ: parseTZ,
-                transformTZ: transformTZ
+                transformTZ: transformTZ,
+                addYearsTZ: addYearsTZ,
+                addMonthsTZ: addMonthsTZ,
+                addDaysTZ: addDaysTZ
             }
         });
         return name;