doc: ported and updated old doc for Date#toJSON.

2009-09-07 21:31:45 +02:00 · 2009-09-07 21:31:45 +02:00 · a7e8e9aa7d
commit a7e8e9aa7d
parent 12b74e6644
1 changed files with 9 additions and 0 deletions
--- a/src/lang/date.js
+++ b/src/lang/date.js
@ -8,6 +8,15 @@
 *  Date#toJSON() -> String
 *
 *  Produces a string representation of the date in ISO 8601 format.
+ *  The time zone is always UTC, as denoted by the suffix "Z".
+ *
+ *  ### Example
+ *
+ *      var d = new Date(1969, 11, 31, 19);
+ *      d.getTimezoneOffset();
+ *      //-> -180 (time offest is given in minutes.)
+ *      d.toJSON();
+ *      //-> '"1969-12-31T16:00:00Z"'
 **/
 Date.prototype.toJSON = function() {
  return '"' + this.getUTCFullYear() + '-' +