date-and-time 2.2.0 → 2.3.1

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

@@ -140,9 +140,9 @@ var locales = {},
     date;
 
 /**
- * Compiling a format string
- * @param {string} formatString - a format string
- * @returns {Array.<string>} a compiled object
+ * Compiling format strings
+ * @param {string} formatString - A format string
+ * @returns {Array.<string>} A compiled object
  */
 proto.compile = function (formatString) {
     var re = /\[([^\[\]]|\[[^\[\]]*])*]|([A-Za-z])\2+|\.{3}|./g, keys, pattern = [formatString];
@@ -154,11 +154,11 @@ proto.compile = function (formatString) {
 };
 
 /**
- * Formatting a Date and Time
- * @param {Date} dateObj - a Date object
- * @param {string|Array.<string>} arg - a format string or its compiled object
- * @param {boolean} [utc] - output as UTC
- * @returns {string} a formatted string
+ * Formatting date and time objects (Date -> String)
+ * @param {Date} dateObj - A Date object
+ * @param {string|Array.<string>} arg - A format string or its compiled object
+ * @param {boolean} [utc] - Output as UTC
+ * @returns {string} A formatted string
  */
 proto.format = function (dateObj, arg, utc) {
     var ctx = this || date, pattern = typeof arg === 'string' ? ctx.compile(arg) : arg,
@@ -175,10 +175,11 @@ proto.format = function (dateObj, arg, utc) {
 };
 
 /**
- * Pre-parsing a Date and Time string
- * @param {string} dateString - a date string
- * @param {string|Array.<string>} arg - a format string or its compiled object
- * @returns {Object} a date structure
+ * Pre-parsing date and time strings
+ * @param {string} dateString - A date and time string
+ * @param {string|Array.<string>} arg - A format string or its compiled object
+ * @param {boolean} [utc] - Input as UTC
+ * @returns {Object} A pre-parsed result object
  */
 proto.preparse = function (dateString, arg) {
     var ctx = this || date, pattern = typeof arg === 'string' ? ctx.compile(arg) : arg,
@@ -214,18 +215,19 @@ proto.preparse = function (dateString, arg) {
 };
 
 /**
- * Parsing a Date and Time string
- * @param {string} dateString - a date string
- * @param {string|Array.<string>} arg - a format string or its compiled object
- * @param {boolean} [utc] - input as UTC
- * @returns {Date} a constructed date
+ * Parsing of date and time string (String -> Date)
+ * @param {string} dateString - A date-time string
+ * @param {string|Array.<string>} arg - A format string or its compiled object
+ * @param {boolean} [utc] - Input as UTC
+ * @returns {Date} A Date object
  */
 proto.parse = function (dateString, arg, utc) {
-    var ctx = this || date, dt = ctx.preparse(dateString, arg);
+    var ctx = this || date, pattern = typeof arg === 'string' ? ctx.compile(arg) : arg,
+        dt = ctx.preparse(dateString, pattern);
 
     if (ctx.isValid(dt)) {
         dt.M -= dt.Y < 100 ? 22801 : 1; // 22801 = 1900 * 12 + 1
-        if (utc || dt.Z) {
+        if (utc || ~ctx._parser.find(pattern, 'ZZ').value) {
             return new Date(Date.UTC(dt.Y, dt.M, dt.D, dt.H, dt.m + dt.Z, dt.s, dt.S));
         }
         return new Date(dt.Y, dt.M, dt.D, dt.H, dt.m, dt.s, dt.S);
@@ -234,10 +236,10 @@ proto.parse = function (dateString, arg, utc) {
 };
 
 /**
- * Validation
- * @param {Object|string} arg1 - a date structure or a date string
- * @param {string|Array.<string>} [arg2] - a format string or its compiled object
- * @returns {boolean} whether the date string is a valid date
+ * Date and time string validation
+ * @param {Object|string} arg1 - A pre-parsed result object or a date and time string
+ * @param {string|Array.<string>} [arg2] - A format string or its compiled object
+ * @returns {boolean} Whether the date and time string is a valid date and time
  */
 proto.isValid = function (arg1, arg2) {
     var ctx = this || date, dt = typeof arg1 === 'string' ? ctx.preparse(arg1, arg2) : arg1,
@@ -252,12 +254,12 @@ proto.isValid = function (arg1, arg2) {
 };
 
 /**
- * Transforming a Date and Time string
- * @param {string} dateString - a date string
- * @param {string|Array.<string>} arg1 - a format string or its compiled object
- * @param {string|Array.<string>} arg2 - a transformed format string or its compiled object
- * @param {boolean} [utc] - output as UTC
- * @returns {string} a formatted string
+ * Format transformation of date and time string (String -> String)
+ * @param {string} dateString - A date and time string
+ * @param {string|Array.<string>} arg1 - A format string or its compiled object before transformation
+ * @param {string|Array.<string>} arg2 - A format string or its compiled object after transformation
+ * @param {boolean} [utc] - Output as UTC
+ * @returns {string} A formatted string
  */
 proto.transform = function (dateString, arg1, arg2, utc) {
     const ctx = this || date;
@@ -266,9 +268,9 @@ proto.transform = function (dateString, arg1, arg2, utc) {
 
 /**
  * Adding years
- * @param {Date} dateObj - a date object
- * @param {number} years - number of years to add
- * @returns {Date} a date after adding the value
+ * @param {Date} dateObj - A Date object
+ * @param {number} years - Number of years to add
+ * @returns {Date} The Date object after adding the value
  */
 proto.addYears = function (dateObj, years) {
     return (this || date).addMonths(dateObj, years * 12);
@@ -276,9 +278,9 @@ proto.addYears = function (dateObj, years) {
 
 /**
  * Adding months
- * @param {Date} dateObj - a date object
- * @param {number} months - number of months to add
- * @returns {Date} a date after adding the value
+ * @param {Date} dateObj - A Date object
+ * @param {number} months - Number of months to add
+ * @returns {Date} The Date object after adding the value
  */
 proto.addMonths = function (dateObj, months) {
     var d = new Date(dateObj.getTime());
@@ -289,9 +291,9 @@ proto.addMonths = function (dateObj, months) {
 
 /**
  * Adding days
- * @param {Date} dateObj - a date object
- * @param {number} days - number of days to add
- * @returns {Date} a date after adding the value
+ * @param {Date} dateObj - A Date object
+ * @param {number} days - Number of days to add
+ * @returns {Date} The Date object after adding the value
  */
 proto.addDays = function (dateObj, days) {
     var d = new Date(dateObj.getTime());
@@ -302,9 +304,9 @@ proto.addDays = function (dateObj, days) {
 
 /**
  * Adding hours
- * @param {Date} dateObj - a date object
- * @param {number} hours - number of hours to add
- * @returns {Date} a date after adding the value
+ * @param {Date} dateObj - A Date object
+ * @param {number} hours - Number of hours to add
+ * @returns {Date} The Date object after adding the value
  */
 proto.addHours = function (dateObj, hours) {
     return (this || date).addMinutes(dateObj, hours * 60);
@@ -312,9 +314,9 @@ proto.addHours = function (dateObj, hours) {
 
 /**
  * Adding minutes
- * @param {Date} dateObj - a date object
- * @param {number} minutes - number of minutes to add
- * @returns {Date} a date after adding the value
+ * @param {Date} dateObj - A Date object
+ * @param {number} minutes - Number of minutes to add
+ * @returns {Date} The Date object after adding the value
  */
 proto.addMinutes = function (dateObj, minutes) {
     return (this || date).addSeconds(dateObj, minutes * 60);
@@ -322,9 +324,9 @@ proto.addMinutes = function (dateObj, minutes) {
 
 /**
  * Adding seconds
- * @param {Date} dateObj - a date object
- * @param {number} seconds - number of seconds to add
- * @returns {Date} a date after adding the value
+ * @param {Date} dateObj - A Date object
+ * @param {number} seconds - Number of seconds to add
+ * @returns {Date} The Date object after adding the value
  */
 proto.addSeconds = function (dateObj, seconds) {
     return (this || date).addMilliseconds(dateObj, seconds * 1000);
@@ -332,19 +334,19 @@ proto.addSeconds = function (dateObj, seconds) {
 
 /**
  * Adding milliseconds
- * @param {Date} dateObj - a date object
- * @param {number} milliseconds - number of milliseconds to add
- * @returns {Date} a date after adding the value
+ * @param {Date} dateObj - A Date object
+ * @param {number} milliseconds - Number of milliseconds to add
+ * @returns {Date} The Date object after adding the value
  */
 proto.addMilliseconds = function (dateObj, milliseconds) {
     return new Date(dateObj.getTime() + milliseconds);
 };
 
 /**
- * Subtracting two dates
- * @param {Date} date1 - a Date object
- * @param {Date} date2 - a Date object
- * @returns {Object} a result object subtracting date2 from date1
+ * Subtracting two dates (date1 - date2)
+ * @param {Date} date1 - A Date object
+ * @param {Date} date2 - A Date object
+ * @returns {Object} The result object of subtracting date2 from date1
  */
 proto.subtract = function (date1, date2) {
     var delta = date1.getTime() - date2.getTime();
@@ -369,9 +371,9 @@ proto.subtract = function (date1, date2) {
 };
 
 /**
- * Whether year is leap year
- * @param {number} y - year
- * @returns {boolean} whether year is leap year
+ * Whether a year is a leap year
+ * @param {number} y - A year to check
+ * @returns {boolean} Whether the year is a leap year
  */
 proto.isLeapYear = function (y) {
     return (!(y % 4) && !!(y % 100)) || !(y % 400);
@@ -379,19 +381,19 @@ proto.isLeapYear = function (y) {
 
 /**
  * Comparison of two dates
- * @param {Date} date1 - a Date object
- * @param {Date} date2 - a Date object
- * @returns {boolean} whether the two dates are the same day (time is ignored)
+ * @param {Date} date1 - A Date object
+ * @param {Date} date2 - A Date object
+ * @returns {boolean} Whether the two dates are the same day (time is ignored)
  */
 proto.isSameDay = function (date1, date2) {
     return date1.toDateString() === date2.toDateString();
 };
 
 /**
- * Defining new locale
- * @param {string} code - language code
- * @param {Function} locale - locale installer
- * @returns {string} current language code
+ * Definition of new locale
+ * @param {string} code - A language code
+ * @param {Function} locale - A locale installer
+ * @returns {void}
  */
 proto.locale = function (code, locale) {
     if (!locales[code]) {
@@ -400,9 +402,9 @@ proto.locale = function (code, locale) {
 };
 
 /**
- * Defining new plugin
- * @param {string} name - plugin name
- * @param {Function} plugin - plugin installer
+ * Definition of new plugin
+ * @param {string} name - A plugin name
+ * @param {Function} plugin - A plugin installer
  * @returns {void}
  */
 proto.plugin = function (name, plugin) {
@@ -415,9 +417,9 @@ localized_proto = extend(proto);
 date = extend(proto);
 
 /**
- * Changing locale
- * @param {Function|string} [locale] - locale object | language code
- * @returns {string} current language code
+ * Changing locales
+ * @param {Function|string} [locale] - A locale installer or language code
+ * @returns {string} The current language code
  */
 date.locale = function (locale) {
     var install = typeof locale === 'function' ? locale : date.locale[locale];
@@ -443,8 +445,8 @@ date.locale = function (locale) {
 };
 
 /**
- * Feature extension
- * @param {Object} extension - extension object
+ * Functional extension
+ * @param {Object} extension - An extension object
  * @returns {void}
  */
 date.extend = function (extension) {
@@ -462,8 +464,8 @@ date.extend = function (extension) {
 };
 
 /**
- * Importing plugin
- * @param {Function|string} plugin - plugin object | plugin name
+ * Importing plugins
+ * @param {Function|string} plugin - A plugin installer or plugin name
  * @returns {void}
  */
 date.plugin = function (plugin) {

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

@@ -7,12 +7,12 @@ h:function(a){return""+(a.getHours()%12||12)},mm:function(a){return("0"+a.getMin
 dd:function(a){return this.res.dd[a.getDay()]},Z:function(a){a=a.getTimezoneOffset()/.6|0;return(0<a?"-":"+")+("000"+Math.abs(a-(a%100*.4|0))).slice(-4)},ZZ:function(a){a=a.getTimezoneOffset();var b=Math.abs(a);return(0<a?"-":"+")+("0"+(b/60|0)).slice(-2)+":"+("0"+b%60).slice(-2)},post:function(a){return a},res:n},r={YYYY:function(a){return this.exec(/^\d{4}/,a)},Y:function(a){return this.exec(/^\d{1,4}/,a)},MMMM:function(a){a=this.find(this.res.MMMM,a);a.value++;return a},MMM:function(a){a=this.find(this.res.MMM,
 a);a.value++;return a},MM:function(a){return this.exec(/^\d\d/,a)},M:function(a){return this.exec(/^\d\d?/,a)},DD:function(a){return this.exec(/^\d\d/,a)},D:function(a){return this.exec(/^\d\d?/,a)},HH:function(a){return this.exec(/^\d\d/,a)},H:function(a){return this.exec(/^\d\d?/,a)},A:function(a){return this.find(this.res.A,a)},hh:function(a){return this.exec(/^\d\d/,a)},h:function(a){return this.exec(/^\d\d?/,a)},mm:function(a){return this.exec(/^\d\d/,a)},m:function(a){return this.exec(/^\d\d?/,
 a)},ss:function(a){return this.exec(/^\d\d/,a)},s:function(a){return this.exec(/^\d\d?/,a)},SSS:function(a){return this.exec(/^\d{1,3}/,a)},SS:function(a){a=this.exec(/^\d\d?/,a);a.value*=10;return a},S:function(a){a=this.exec(/^\d/,a);a.value*=100;return a},Z:function(a){a=this.exec(/^[\+-]\d{2}[0-5]\d/,a);a.value=-60*(a.value/100|0)-a.value%100;return a},ZZ:function(a){a=/^([\+-])(\d{2}):([0-5]\d)/.exec(a)||["","","",""];return{value:-(60*(a[1]+a[2]|0)+(a[1]+a[3]|0)),length:a[0].length}},h12:function(a,
-b){return(12===a?0:a)+12*b},exec:function(a,b){a=(a.exec(b)||[""])[0];return{value:a|0,length:a.length}},find:function(a,b){for(var c=-1,d=0,h=0,g=a.length,l;h<g;h++)l=a[h],!b.indexOf(l)&&l.length>d&&(c=h,d=l.length);return{value:c,length:d}},pre:function(a){return a},res:n};function t(a,b,c,d){var h={},g;for(g in a)h[g]=a[g];for(g in b||{})!!c^!!h[g]||(h[g]=b[g]);d&&(h.res=d);return h}var u={_formatter:q,_parser:r},w,x;
-u.compile=function(a){for(var b=/\[([^\[\]]|\[[^\[\]]*])*]|([A-Za-z])\2+|\.{3}|./g,c,d=[a];c=b.exec(a);)d[d.length]=c[0];return d};u.format=function(a,b,c){var d=this||x;b="string"===typeof b?d.compile(b):b;var h=a.getTimezoneOffset();a=d.addMinutes(a,c?h:0);d=d._formatter;var g="";a.getTimezoneOffset=function(){return c?0:h};for(var l=1,v=b.length,k;l<v;l++)k=b[l],g+=d[k]?d.post(d[k](a,b[0])):k.replace(/\[(.*)]/,"$1");return g};
-u.preparse=function(a,b){var c=this||x;b="string"===typeof b?c.compile(b):b;var d={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},h=/\[(.*)]/;c=c._parser;var g=0;a=c.pre(a);for(var l=1,v=b.length,k,p;l<v;l++)if(k=b[l],c[k]){p=c[k](a.slice(g),b[0]);if(!p.length)break;g+=p.length;d[p.token||k.charAt(0)]=p.value;d._match++}else if(k===a.charAt(g)||" "===k)g++;else if(h.test(k)&&!a.slice(g).indexOf(h.exec(k)[1]))g+=k.length-2;else{"..."===k&&(g=a.length);break}d.H=d.H||c.h12(d.h,
-d.A);d._index=g;d._length=a.length;return d};u.parse=function(a,b,c){var d=this||x;a=d.preparse(a,b);return d.isValid(a)?(a.M-=100>a.Y?22801:1,c||a.Z?new Date(Date.UTC(a.Y,a.M,a.D,a.H,a.m+a.Z,a.s,a.S)):new Date(a.Y,a.M,a.D,a.H,a.m,a.s,a.S)):new Date(NaN)};
-u.isValid=function(a,b){var c=this||x;a="string"===typeof a?c.preparse(a,b):a;c=[31,28+c.isLeapYear(a.Y)|0,31,30,31,30,31,31,30,31,30,31][a.M-1];return!(1>a._index||1>a._length||a._index-a._length||1>a._match||1>a.Y||9999<a.Y||1>a.M||12<a.M||1>a.D||a.D>c||0>a.H||23<a.H||0>a.m||59<a.m||0>a.s||59<a.s||0>a.S||999<a.S||-840>a.Z||720<a.Z)};u.transform=function(a,b,c,d){let h=this||x;return h.format(h.parse(a,b),c,d)};u.addYears=function(a,b){return(this||x).addMonths(a,12*b)};
+b){return(12===a?0:a)+12*b},exec:function(a,b){a=(a.exec(b)||[""])[0];return{value:a|0,length:a.length}},find:function(a,b){for(var d=-1,c=0,h=0,g=a.length,l;h<g;h++)l=a[h],!b.indexOf(l)&&l.length>c&&(d=h,c=l.length);return{value:d,length:c}},pre:function(a){return a},res:n};function t(a,b,d,c){var h={},g;for(g in a)h[g]=a[g];for(g in b||{})!!d^!!h[g]||(h[g]=b[g]);c&&(h.res=c);return h}var u={_formatter:q,_parser:r},w,x;
+u.compile=function(a){for(var b=/\[([^\[\]]|\[[^\[\]]*])*]|([A-Za-z])\2+|\.{3}|./g,d,c=[a];d=b.exec(a);)c[c.length]=d[0];return c};u.format=function(a,b,d){var c=this||x;b="string"===typeof b?c.compile(b):b;var h=a.getTimezoneOffset();a=c.addMinutes(a,d?h:0);c=c._formatter;var g="";a.getTimezoneOffset=function(){return d?0:h};for(var l=1,v=b.length,k;l<v;l++)k=b[l],g+=c[k]?c.post(c[k](a,b[0])):k.replace(/\[(.*)]/,"$1");return g};
+u.preparse=function(a,b){var d=this||x;b="string"===typeof b?d.compile(b):b;var c={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},h=/\[(.*)]/;d=d._parser;var g=0;a=d.pre(a);for(var l=1,v=b.length,k,p;l<v;l++)if(k=b[l],d[k]){p=d[k](a.slice(g),b[0]);if(!p.length)break;g+=p.length;c[p.token||k.charAt(0)]=p.value;c._match++}else if(k===a.charAt(g)||" "===k)g++;else if(h.test(k)&&!a.slice(g).indexOf(h.exec(k)[1]))g+=k.length-2;else{"..."===k&&(g=a.length);break}c.H=c.H||d.h12(c.h,
+c.A);c._index=g;c._length=a.length;return c};u.parse=function(a,b,d){var c=this||x;b="string"===typeof b?c.compile(b):b;a=c.preparse(a,b);return c.isValid(a)?(a.M-=100>a.Y?22801:1,d||~c._parser.find(b,"ZZ").value?new Date(Date.UTC(a.Y,a.M,a.D,a.H,a.m+a.Z,a.s,a.S)):new Date(a.Y,a.M,a.D,a.H,a.m,a.s,a.S)):new Date(NaN)};
+u.isValid=function(a,b){var d=this||x;a="string"===typeof a?d.preparse(a,b):a;d=[31,28+d.isLeapYear(a.Y)|0,31,30,31,30,31,31,30,31,30,31][a.M-1];return!(1>a._index||1>a._length||a._index-a._length||1>a._match||1>a.Y||9999<a.Y||1>a.M||12<a.M||1>a.D||a.D>d||0>a.H||23<a.H||0>a.m||59<a.m||0>a.s||59<a.s||0>a.S||999<a.S||-840>a.Z||720<a.Z)};u.transform=function(a,b,d,c){let h=this||x;return h.format(h.parse(a,b),d,c)};u.addYears=function(a,b){return(this||x).addMonths(a,12*b)};
 u.addMonths=function(a,b){a=new Date(a.getTime());a.setMonth(a.getMonth()+b);return a};u.addDays=function(a,b){a=new Date(a.getTime());a.setDate(a.getDate()+b);return a};u.addHours=function(a,b){return(this||x).addMinutes(a,60*b)};u.addMinutes=function(a,b){return(this||x).addSeconds(a,60*b)};u.addSeconds=function(a,b){return(this||x).addMilliseconds(a,1E3*b)};u.addMilliseconds=function(a,b){return new Date(a.getTime()+b)};
-u.subtract=function(a,b){var c=a.getTime()-b.getTime();return{toMilliseconds:function(){return c},toSeconds:function(){return c/1E3},toMinutes:function(){return c/6E4},toHours:function(){return c/36E5},toDays:function(){return c/864E5}}};u.isLeapYear=function(a){return!(a%4)&&!!(a%100)||!(a%400)};u.isSameDay=function(a,b){return a.toDateString()===b.toDateString()};u.locale=function(a,b){e[a]||(e[a]=b)};u.plugin=function(a,b){f[a]||(f[a]=b)};w=t(u);x=t(u);
-x.locale=function(a){a="function"===typeof a?a:x.locale[a];if(!a)return m;m=a(u);var b=e[m]||{},c=t(n,b.res,!0);a=t(q,b.formatter,!0,c);b=t(r,b.parser,!0,c);x._formatter=w._formatter=a;x._parser=w._parser=b;for(var d in f)x.extend(f[d]);return m};x.extend=function(a){var b=t(x._parser.res,a.res),c=a.extender||{};x._formatter=t(x._formatter,a.formatter,!1,b);x._parser=t(x._parser,a.parser,!1,b);for(var d in c)x[d]||(x[d]=c[d])};
+u.subtract=function(a,b){var d=a.getTime()-b.getTime();return{toMilliseconds:function(){return d},toSeconds:function(){return d/1E3},toMinutes:function(){return d/6E4},toHours:function(){return d/36E5},toDays:function(){return d/864E5}}};u.isLeapYear=function(a){return!(a%4)&&!!(a%100)||!(a%400)};u.isSameDay=function(a,b){return a.toDateString()===b.toDateString()};u.locale=function(a,b){e[a]||(e[a]=b)};u.plugin=function(a,b){f[a]||(f[a]=b)};w=t(u);x=t(u);
+x.locale=function(a){a="function"===typeof a?a:x.locale[a];if(!a)return m;m=a(u);var b=e[m]||{},d=t(n,b.res,!0);a=t(q,b.formatter,!0,d);b=t(r,b.parser,!0,d);x._formatter=w._formatter=a;x._parser=w._parser=b;for(var c in f)x.extend(f[c]);return m};x.extend=function(a){var b=t(x._parser.res,a.res),d=a.extender||{};x._formatter=t(x._formatter,a.formatter,!1,b);x._parser=t(x._parser,a.parser,!1,b);for(var c in d)x[c]||(x[c]=d[c])};
 x.plugin=function(a){(a="function"===typeof a?a:x.plugin[a])&&x.extend(f[a(u,w)]||{})};export default x

package/esm/date-and-time.mjs

@@ -140,9 +140,9 @@ var locales = {},
     date;
 
 /**
- * Compiling a format string
- * @param {string} formatString - a format string
- * @returns {Array.<string>} a compiled object
+ * Compiling format strings
+ * @param {string} formatString - A format string
+ * @returns {Array.<string>} A compiled object
  */
 proto.compile = function (formatString) {
     var re = /\[([^\[\]]|\[[^\[\]]*])*]|([A-Za-z])\2+|\.{3}|./g, keys, pattern = [formatString];
@@ -154,11 +154,11 @@ proto.compile = function (formatString) {
 };
 
 /**
- * Formatting a Date and Time
- * @param {Date} dateObj - a Date object
- * @param {string|Array.<string>} arg - a format string or its compiled object
- * @param {boolean} [utc] - output as UTC
- * @returns {string} a formatted string
+ * Formatting date and time objects (Date -> String)
+ * @param {Date} dateObj - A Date object
+ * @param {string|Array.<string>} arg - A format string or its compiled object
+ * @param {boolean} [utc] - Output as UTC
+ * @returns {string} A formatted string
  */
 proto.format = function (dateObj, arg, utc) {
     var ctx = this || date, pattern = typeof arg === 'string' ? ctx.compile(arg) : arg,
@@ -175,10 +175,11 @@ proto.format = function (dateObj, arg, utc) {
 };
 
 /**
- * Pre-parsing a Date and Time string
- * @param {string} dateString - a date string
- * @param {string|Array.<string>} arg - a format string or its compiled object
- * @returns {Object} a date structure
+ * Pre-parsing date and time strings
+ * @param {string} dateString - A date and time string
+ * @param {string|Array.<string>} arg - A format string or its compiled object
+ * @param {boolean} [utc] - Input as UTC
+ * @returns {Object} A pre-parsed result object
  */
 proto.preparse = function (dateString, arg) {
     var ctx = this || date, pattern = typeof arg === 'string' ? ctx.compile(arg) : arg,
@@ -214,18 +215,19 @@ proto.preparse = function (dateString, arg) {
 };
 
 /**
- * Parsing a Date and Time string
- * @param {string} dateString - a date string
- * @param {string|Array.<string>} arg - a format string or its compiled object
- * @param {boolean} [utc] - input as UTC
- * @returns {Date} a constructed date
+ * Parsing of date and time string (String -> Date)
+ * @param {string} dateString - A date-time string
+ * @param {string|Array.<string>} arg - A format string or its compiled object
+ * @param {boolean} [utc] - Input as UTC
+ * @returns {Date} A Date object
  */
 proto.parse = function (dateString, arg, utc) {
-    var ctx = this || date, dt = ctx.preparse(dateString, arg);
+    var ctx = this || date, pattern = typeof arg === 'string' ? ctx.compile(arg) : arg,
+        dt = ctx.preparse(dateString, pattern);
 
     if (ctx.isValid(dt)) {
         dt.M -= dt.Y < 100 ? 22801 : 1; // 22801 = 1900 * 12 + 1
-        if (utc || dt.Z) {
+        if (utc || ~ctx._parser.find(pattern, 'ZZ').value) {
             return new Date(Date.UTC(dt.Y, dt.M, dt.D, dt.H, dt.m + dt.Z, dt.s, dt.S));
         }
         return new Date(dt.Y, dt.M, dt.D, dt.H, dt.m, dt.s, dt.S);
@@ -234,10 +236,10 @@ proto.parse = function (dateString, arg, utc) {
 };
 
 /**
- * Validation
- * @param {Object|string} arg1 - a date structure or a date string
- * @param {string|Array.<string>} [arg2] - a format string or its compiled object
- * @returns {boolean} whether the date string is a valid date
+ * Date and time string validation
+ * @param {Object|string} arg1 - A pre-parsed result object or a date and time string
+ * @param {string|Array.<string>} [arg2] - A format string or its compiled object
+ * @returns {boolean} Whether the date and time string is a valid date and time
  */
 proto.isValid = function (arg1, arg2) {
     var ctx = this || date, dt = typeof arg1 === 'string' ? ctx.preparse(arg1, arg2) : arg1,
@@ -252,12 +254,12 @@ proto.isValid = function (arg1, arg2) {
 };
 
 /**
- * Transforming a Date and Time string
- * @param {string} dateString - a date string
- * @param {string|Array.<string>} arg1 - a format string or its compiled object
- * @param {string|Array.<string>} arg2 - a transformed format string or its compiled object
- * @param {boolean} [utc] - output as UTC
- * @returns {string} a formatted string
+ * Format transformation of date and time string (String -> String)
+ * @param {string} dateString - A date and time string
+ * @param {string|Array.<string>} arg1 - A format string or its compiled object before transformation
+ * @param {string|Array.<string>} arg2 - A format string or its compiled object after transformation
+ * @param {boolean} [utc] - Output as UTC
+ * @returns {string} A formatted string
  */
 proto.transform = function (dateString, arg1, arg2, utc) {
     const ctx = this || date;
@@ -266,9 +268,9 @@ proto.transform = function (dateString, arg1, arg2, utc) {
 
 /**
  * Adding years
- * @param {Date} dateObj - a date object
- * @param {number} years - number of years to add
- * @returns {Date} a date after adding the value
+ * @param {Date} dateObj - A Date object
+ * @param {number} years - Number of years to add
+ * @returns {Date} The Date object after adding the value
  */
 proto.addYears = function (dateObj, years) {
     return (this || date).addMonths(dateObj, years * 12);
@@ -276,9 +278,9 @@ proto.addYears = function (dateObj, years) {
 
 /**
  * Adding months
- * @param {Date} dateObj - a date object
- * @param {number} months - number of months to add
- * @returns {Date} a date after adding the value
+ * @param {Date} dateObj - A Date object
+ * @param {number} months - Number of months to add
+ * @returns {Date} The Date object after adding the value
  */
 proto.addMonths = function (dateObj, months) {
     var d = new Date(dateObj.getTime());
@@ -289,9 +291,9 @@ proto.addMonths = function (dateObj, months) {
 
 /**
  * Adding days
- * @param {Date} dateObj - a date object
- * @param {number} days - number of days to add
- * @returns {Date} a date after adding the value
+ * @param {Date} dateObj - A Date object
+ * @param {number} days - Number of days to add
+ * @returns {Date} The Date object after adding the value
  */
 proto.addDays = function (dateObj, days) {
     var d = new Date(dateObj.getTime());
@@ -302,9 +304,9 @@ proto.addDays = function (dateObj, days) {
 
 /**
  * Adding hours
- * @param {Date} dateObj - a date object
- * @param {number} hours - number of hours to add
- * @returns {Date} a date after adding the value
+ * @param {Date} dateObj - A Date object
+ * @param {number} hours - Number of hours to add
+ * @returns {Date} The Date object after adding the value
  */
 proto.addHours = function (dateObj, hours) {
     return (this || date).addMinutes(dateObj, hours * 60);
@@ -312,9 +314,9 @@ proto.addHours = function (dateObj, hours) {
 
 /**
  * Adding minutes
- * @param {Date} dateObj - a date object
- * @param {number} minutes - number of minutes to add
- * @returns {Date} a date after adding the value
+ * @param {Date} dateObj - A Date object
+ * @param {number} minutes - Number of minutes to add
+ * @returns {Date} The Date object after adding the value
  */
 proto.addMinutes = function (dateObj, minutes) {
     return (this || date).addSeconds(dateObj, minutes * 60);
@@ -322,9 +324,9 @@ proto.addMinutes = function (dateObj, minutes) {
 
 /**
  * Adding seconds
- * @param {Date} dateObj - a date object
- * @param {number} seconds - number of seconds to add
- * @returns {Date} a date after adding the value
+ * @param {Date} dateObj - A Date object
+ * @param {number} seconds - Number of seconds to add
+ * @returns {Date} The Date object after adding the value
  */
 proto.addSeconds = function (dateObj, seconds) {
     return (this || date).addMilliseconds(dateObj, seconds * 1000);
@@ -332,19 +334,19 @@ proto.addSeconds = function (dateObj, seconds) {
 
 /**
  * Adding milliseconds
- * @param {Date} dateObj - a date object
- * @param {number} milliseconds - number of milliseconds to add
- * @returns {Date} a date after adding the value
+ * @param {Date} dateObj - A Date object
+ * @param {number} milliseconds - Number of milliseconds to add
+ * @returns {Date} The Date object after adding the value
  */
 proto.addMilliseconds = function (dateObj, milliseconds) {
     return new Date(dateObj.getTime() + milliseconds);
 };
 
 /**
- * Subtracting two dates
- * @param {Date} date1 - a Date object
- * @param {Date} date2 - a Date object
- * @returns {Object} a result object subtracting date2 from date1
+ * Subtracting two dates (date1 - date2)
+ * @param {Date} date1 - A Date object
+ * @param {Date} date2 - A Date object
+ * @returns {Object} The result object of subtracting date2 from date1
  */
 proto.subtract = function (date1, date2) {
     var delta = date1.getTime() - date2.getTime();
@@ -369,9 +371,9 @@ proto.subtract = function (date1, date2) {
 };
 
 /**
- * Whether year is leap year
- * @param {number} y - year
- * @returns {boolean} whether year is leap year
+ * Whether a year is a leap year
+ * @param {number} y - A year to check
+ * @returns {boolean} Whether the year is a leap year
  */
 proto.isLeapYear = function (y) {
     return (!(y % 4) && !!(y % 100)) || !(y % 400);
@@ -379,19 +381,19 @@ proto.isLeapYear = function (y) {
 
 /**
  * Comparison of two dates
- * @param {Date} date1 - a Date object
- * @param {Date} date2 - a Date object
- * @returns {boolean} whether the two dates are the same day (time is ignored)
+ * @param {Date} date1 - A Date object
+ * @param {Date} date2 - A Date object
+ * @returns {boolean} Whether the two dates are the same day (time is ignored)
  */
 proto.isSameDay = function (date1, date2) {
     return date1.toDateString() === date2.toDateString();
 };
 
 /**
- * Defining new locale
- * @param {string} code - language code
- * @param {Function} locale - locale installer
- * @returns {string} current language code
+ * Definition of new locale
+ * @param {string} code - A language code
+ * @param {Function} locale - A locale installer
+ * @returns {void}
  */
 proto.locale = function (code, locale) {
     if (!locales[code]) {
@@ -400,9 +402,9 @@ proto.locale = function (code, locale) {
 };
 
 /**
- * Defining new plugin
- * @param {string} name - plugin name
- * @param {Function} plugin - plugin installer
+ * Definition of new plugin
+ * @param {string} name - A plugin name
+ * @param {Function} plugin - A plugin installer
  * @returns {void}
  */
 proto.plugin = function (name, plugin) {
@@ -415,9 +417,9 @@ localized_proto = extend(proto);
 date = extend(proto);
 
 /**
- * Changing locale
- * @param {Function|string} [locale] - locale object | language code
- * @returns {string} current language code
+ * Changing locales
+ * @param {Function|string} [locale] - A locale installer or language code
+ * @returns {string} The current language code
  */
 date.locale = function (locale) {
     var install = typeof locale === 'function' ? locale : date.locale[locale];
@@ -443,8 +445,8 @@ date.locale = function (locale) {
 };
 
 /**
- * Feature extension
- * @param {Object} extension - extension object
+ * Functional extension
+ * @param {Object} extension - An extension object
  * @returns {void}
  */
 date.extend = function (extension) {
@@ -462,8 +464,8 @@ date.extend = function (extension) {
 };
 
 /**
- * Importing plugin
- * @param {Function|string} plugin - plugin object | plugin name
+ * Importing plugins
+ * @param {Function|string} plugin - A plugin installer or plugin name
  * @returns {void}
  */
 date.plugin = function (plugin) {

package/esm/plugin/timezone.es.js

@@ -30,10 +30,8 @@ var plugin = function (date, localized_date) {
         var pattern2 = typeof arg === 'string' ? date.compile(arg) : arg;
         var dateObj = localized_date.parse(dateString, pattern2, true);
 
-        for (var i = 1, len = pattern2.length; i < len; i++) {
-            if (pattern2[i].indexOf('Z') === 0) {
-                return dateObj;
-            }
+        if (~date._parser.find(pattern2, 'ZZ').value) {
+            return dateObj;
         }
 
         options.timeZone = timeZone;
@@ -56,7 +54,7 @@ var plugin = function (date, localized_date) {
                 return d;
             }
         }
-        return NaN;
+        return new Date(NaN);
     };
     var transformTZ = function (dateString, arg1, arg2, timeZone) {
         return formatTZ(localized_date.parse(dateString, arg1), arg2, timeZone);