@qooxdoo/framework
Version:
The JS Framework for Coders
158 lines (143 loc) • 5.37 kB
JavaScript
/* ************************************************************************
qooxdoo - the new era of web development
http://qooxdoo.org
Copyright:
2004-2012 1&1 Internet AG, Germany, http://www.1und1.de
License:
MIT: https://opensource.org/licenses/MIT
See the LICENSE file in the project's top-level directory for details.
Authors:
* Martin Wittemann (wittemann)
************************************************************************ */
/**
* This class is responsible for the normalization of the native 'Date' object.
* It checks if these methods are available and, if not, appends them to
* ensure compatibility in all browsers.
* For usage samples, check out the attached links.
*
* @group (Polyfill)
*
* @deprecated {7.0}
* This normalizer handles Date.parse and Date.now. The former has
* been standardized since IE version 3, and the latter, since IE
* version 9, both ancient. There is no need for this normalizer any
* longer.
*/
qx.Bootstrap.define("qx.lang.normalize.Date", {
statics: {
/**
* Returns the time elapsed since January 1, 1970 in milliseconds.
*
* <a href="https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Global_Objects/Date/now">MDN documentation</a> |
* <a href="http://es5.github.com/#x15.9.4.4">Annotated ES5 Spec</a>
*
* @return {Integer} Milliseconds since the Unix Epoch
*/
now() {
return +new Date();
},
/**
* Parses a string representation of a date and return number of
* milliseconds since Epoch or NaN if string is unrecognized.
*
* <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse">MDN documentation</a>
*
* Derived from <https://github.com/csnover/js-iso8601>: ©2011 Colin Snover
* <http://zetafleet.com>, MIT license
*
* @param dateString {String} A string representing an RFC2822 or ISO 8601
* date (other formats may be used, but results may be unexpected).
* @return {Number} A number representing the milliseconds elapsed
* since January 1, 1970, 00:00:00 UTC and the date obtained by parsing
* the given string representation of a date.
* If the argument doesn't represent a valid date, NaN is returned.
*/
parse(dateString) {
// Match input against ISO8601 regular expression
var captureGroups =
/^(\d{4}|[+\-]\d{6})(?:-(\d{2})(?:-(\d{2}))?)?(?:T(\d{2}):(\d{2})(?::(\d{2})(?:\.(\d{3}))?)?(?:(Z)|([+\-])(\d{2})(?::(\d{2}))?)?)?$/.exec(
dateString
);
if (!captureGroups) {
//
// if the regular expression does not match parse the string
// using the original function.
// Additionally check if it returns a real time value, which we
// ensure by using setTime with an intermediate Date object and the
// parsed time value.
// Safari 11 e.g. parses the date string '19700101' successfully
// into a time value, but returns NaN if that value is used in setTime.
//
// See:
// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse
// https://github.com/qooxdoo/qooxdoo/issues/9451
//
var time = Date.originalParse(dateString);
if (isNaN(time) || isNaN(new Date().setTime(time))) {
return NaN;
}
return time;
}
// Just a date without time?
var noTime = [4, 5, 6, 7].every(function (i) {
return captureGroups[i] === undefined;
});
// Avoid invalid timestamps caused by undefined values being passed to Date.UTC
[1, 4, 5, 6, 7, 10, 11].forEach(function (i) {
captureGroups[i] = +captureGroups[i] || 0;
});
captureGroups[2] = (+captureGroups[2] || 1) - 1; // Allow undefined months
captureGroups[3] = +captureGroups[3] || 1; // Allow undefined days
// No timezone offset given and *not* just a date (without time)
if (
captureGroups[8] !== "Z" &&
captureGroups[9] === undefined &&
!noTime
) {
// => Treat as local
return new Date(
captureGroups[1],
captureGroups[2],
captureGroups[3],
captureGroups[4],
captureGroups[5],
captureGroups[6],
captureGroups[7]
).getTime();
}
// Handle timezone offsets
var minutesOffset = 0;
if (captureGroups[8] !== "Z") {
minutesOffset = captureGroups[10] * 60 + captureGroups[11];
if (captureGroups[9] === "+") {
minutesOffset = -minutesOffset;
}
}
// Return the number of milliseconds since Epoch
return Date.UTC(
captureGroups[1],
captureGroups[2],
captureGroups[3],
captureGroups[4],
captureGroups[5] + minutesOffset,
captureGroups[6],
captureGroups[7]
);
}
},
defer(statics) {
// Date.now
if (!qx.core.Environment.get("ecmascript.date.now")) {
Date.now = statics.now;
}
// Date.parse
if (!qx.core.Environment.get("ecmascript.date.parse")) {
Date.originalParse =
Date.parse ||
function (dateString) {
return NaN;
};
Date.parse = statics.parse;
}
}
});