git.roojs.org Git - roojs1/blob - docs/src/Date.js.html

   1 <html><head><title>Date.js</title><link rel="stylesheet" type="text/css" href="../../css/highlight-js.css"/></head><body class="highlightpage"><code class="jsdoc-pretty"><span class="jsdoc-comment">/*
   2  * Based on:
   3  * Ext JS Library 1.1.1
   4  * Copyright(c) 2006-2007, Ext JS, LLC.
   5  *
   6  * Originally Released Under LGPL - original licence link has changed is not relivant.
   7  *
   8  * Fork - LGPL
   9  * &lt;script type=&quot;text/javascript&quot;&gt;
  10  */
  11
  12 /**
  13  * @class Date
  14  *
  15  * The date parsing and format syntax is a subset of
  16  * &lt;a href=&quot;http://www.php.net/date&quot;&gt;PHP's date() function&lt;/a&gt;, and the formats that are
  17  * supported will provide results equivalent to their PHP versions.
  18  *
  19  * Following is the list of all currently supported formats:
  20  *&lt;pre&gt;
  21 Sample date:
  22 'Wed Jan 10 2007 15:05:01 GMT-0600 (Central Standard Time)'
  23
  24 Format  Output      Description
  25 ------  ----------  --------------------------------------------------------------
  26   d      10         Day of the month, 2 digits with leading zeros
  27   D      Wed        A textual representation of a day, three letters
  28   j      10         Day of the month without leading zeros
  29   l      Wednesday  A full textual representation of the day of the week
  30   S      th         English ordinal day of month suffix, 2 chars (use with j)
  31   w      3          Numeric representation of the day of the week
  32   z      9          The julian date, or day of the year (0-365)
  33   W      01         ISO-8601 2-digit week number of year, weeks starting on Monday (00-52)
  34   F      January    A full textual representation of the month
  35   m      01         Numeric representation of a month, with leading zeros
  36   M      Jan        Month name abbreviation, three letters
  37   n      1          Numeric representation of a month, without leading zeros
  38   t      31         Number of days in the given month
  39   L      0          Whether it's a leap year (1 if it is a leap year, else 0)
  40   Y      2007       A full numeric representation of a year, 4 digits
  41   y      07         A two digit representation of a year
  42   a      pm         Lowercase Ante meridiem and Post meridiem
  43   A      PM         Uppercase Ante meridiem and Post meridiem
  44   g      3          12-hour format of an hour without leading zeros
  45   G      15         24-hour format of an hour without leading zeros
  46   h      03         12-hour format of an hour with leading zeros
  47   H      15         24-hour format of an hour with leading zeros
  48   i      05         Minutes with leading zeros
  49   s      01         Seconds, with leading zeros
  50   O      -0600      Difference to Greenwich time (GMT) in hours (Allows +08, without minutes)
  51   P      -06:00     Difference to Greenwich time (GMT) with colon between hours and minutes
  52   T      CST        Timezone setting of the machine running the code
  53   Z      -21600     Timezone offset in seconds (negative if west of UTC, positive if east)
  54 &lt;/pre&gt;
  55  *
  56  * Example usage (note that you must escape format specifiers with '\\' to render them as character literals):
  57  * &lt;pre&gt;&lt;code&gt;
  58 var dt = new Date('1/10/2007 03:05:01 PM GMT-0600');
  59 document.write(dt.format('Y-m-d'));                         //2007-01-10
  60 document.write(dt.format('F j, Y, g:i a'));                 //January 10, 2007, 3:05 pm
  61 document.write(dt.format('l, \\t\\he dS of F Y h:i:s A'));  //Wednesday, the 10th of January 2007 03:05:01 PM
  62  &lt;/code&gt;&lt;/pre&gt;
  63  *
  64  * Here are some standard date/time patterns that you might find helpful.  They
  65  * are not part of the source of Date.js, but to use them you can simply copy this
  66  * block of code into any script that is included after Date.js and they will also become
  67  * globally available on the Date object.  Feel free to add or remove patterns as needed in your code.
  68  * &lt;pre&gt;&lt;code&gt;
  69 Date.patterns = {
  70     ISO8601Long:&quot;Y-m-d H:i:s&quot;,
  71     ISO8601Short:&quot;Y-m-d&quot;,
  72     ShortDate: &quot;n/j/Y&quot;,
  73     LongDate: &quot;l, F d, Y&quot;,
  74     FullDateTime: &quot;l, F d, Y g:i:s A&quot;,
  75     MonthDay: &quot;F d&quot;,
  76     ShortTime: &quot;g:i A&quot;,
  77     LongTime: &quot;g:i:s A&quot;,
  78     SortableDateTime: &quot;Y-m-d\\TH:i:s&quot;,
  79     UniversalSortableDateTime: &quot;Y-m-d H:i:sO&quot;,
  80     YearMonth: &quot;F, Y&quot;
  81 };
  82 &lt;/code&gt;&lt;/pre&gt;
  83  *
  84  * Example usage:
  85  * &lt;pre&gt;&lt;code&gt;
  86 var dt = new Date();
  87 document.write(dt.format(Date.patterns.ShortDate));
  88  &lt;/code&gt;&lt;/pre&gt;
  89  */
  90
  91 /*
  92  * Most of the date-formatting functions below are the excellent work of Baron Schwartz.
  93  * They generate precompiled functions from date formats instead of parsing and
  94  * processing the pattern every time you format a date.  These functions are available
  95  * on every Date object (any javascript function).
  96  *
  97  * The original article and download are here:
  98  * http://www.xaprb.com/blog/2005/12/12/javascript-closures-for-runtime-efficiency/
  99  *
 100  */
 101
 102
 103  // was in core
 104 /**
 105  Returns the number of milliseconds between this date and date
 106  @param {Date} date (optional) Defaults to now
 107  @param {String} interval (optional) Default Date.MILLI, A valid date interval enum value (eg. Date.DAY)
 108  @return {Number} The diff in milliseconds or units of interval
 109  @member Date getElapsed
 110  */
 111 </span><span class="jsdoc-var">Date.prototype.getElapsed </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">date</span><span class="jsdoc-syntax">, </span><span class="jsdoc-var">interval</span><span class="jsdoc-syntax">)
 112 {
 113     </span><span class="jsdoc-var">date </span><span class="jsdoc-syntax">= </span><span class="jsdoc-var">date </span><span class="jsdoc-syntax">||  </span><span class="jsdoc-keyword">new </span><span class="jsdoc-var">Date</span><span class="jsdoc-syntax">();
 114     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">ret </span><span class="jsdoc-syntax">= </span><span class="jsdoc-var">Math.abs</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">date.getTime</span><span class="jsdoc-syntax">()-</span><span class="jsdoc-var">this.getTime</span><span class="jsdoc-syntax">());
 115     </span><span class="jsdoc-keyword">switch </span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">interval</span><span class="jsdoc-syntax">) {
 116
 117         </span><span class="jsdoc-keyword">case  </span><span class="jsdoc-var">Date.SECOND</span><span class="jsdoc-syntax">:
 118             </span><span class="jsdoc-keyword">return </span><span class="jsdoc-var">Math.floor</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">ret </span><span class="jsdoc-syntax">/ (1000));
 119         </span><span class="jsdoc-keyword">case  </span><span class="jsdoc-var">Date.MINUTE</span><span class="jsdoc-syntax">:
 120             </span><span class="jsdoc-keyword">return </span><span class="jsdoc-var">Math.floor</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">ret </span><span class="jsdoc-syntax">/ (100*60));
 121         </span><span class="jsdoc-keyword">case  </span><span class="jsdoc-var">Date.HOUR</span><span class="jsdoc-syntax">:
 122             </span><span class="jsdoc-keyword">return </span><span class="jsdoc-var">Math.floor</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">ret </span><span class="jsdoc-syntax">/ (100*60*60));
 123         </span><span class="jsdoc-keyword">case  </span><span class="jsdoc-var">Date.DAY</span><span class="jsdoc-syntax">:
 124             </span><span class="jsdoc-keyword">return </span><span class="jsdoc-var">Math.floor</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">ret </span><span class="jsdoc-syntax">/ (100*60*60*24));
 125         </span><span class="jsdoc-keyword">case  </span><span class="jsdoc-var">Date.MONTH</span><span class="jsdoc-syntax">: </span><span class="jsdoc-comment">// this does not give exact number...??
 126             </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">((</span><span class="jsdoc-var">date.format</span><span class="jsdoc-syntax">(</span><span class="jsdoc-string">&quot;Y&quot;</span><span class="jsdoc-syntax">) - </span><span class="jsdoc-var">this.format</span><span class="jsdoc-syntax">(</span><span class="jsdoc-string">&quot;Y&quot;</span><span class="jsdoc-syntax">)) * 12) + (</span><span class="jsdoc-var">date.format</span><span class="jsdoc-syntax">(</span><span class="jsdoc-string">&quot;m&quot;</span><span class="jsdoc-syntax">) - </span><span class="jsdoc-var">this.format</span><span class="jsdoc-syntax">(</span><span class="jsdoc-string">&quot;m&quot;</span><span class="jsdoc-syntax">));
 127         </span><span class="jsdoc-keyword">case  </span><span class="jsdoc-var">Date.YEAR</span><span class="jsdoc-syntax">: </span><span class="jsdoc-comment">// this does not give exact number...??
 128             </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">date.format</span><span class="jsdoc-syntax">(</span><span class="jsdoc-string">&quot;Y&quot;</span><span class="jsdoc-syntax">) - </span><span class="jsdoc-var">this.format</span><span class="jsdoc-syntax">(</span><span class="jsdoc-string">&quot;Y&quot;</span><span class="jsdoc-syntax">));
 129
 130         </span><span class="jsdoc-keyword">case  </span><span class="jsdoc-var">Date.MILLI</span><span class="jsdoc-syntax">:
 131         </span><span class="jsdoc-keyword">default</span><span class="jsdoc-syntax">:
 132             </span><span class="jsdoc-keyword">return </span><span class="jsdoc-var">ret</span><span class="jsdoc-syntax">;
 133     }
 134 };
 135
 136 </span><span class="jsdoc-comment">// was in date file..
 137
 138
 139 // private
 140 </span><span class="jsdoc-var">Date.parseFunctions </span><span class="jsdoc-syntax">= {</span><span class="jsdoc-var">count</span><span class="jsdoc-syntax">:0};
 141 </span><span class="jsdoc-comment">// private
 142 </span><span class="jsdoc-var">Date.parseRegexes </span><span class="jsdoc-syntax">= [];
 143 </span><span class="jsdoc-comment">// private
 144 </span><span class="jsdoc-var">Date.formatFunctions </span><span class="jsdoc-syntax">= {</span><span class="jsdoc-var">count</span><span class="jsdoc-syntax">:0};
 145
 146 </span><span class="jsdoc-comment">// private
 147 </span><span class="jsdoc-var">Date.prototype.dateFormat </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">format</span><span class="jsdoc-syntax">) {
 148     </span><span class="jsdoc-keyword">if </span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">Date.formatFunctions</span><span class="jsdoc-syntax">[</span><span class="jsdoc-var">format</span><span class="jsdoc-syntax">] == </span><span class="jsdoc-keyword">null</span><span class="jsdoc-syntax">) {
 149         </span><span class="jsdoc-var">Date.createNewFormat</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">format</span><span class="jsdoc-syntax">);
 150     }
 151     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">func </span><span class="jsdoc-syntax">= </span><span class="jsdoc-var">Date.formatFunctions</span><span class="jsdoc-syntax">[</span><span class="jsdoc-var">format</span><span class="jsdoc-syntax">];
 152     </span><span class="jsdoc-keyword">return </span><span class="jsdoc-var">this</span><span class="jsdoc-syntax">[</span><span class="jsdoc-var">func</span><span class="jsdoc-syntax">]();
 153 };
 154
 155
 156 </span><span class="jsdoc-comment">/**
 157  * Formats a date given the supplied format string
 158  * @param {String} format The format string
 159  * @return {String} The formatted date
 160  * @method
 161  */
 162 </span><span class="jsdoc-var">Date.prototype.format </span><span class="jsdoc-syntax">= </span><span class="jsdoc-var">Date.prototype.dateFormat</span><span class="jsdoc-syntax">;
 163
 164 </span><span class="jsdoc-comment">// private
 165 </span><span class="jsdoc-var">Date.createNewFormat </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">format</span><span class="jsdoc-syntax">) {
 166     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">funcName </span><span class="jsdoc-syntax">= </span><span class="jsdoc-string">&quot;format&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">Date.formatFunctions.count</span><span class="jsdoc-syntax">++;
 167     </span><span class="jsdoc-var">Date.formatFunctions</span><span class="jsdoc-syntax">[</span><span class="jsdoc-var">format</span><span class="jsdoc-syntax">] = </span><span class="jsdoc-var">funcName</span><span class="jsdoc-syntax">;
 168     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">code </span><span class="jsdoc-syntax">= </span><span class="jsdoc-string">&quot;Date.prototype.&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">funcName </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot; = function(){return &quot;</span><span class="jsdoc-syntax">;
 169     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">special </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">false</span><span class="jsdoc-syntax">;
 170     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">ch </span><span class="jsdoc-syntax">= </span><span class="jsdoc-string">''</span><span class="jsdoc-syntax">;
 171     </span><span class="jsdoc-keyword">for </span><span class="jsdoc-syntax">(</span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">i </span><span class="jsdoc-syntax">= 0; </span><span class="jsdoc-var">i </span><span class="jsdoc-syntax">&lt; </span><span class="jsdoc-var">format.length</span><span class="jsdoc-syntax">; ++</span><span class="jsdoc-var">i</span><span class="jsdoc-syntax">) {
 172         </span><span class="jsdoc-var">ch </span><span class="jsdoc-syntax">= </span><span class="jsdoc-var">format.charAt</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">i</span><span class="jsdoc-syntax">);
 173         </span><span class="jsdoc-keyword">if </span><span class="jsdoc-syntax">(!</span><span class="jsdoc-var">special </span><span class="jsdoc-syntax">&amp;&amp; </span><span class="jsdoc-var">ch </span><span class="jsdoc-syntax">== </span><span class="jsdoc-string">&quot;\\&quot;</span><span class="jsdoc-syntax">) {
 174             </span><span class="jsdoc-var">special </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">true</span><span class="jsdoc-syntax">;
 175         }
 176         </span><span class="jsdoc-keyword">else if </span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">special</span><span class="jsdoc-syntax">) {
 177             </span><span class="jsdoc-var">special </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">false</span><span class="jsdoc-syntax">;
 178             </span><span class="jsdoc-var">code </span><span class="jsdoc-syntax">+= </span><span class="jsdoc-string">&quot;'&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">String.escape</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">ch</span><span class="jsdoc-syntax">) + </span><span class="jsdoc-string">&quot;' + &quot;</span><span class="jsdoc-syntax">;
 179         }
 180         </span><span class="jsdoc-keyword">else </span><span class="jsdoc-syntax">{
 181             </span><span class="jsdoc-var">code </span><span class="jsdoc-syntax">+= </span><span class="jsdoc-var">Date.getFormatCode</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">ch</span><span class="jsdoc-syntax">);
 182         }
 183     }
 184     </span><span class="jsdoc-comment">/** eval:var:zzzzzzzzzzzzz */
 185     </span><span class="jsdoc-keyword">eval</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">code.substring</span><span class="jsdoc-syntax">(0, </span><span class="jsdoc-var">code.length </span><span class="jsdoc-syntax">- 3) + </span><span class="jsdoc-string">&quot;;}&quot;</span><span class="jsdoc-syntax">);
 186 };
 187
 188 </span><span class="jsdoc-comment">// private
 189 </span><span class="jsdoc-var">Date.getFormatCode </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">character</span><span class="jsdoc-syntax">) {
 190     </span><span class="jsdoc-keyword">switch </span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">character</span><span class="jsdoc-syntax">) {
 191     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;d&quot;</span><span class="jsdoc-syntax">:
 192         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;String.leftPad(this.getDate(), 2, '0') + &quot;</span><span class="jsdoc-syntax">;
 193     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;D&quot;</span><span class="jsdoc-syntax">:
 194         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;Date.dayNames[this.getDay()].substring(0, 3) + &quot;</span><span class="jsdoc-syntax">;
 195     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;j&quot;</span><span class="jsdoc-syntax">:
 196         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;this.getDate() + &quot;</span><span class="jsdoc-syntax">;
 197     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;l&quot;</span><span class="jsdoc-syntax">:
 198         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;Date.dayNames[this.getDay()] + &quot;</span><span class="jsdoc-syntax">;
 199     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;S&quot;</span><span class="jsdoc-syntax">:
 200         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;this.getSuffix() + &quot;</span><span class="jsdoc-syntax">;
 201     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;w&quot;</span><span class="jsdoc-syntax">:
 202         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;this.getDay() + &quot;</span><span class="jsdoc-syntax">;
 203     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;z&quot;</span><span class="jsdoc-syntax">:
 204         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;this.getDayOfYear() + &quot;</span><span class="jsdoc-syntax">;
 205     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;W&quot;</span><span class="jsdoc-syntax">:
 206         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;this.getWeekOfYear() + &quot;</span><span class="jsdoc-syntax">;
 207     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;F&quot;</span><span class="jsdoc-syntax">:
 208         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;Date.monthNames[this.getMonth()] + &quot;</span><span class="jsdoc-syntax">;
 209     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;m&quot;</span><span class="jsdoc-syntax">:
 210         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;String.leftPad(this.getMonth() + 1, 2, '0') + &quot;</span><span class="jsdoc-syntax">;
 211     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;M&quot;</span><span class="jsdoc-syntax">:
 212         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;Date.monthNames[this.getMonth()].substring(0, 3) + &quot;</span><span class="jsdoc-syntax">;
 213     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;n&quot;</span><span class="jsdoc-syntax">:
 214         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;(this.getMonth() + 1) + &quot;</span><span class="jsdoc-syntax">;
 215     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;t&quot;</span><span class="jsdoc-syntax">:
 216         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;this.getDaysInMonth() + &quot;</span><span class="jsdoc-syntax">;
 217     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;L&quot;</span><span class="jsdoc-syntax">:
 218         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;(this.isLeapYear() ? 1 : 0) + &quot;</span><span class="jsdoc-syntax">;
 219     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;Y&quot;</span><span class="jsdoc-syntax">:
 220         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;this.getFullYear() + &quot;</span><span class="jsdoc-syntax">;
 221     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;y&quot;</span><span class="jsdoc-syntax">:
 222         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;('' + this.getFullYear()).substring(2, 4) + &quot;</span><span class="jsdoc-syntax">;
 223     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;a&quot;</span><span class="jsdoc-syntax">:
 224         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;(this.getHours() &lt; 12 ? 'am' : 'pm') + &quot;</span><span class="jsdoc-syntax">;
 225     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;A&quot;</span><span class="jsdoc-syntax">:
 226         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;(this.getHours() &lt; 12 ? 'AM' : 'PM') + &quot;</span><span class="jsdoc-syntax">;
 227     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;g&quot;</span><span class="jsdoc-syntax">:
 228         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;((this.getHours() % 12) ? this.getHours() % 12 : 12) + &quot;</span><span class="jsdoc-syntax">;
 229     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;G&quot;</span><span class="jsdoc-syntax">:
 230         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;this.getHours() + &quot;</span><span class="jsdoc-syntax">;
 231     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;h&quot;</span><span class="jsdoc-syntax">:
 232         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;String.leftPad((this.getHours() % 12) ? this.getHours() % 12 : 12, 2, '0') + &quot;</span><span class="jsdoc-syntax">;
 233     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;H&quot;</span><span class="jsdoc-syntax">:
 234         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;String.leftPad(this.getHours(), 2, '0') + &quot;</span><span class="jsdoc-syntax">;
 235     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;i&quot;</span><span class="jsdoc-syntax">:
 236         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;String.leftPad(this.getMinutes(), 2, '0') + &quot;</span><span class="jsdoc-syntax">;
 237     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;s&quot;</span><span class="jsdoc-syntax">:
 238         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;String.leftPad(this.getSeconds(), 2, '0') + &quot;</span><span class="jsdoc-syntax">;
 239     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;O&quot;</span><span class="jsdoc-syntax">:
 240         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;this.getGMTOffset() + &quot;</span><span class="jsdoc-syntax">;
 241     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;P&quot;</span><span class="jsdoc-syntax">:
 242         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;this.getGMTColonOffset() + &quot;</span><span class="jsdoc-syntax">;
 243     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;T&quot;</span><span class="jsdoc-syntax">:
 244         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;this.getTimezone() + &quot;</span><span class="jsdoc-syntax">;
 245     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;Z&quot;</span><span class="jsdoc-syntax">:
 246         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;(this.getTimezoneOffset() * -60) + &quot;</span><span class="jsdoc-syntax">;
 247     </span><span class="jsdoc-keyword">default</span><span class="jsdoc-syntax">:
 248         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;'&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">String.escape</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">character</span><span class="jsdoc-syntax">) + </span><span class="jsdoc-string">&quot;' + &quot;</span><span class="jsdoc-syntax">;
 249     }
 250 };
 251
 252 </span><span class="jsdoc-comment">/**
 253  * Parses the passed string using the specified format. Note that this function expects dates in normal calendar
 254  * format, meaning that months are 1-based (1 = January) and not zero-based like in JavaScript dates.  Any part of
 255  * the date format that is not specified will default to the current date value for that part.  Time parts can also
 256  * be specified, but default to 0.  Keep in mind that the input date string must precisely match the specified format
 257  * string or the parse operation will fail.
 258  * Example Usage:
 259 &lt;pre&gt;&lt;code&gt;
 260 //dt = Fri May 25 2007 (current date)
 261 var dt = new Date();
 262
 263 //dt = Thu May 25 2006 (today's month/day in 2006)
 264 dt = Date.parseDate(&quot;2006&quot;, &quot;Y&quot;);
 265
 266 //dt = Sun Jan 15 2006 (all date parts specified)
 267 dt = Date.parseDate(&quot;2006-1-15&quot;, &quot;Y-m-d&quot;);
 268
 269 //dt = Sun Jan 15 2006 15:20:01 GMT-0600 (CST)
 270 dt = Date.parseDate(&quot;2006-1-15 3:20:01 PM&quot;, &quot;Y-m-d h:i:s A&quot; );
 271 &lt;/code&gt;&lt;/pre&gt;
 272  * @param {String} input The unparsed date as a string
 273  * @param {String} format The format the date is in
 274  * @return {Date} The parsed date
 275  * @static
 276  */
 277 </span><span class="jsdoc-var">Date.parseDate </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">input</span><span class="jsdoc-syntax">, </span><span class="jsdoc-var">format</span><span class="jsdoc-syntax">) {
 278     </span><span class="jsdoc-keyword">if </span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">Date.parseFunctions</span><span class="jsdoc-syntax">[</span><span class="jsdoc-var">format</span><span class="jsdoc-syntax">] == </span><span class="jsdoc-keyword">null</span><span class="jsdoc-syntax">) {
 279         </span><span class="jsdoc-var">Date.createParser</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">format</span><span class="jsdoc-syntax">);
 280     }
 281     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">func </span><span class="jsdoc-syntax">= </span><span class="jsdoc-var">Date.parseFunctions</span><span class="jsdoc-syntax">[</span><span class="jsdoc-var">format</span><span class="jsdoc-syntax">];
 282     </span><span class="jsdoc-keyword">return </span><span class="jsdoc-var">Date</span><span class="jsdoc-syntax">[</span><span class="jsdoc-var">func</span><span class="jsdoc-syntax">](</span><span class="jsdoc-var">input</span><span class="jsdoc-syntax">);
 283 };
 284 </span><span class="jsdoc-comment">/**
 285  * @private
 286  */
 287
 288 </span><span class="jsdoc-var">Date.createParser </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">format</span><span class="jsdoc-syntax">) {
 289     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">funcName </span><span class="jsdoc-syntax">= </span><span class="jsdoc-string">&quot;parse&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">Date.parseFunctions.count</span><span class="jsdoc-syntax">++;
 290     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">regexNum </span><span class="jsdoc-syntax">= </span><span class="jsdoc-var">Date.parseRegexes.length</span><span class="jsdoc-syntax">;
 291     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">currentGroup </span><span class="jsdoc-syntax">= 1;
 292     </span><span class="jsdoc-var">Date.parseFunctions</span><span class="jsdoc-syntax">[</span><span class="jsdoc-var">format</span><span class="jsdoc-syntax">] = </span><span class="jsdoc-var">funcName</span><span class="jsdoc-syntax">;
 293
 294     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">code </span><span class="jsdoc-syntax">= </span><span class="jsdoc-string">&quot;Date.&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">funcName </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot; = function(input){\n&quot;
 295         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;var y = -1, m = -1, d = -1, h = -1, i = -1, s = -1, o, z, v;\n&quot;
 296         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;var d = new Date();\n&quot;
 297         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;y = d.getFullYear();\n&quot;
 298         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;m = d.getMonth();\n&quot;
 299         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;d = d.getDate();\n&quot;
 300         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;if (typeof(input) !== 'string') { input = input.toString(); }\n&quot;
 301         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;var results = input.match(Date.parseRegexes[&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">regexNum </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;]);\n&quot;
 302         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;if (results &amp;&amp; results.length &gt; 0) {&quot;</span><span class="jsdoc-syntax">;
 303     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">regex </span><span class="jsdoc-syntax">= </span><span class="jsdoc-string">&quot;&quot;</span><span class="jsdoc-syntax">;
 304
 305     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">special </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">false</span><span class="jsdoc-syntax">;
 306     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">ch </span><span class="jsdoc-syntax">= </span><span class="jsdoc-string">''</span><span class="jsdoc-syntax">;
 307     </span><span class="jsdoc-keyword">for </span><span class="jsdoc-syntax">(</span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">i </span><span class="jsdoc-syntax">= 0; </span><span class="jsdoc-var">i </span><span class="jsdoc-syntax">&lt; </span><span class="jsdoc-var">format.length</span><span class="jsdoc-syntax">; ++</span><span class="jsdoc-var">i</span><span class="jsdoc-syntax">) {
 308         </span><span class="jsdoc-var">ch </span><span class="jsdoc-syntax">= </span><span class="jsdoc-var">format.charAt</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">i</span><span class="jsdoc-syntax">);
 309         </span><span class="jsdoc-keyword">if </span><span class="jsdoc-syntax">(!</span><span class="jsdoc-var">special </span><span class="jsdoc-syntax">&amp;&amp; </span><span class="jsdoc-var">ch </span><span class="jsdoc-syntax">== </span><span class="jsdoc-string">&quot;\\&quot;</span><span class="jsdoc-syntax">) {
 310             </span><span class="jsdoc-var">special </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">true</span><span class="jsdoc-syntax">;
 311         }
 312         </span><span class="jsdoc-keyword">else if </span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">special</span><span class="jsdoc-syntax">) {
 313             </span><span class="jsdoc-var">special </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">false</span><span class="jsdoc-syntax">;
 314             </span><span class="jsdoc-var">regex </span><span class="jsdoc-syntax">+= </span><span class="jsdoc-var">String.escape</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">ch</span><span class="jsdoc-syntax">);
 315         }
 316         </span><span class="jsdoc-keyword">else </span><span class="jsdoc-syntax">{
 317             </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">obj </span><span class="jsdoc-syntax">= </span><span class="jsdoc-var">Date.formatCodeToRegex</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">ch</span><span class="jsdoc-syntax">, </span><span class="jsdoc-var">currentGroup</span><span class="jsdoc-syntax">);
 318             </span><span class="jsdoc-var">currentGroup </span><span class="jsdoc-syntax">+= </span><span class="jsdoc-var">obj.g</span><span class="jsdoc-syntax">;
 319             </span><span class="jsdoc-var">regex </span><span class="jsdoc-syntax">+= </span><span class="jsdoc-var">obj.s</span><span class="jsdoc-syntax">;
 320             </span><span class="jsdoc-keyword">if </span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">obj.g </span><span class="jsdoc-syntax">&amp;&amp; </span><span class="jsdoc-var">obj.c</span><span class="jsdoc-syntax">) {
 321                 </span><span class="jsdoc-var">code </span><span class="jsdoc-syntax">+= </span><span class="jsdoc-var">obj.c</span><span class="jsdoc-syntax">;
 322             }
 323         }
 324     }
 325
 326     </span><span class="jsdoc-var">code </span><span class="jsdoc-syntax">+= </span><span class="jsdoc-string">&quot;if (y &gt;= 0 &amp;&amp; m &gt;= 0 &amp;&amp; d &gt; 0 &amp;&amp; h &gt;= 0 &amp;&amp; i &gt;= 0 &amp;&amp; s &gt;= 0)\n&quot;
 327         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;{v = new Date(y, m, d, h, i, s); v.setFullYear(y);}\n&quot;
 328         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;else if (y &gt;= 0 &amp;&amp; m &gt;= 0 &amp;&amp; d &gt; 0 &amp;&amp; h &gt;= 0 &amp;&amp; i &gt;= 0)\n&quot;
 329         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;{v = new Date(y, m, d, h, i); v.setFullYear(y);}\n&quot;
 330         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;else if (y &gt;= 0 &amp;&amp; m &gt;= 0 &amp;&amp; d &gt; 0 &amp;&amp; h &gt;= 0)\n&quot;
 331         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;{v = new Date(y, m, d, h); v.setFullYear(y);}\n&quot;
 332         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;else if (y &gt;= 0 &amp;&amp; m &gt;= 0 &amp;&amp; d &gt; 0)\n&quot;
 333         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;{v = new Date(y, m, d); v.setFullYear(y);}\n&quot;
 334         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;else if (y &gt;= 0 &amp;&amp; m &gt;= 0)\n&quot;
 335         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;{v = new Date(y, m); v.setFullYear(y);}\n&quot;
 336         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;else if (y &gt;= 0)\n&quot;
 337         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;{v = new Date(y); v.setFullYear(y);}\n&quot;
 338         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;}return (v &amp;&amp; (z || o))?\n&quot; </span><span class="jsdoc-comment">// favour UTC offset over GMT offset
 339         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;    ((z)? v.add(Date.SECOND, (v.getTimezoneOffset() * 60) + (z*1)) :\n&quot; </span><span class="jsdoc-comment">// reset to UTC, then add offset
 340         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;        v.add(Date.HOUR, (v.getGMTOffset() / 100) + (o / -100))) : v\n&quot; </span><span class="jsdoc-comment">// reset to GMT, then add offset
 341         </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;;}&quot;</span><span class="jsdoc-syntax">;
 342
 343     </span><span class="jsdoc-var">Date.parseRegexes</span><span class="jsdoc-syntax">[</span><span class="jsdoc-var">regexNum</span><span class="jsdoc-syntax">] = </span><span class="jsdoc-keyword">new </span><span class="jsdoc-var">RegExp</span><span class="jsdoc-syntax">(</span><span class="jsdoc-string">&quot;^&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">regex </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;$&quot;</span><span class="jsdoc-syntax">);
 344     </span><span class="jsdoc-comment">/** eval:var:zzzzzzzzzzzzz */
 345     </span><span class="jsdoc-keyword">eval</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">code</span><span class="jsdoc-syntax">);
 346 };
 347
 348 </span><span class="jsdoc-comment">// private
 349 </span><span class="jsdoc-var">Date.formatCodeToRegex </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">character</span><span class="jsdoc-syntax">, </span><span class="jsdoc-var">currentGroup</span><span class="jsdoc-syntax">) {
 350     </span><span class="jsdoc-keyword">switch </span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">character</span><span class="jsdoc-syntax">) {
 351     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;D&quot;</span><span class="jsdoc-syntax">:
 352         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:0,
 353         </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-keyword">null</span><span class="jsdoc-syntax">,
 354         </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(?:Sun|Mon|Tue|Wed|Thu|Fri|Sat)&quot;</span><span class="jsdoc-syntax">};
 355     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;j&quot;</span><span class="jsdoc-syntax">:
 356         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:1,
 357             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;d = parseInt(results[&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">currentGroup </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;], 10);\n&quot;</span><span class="jsdoc-syntax">,
 358             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(\\d{1,2})&quot;</span><span class="jsdoc-syntax">}; </span><span class="jsdoc-comment">// day of month without leading zeroes
 359     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;d&quot;</span><span class="jsdoc-syntax">:
 360         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:1,
 361             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;d = parseInt(results[&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">currentGroup </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;], 10);\n&quot;</span><span class="jsdoc-syntax">,
 362             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(\\d{2})&quot;</span><span class="jsdoc-syntax">}; </span><span class="jsdoc-comment">// day of month with leading zeroes
 363     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;l&quot;</span><span class="jsdoc-syntax">:
 364         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:0,
 365             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-keyword">null</span><span class="jsdoc-syntax">,
 366             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(?:&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">Date.dayNames.join</span><span class="jsdoc-syntax">(</span><span class="jsdoc-string">&quot;|&quot;</span><span class="jsdoc-syntax">) + </span><span class="jsdoc-string">&quot;)&quot;</span><span class="jsdoc-syntax">};
 367     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;S&quot;</span><span class="jsdoc-syntax">:
 368         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:0,
 369             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-keyword">null</span><span class="jsdoc-syntax">,
 370             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(?:st|nd|rd|th)&quot;</span><span class="jsdoc-syntax">};
 371     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;w&quot;</span><span class="jsdoc-syntax">:
 372         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:0,
 373             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-keyword">null</span><span class="jsdoc-syntax">,
 374             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;\\d&quot;</span><span class="jsdoc-syntax">};
 375     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;z&quot;</span><span class="jsdoc-syntax">:
 376         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:0,
 377             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-keyword">null</span><span class="jsdoc-syntax">,
 378             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(?:\\d{1,3})&quot;</span><span class="jsdoc-syntax">};
 379     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;W&quot;</span><span class="jsdoc-syntax">:
 380         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:0,
 381             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-keyword">null</span><span class="jsdoc-syntax">,
 382             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(?:\\d{2})&quot;</span><span class="jsdoc-syntax">};
 383     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;F&quot;</span><span class="jsdoc-syntax">:
 384         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:1,
 385             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;m = parseInt(Date.monthNumbers[results[&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">currentGroup </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;].substring(0, 3)], 10);\n&quot;</span><span class="jsdoc-syntax">,
 386             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">Date.monthNames.join</span><span class="jsdoc-syntax">(</span><span class="jsdoc-string">&quot;|&quot;</span><span class="jsdoc-syntax">) + </span><span class="jsdoc-string">&quot;)&quot;</span><span class="jsdoc-syntax">};
 387     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;M&quot;</span><span class="jsdoc-syntax">:
 388         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:1,
 389             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;m = parseInt(Date.monthNumbers[results[&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">currentGroup </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;]], 10);\n&quot;</span><span class="jsdoc-syntax">,
 390             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)&quot;</span><span class="jsdoc-syntax">};
 391     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;n&quot;</span><span class="jsdoc-syntax">:
 392         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:1,
 393             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;m = parseInt(results[&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">currentGroup </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;], 10) - 1;\n&quot;</span><span class="jsdoc-syntax">,
 394             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(\\d{1,2})&quot;</span><span class="jsdoc-syntax">}; </span><span class="jsdoc-comment">// Numeric representation of a month, without leading zeros
 395     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;m&quot;</span><span class="jsdoc-syntax">:
 396         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:1,
 397             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;m = Math.max(0,parseInt(results[&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">currentGroup </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;], 10) - 1);\n&quot;</span><span class="jsdoc-syntax">,
 398             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(\\d{2})&quot;</span><span class="jsdoc-syntax">}; </span><span class="jsdoc-comment">// Numeric representation of a month, with leading zeros
 399     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;t&quot;</span><span class="jsdoc-syntax">:
 400         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:0,
 401             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-keyword">null</span><span class="jsdoc-syntax">,
 402             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;\\d{1,2}&quot;</span><span class="jsdoc-syntax">};
 403     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;L&quot;</span><span class="jsdoc-syntax">:
 404         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:0,
 405             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-keyword">null</span><span class="jsdoc-syntax">,
 406             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(?:1|0)&quot;</span><span class="jsdoc-syntax">};
 407     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;Y&quot;</span><span class="jsdoc-syntax">:
 408         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:1,
 409             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;y = parseInt(results[&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">currentGroup </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;], 10);\n&quot;</span><span class="jsdoc-syntax">,
 410             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(\\d{4})&quot;</span><span class="jsdoc-syntax">};
 411     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;y&quot;</span><span class="jsdoc-syntax">:
 412         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:1,
 413             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;var ty = parseInt(results[&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">currentGroup </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;], 10);\n&quot;
 414                 </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;y = ty &gt; Date.y2kYear ? 1900 + ty : 2000 + ty;\n&quot;</span><span class="jsdoc-syntax">,
 415             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(\\d{1,2})&quot;</span><span class="jsdoc-syntax">};
 416     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;a&quot;</span><span class="jsdoc-syntax">:
 417         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:1,
 418             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;if (results[&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">currentGroup </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;] == 'am') {\n&quot;
 419                 </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;if (h == 12) { h = 0; }\n&quot;
 420                 </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;} else { if (h &lt; 12) { h += 12; }}&quot;</span><span class="jsdoc-syntax">,
 421             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(am|pm)&quot;</span><span class="jsdoc-syntax">};
 422     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;A&quot;</span><span class="jsdoc-syntax">:
 423         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:1,
 424             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;if (results[&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">currentGroup </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;] == 'AM') {\n&quot;
 425                 </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;if (h == 12) { h = 0; }\n&quot;
 426                 </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;} else { if (h &lt; 12) { h += 12; }}&quot;</span><span class="jsdoc-syntax">,
 427             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(AM|PM)&quot;</span><span class="jsdoc-syntax">};
 428     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;g&quot;</span><span class="jsdoc-syntax">:
 429     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;G&quot;</span><span class="jsdoc-syntax">:
 430         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:1,
 431             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;h = parseInt(results[&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">currentGroup </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;], 10);\n&quot;</span><span class="jsdoc-syntax">,
 432             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(\\d{1,2})&quot;</span><span class="jsdoc-syntax">}; </span><span class="jsdoc-comment">// 12/24-hr format  format of an hour without leading zeroes
 433     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;h&quot;</span><span class="jsdoc-syntax">:
 434     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;H&quot;</span><span class="jsdoc-syntax">:
 435         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:1,
 436             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;h = parseInt(results[&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">currentGroup </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;], 10);\n&quot;</span><span class="jsdoc-syntax">,
 437             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(\\d{2})&quot;</span><span class="jsdoc-syntax">}; </span><span class="jsdoc-comment">//  12/24-hr format  format of an hour with leading zeroes
 438     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;i&quot;</span><span class="jsdoc-syntax">:
 439         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:1,
 440             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;i = parseInt(results[&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">currentGroup </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;], 10);\n&quot;</span><span class="jsdoc-syntax">,
 441             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(\\d{2})&quot;</span><span class="jsdoc-syntax">};
 442     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;s&quot;</span><span class="jsdoc-syntax">:
 443         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:1,
 444             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;s = parseInt(results[&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">currentGroup </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;], 10);\n&quot;</span><span class="jsdoc-syntax">,
 445             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;(\\d{2})&quot;</span><span class="jsdoc-syntax">};
 446     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;O&quot;</span><span class="jsdoc-syntax">:
 447         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:1,
 448             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:[
 449                 </span><span class="jsdoc-string">&quot;o = results[&quot;</span><span class="jsdoc-syntax">, </span><span class="jsdoc-var">currentGroup</span><span class="jsdoc-syntax">, </span><span class="jsdoc-string">&quot;];\n&quot;</span><span class="jsdoc-syntax">,
 450                 </span><span class="jsdoc-string">&quot;var sn = o.substring(0,1);\n&quot;</span><span class="jsdoc-syntax">, </span><span class="jsdoc-comment">// get + / - sign
 451                 </span><span class="jsdoc-string">&quot;var hr = o.substring(1,3)*1 + Math.floor(o.substring(3,5) / 60);\n&quot;</span><span class="jsdoc-syntax">, </span><span class="jsdoc-comment">// get hours (performs minutes-to-hour conversion also)
 452                 </span><span class="jsdoc-string">&quot;var mn = o.substring(3,5) % 60;\n&quot;</span><span class="jsdoc-syntax">, </span><span class="jsdoc-comment">// get minutes
 453                 </span><span class="jsdoc-string">&quot;o = ((-12 &lt;= (hr*60 + mn)/60) &amp;&amp; ((hr*60 + mn)/60 &lt;= 14))?\n&quot;</span><span class="jsdoc-syntax">, </span><span class="jsdoc-comment">// -12hrs &lt;= GMT offset &lt;= 14hrs
 454                 </span><span class="jsdoc-string">&quot;    (sn + String.leftPad(hr, 2, 0) + String.leftPad(mn, 2, 0)) : null;\n&quot;
 455             </span><span class="jsdoc-syntax">]</span><span class="jsdoc-var">.join</span><span class="jsdoc-syntax">(</span><span class="jsdoc-string">&quot;&quot;</span><span class="jsdoc-syntax">),
 456             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;([+\-]\\d{2,4})&quot;</span><span class="jsdoc-syntax">};
 457
 458
 459     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;P&quot;</span><span class="jsdoc-syntax">:
 460         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:1,
 461                 </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:[
 462                    </span><span class="jsdoc-string">&quot;o = results[&quot;</span><span class="jsdoc-syntax">, </span><span class="jsdoc-var">currentGroup</span><span class="jsdoc-syntax">, </span><span class="jsdoc-string">&quot;];\n&quot;</span><span class="jsdoc-syntax">,
 463                    </span><span class="jsdoc-string">&quot;var sn = o.substring(0,1);\n&quot;</span><span class="jsdoc-syntax">,
 464                    </span><span class="jsdoc-string">&quot;var hr = o.substring(1,3)*1 + Math.floor(o.substring(4,6) / 60);\n&quot;</span><span class="jsdoc-syntax">,
 465                    </span><span class="jsdoc-string">&quot;var mn = o.substring(4,6) % 60;\n&quot;</span><span class="jsdoc-syntax">,
 466                    </span><span class="jsdoc-string">&quot;o = ((-12 &lt;= (hr*60 + mn)/60) &amp;&amp; ((hr*60 + mn)/60 &lt;= 14))?\n&quot;</span><span class="jsdoc-syntax">,
 467                         </span><span class="jsdoc-string">&quot;    (sn + String.leftPad(hr, 2, 0) + String.leftPad(mn, 2, 0)) : null;\n&quot;
 468             </span><span class="jsdoc-syntax">]</span><span class="jsdoc-var">.join</span><span class="jsdoc-syntax">(</span><span class="jsdoc-string">&quot;&quot;</span><span class="jsdoc-syntax">),
 469             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;([+\-]\\d{4})&quot;</span><span class="jsdoc-syntax">};
 470     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;T&quot;</span><span class="jsdoc-syntax">:
 471         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:0,
 472             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-keyword">null</span><span class="jsdoc-syntax">,
 473             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;[A-Z]{1,4}&quot;</span><span class="jsdoc-syntax">}; </span><span class="jsdoc-comment">// timezone abbrev. may be between 1 - 4 chars
 474     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-string">&quot;Z&quot;</span><span class="jsdoc-syntax">:
 475         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:1,
 476             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;z = results[&quot; </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">currentGroup </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;];\n&quot; </span><span class="jsdoc-comment">// -43200 &lt;= UTC offset &lt;= 50400
 477                   </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-string">&quot;z = (-43200 &lt;= z*1 &amp;&amp; z*1 &lt;= 50400)? z : null;\n&quot;</span><span class="jsdoc-syntax">,
 478             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-string">&quot;([+\-]?\\d{1,5})&quot;</span><span class="jsdoc-syntax">}; </span><span class="jsdoc-comment">// leading '+' sign is optional for UTC offset
 479     </span><span class="jsdoc-keyword">default</span><span class="jsdoc-syntax">:
 480         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">{</span><span class="jsdoc-var">g</span><span class="jsdoc-syntax">:0,
 481             </span><span class="jsdoc-var">c</span><span class="jsdoc-syntax">:</span><span class="jsdoc-keyword">null</span><span class="jsdoc-syntax">,
 482             </span><span class="jsdoc-var">s</span><span class="jsdoc-syntax">:</span><span class="jsdoc-var">String.escape</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">character</span><span class="jsdoc-syntax">)};
 483     }
 484 };
 485
 486 </span><span class="jsdoc-comment">/**
 487  * Get the timezone abbreviation of the current date (equivalent to the format specifier 'T').
 488  * @return {String} The abbreviated timezone name (e.g. 'CST')
 489  */
 490 </span><span class="jsdoc-var">Date.prototype.getTimezone </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">() {
 491     </span><span class="jsdoc-keyword">return </span><span class="jsdoc-var">this.toString</span><span class="jsdoc-syntax">()</span><span class="jsdoc-var">.replace</span><span class="jsdoc-syntax">(/^.*? ([A-Z]{1,4})[\-+][0-9]{4} .*$/, </span><span class="jsdoc-string">&quot;$1&quot;</span><span class="jsdoc-syntax">);
 492 };
 493
 494 </span><span class="jsdoc-comment">/**
 495  * Get the offset from GMT of the current date (equivalent to the format specifier 'O').
 496  * @return {String} The 4-character offset string prefixed with + or - (e.g. '-0600')
 497  */
 498 </span><span class="jsdoc-var">Date.prototype.getGMTOffset </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">() {
 499     </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getTimezoneOffset</span><span class="jsdoc-syntax">() &gt; 0 ? </span><span class="jsdoc-string">&quot;-&quot; </span><span class="jsdoc-syntax">: </span><span class="jsdoc-string">&quot;+&quot;</span><span class="jsdoc-syntax">)
 500         + </span><span class="jsdoc-var">String.leftPad</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">Math.abs</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">Math.floor</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getTimezoneOffset</span><span class="jsdoc-syntax">() / 60)), 2, </span><span class="jsdoc-string">&quot;0&quot;</span><span class="jsdoc-syntax">)
 501         + </span><span class="jsdoc-var">String.leftPad</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getTimezoneOffset</span><span class="jsdoc-syntax">() % 60, 2, </span><span class="jsdoc-string">&quot;0&quot;</span><span class="jsdoc-syntax">);
 502 };
 503
 504 </span><span class="jsdoc-comment">/**
 505  * Get the offset from GMT of the current date (equivalent to the format specifier 'P').
 506  * @return {String} 2-characters representing hours and 2-characters representing minutes
 507  * seperated by a colon and prefixed with + or - (e.g. '-06:00')
 508  */
 509 </span><span class="jsdoc-var">Date.prototype.getGMTColonOffset </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">() {
 510         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getTimezoneOffset</span><span class="jsdoc-syntax">() &gt; 0 ? </span><span class="jsdoc-string">&quot;-&quot; </span><span class="jsdoc-syntax">: </span><span class="jsdoc-string">&quot;+&quot;</span><span class="jsdoc-syntax">)
 511                 + </span><span class="jsdoc-var">String.leftPad</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">Math.abs</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">Math.floor</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getTimezoneOffset</span><span class="jsdoc-syntax">() / 60)), 2, </span><span class="jsdoc-string">&quot;0&quot;</span><span class="jsdoc-syntax">)
 512                 + </span><span class="jsdoc-string">&quot;:&quot;
 513                 </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">String.leftPad</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getTimezoneOffset</span><span class="jsdoc-syntax">() %60, 2, </span><span class="jsdoc-string">&quot;0&quot;</span><span class="jsdoc-syntax">);
 514 }
 515
 516 </span><span class="jsdoc-comment">/**
 517  * Get the numeric day number of the year, adjusted for leap year.
 518  * @return {Number} 0 through 364 (365 in leap years)
 519  */
 520 </span><span class="jsdoc-var">Date.prototype.getDayOfYear </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">() {
 521     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">num </span><span class="jsdoc-syntax">= 0;
 522     </span><span class="jsdoc-var">Date.daysInMonth</span><span class="jsdoc-syntax">[1] = </span><span class="jsdoc-var">this.isLeapYear</span><span class="jsdoc-syntax">() ? 29 : 28;
 523     </span><span class="jsdoc-keyword">for </span><span class="jsdoc-syntax">(</span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">i </span><span class="jsdoc-syntax">= 0; </span><span class="jsdoc-var">i </span><span class="jsdoc-syntax">&lt; </span><span class="jsdoc-var">this.getMonth</span><span class="jsdoc-syntax">(); ++</span><span class="jsdoc-var">i</span><span class="jsdoc-syntax">) {
 524         </span><span class="jsdoc-var">num </span><span class="jsdoc-syntax">+= </span><span class="jsdoc-var">Date.daysInMonth</span><span class="jsdoc-syntax">[</span><span class="jsdoc-var">i</span><span class="jsdoc-syntax">];
 525     }
 526     </span><span class="jsdoc-keyword">return </span><span class="jsdoc-var">num </span><span class="jsdoc-syntax">+ </span><span class="jsdoc-var">this.getDate</span><span class="jsdoc-syntax">() - 1;
 527 };
 528
 529 </span><span class="jsdoc-comment">/**
 530  * Get the string representation of the numeric week number of the year
 531  * (equivalent to the format specifier 'W').
 532  * @return {String} '00' through '52'
 533  */
 534 </span><span class="jsdoc-var">Date.prototype.getWeekOfYear </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">() {
 535     </span><span class="jsdoc-comment">// Skip to Thursday of this week
 536     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">now </span><span class="jsdoc-syntax">= </span><span class="jsdoc-var">this.getDayOfYear</span><span class="jsdoc-syntax">() + (4 - </span><span class="jsdoc-var">this.getDay</span><span class="jsdoc-syntax">());
 537     </span><span class="jsdoc-comment">// Find the first Thursday of the year
 538     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">jan1 </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">new </span><span class="jsdoc-var">Date</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getFullYear</span><span class="jsdoc-syntax">(), 0, 1);
 539     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">then </span><span class="jsdoc-syntax">= (7 - </span><span class="jsdoc-var">jan1.getDay</span><span class="jsdoc-syntax">() + 4);
 540     </span><span class="jsdoc-keyword">return </span><span class="jsdoc-var">String.leftPad</span><span class="jsdoc-syntax">(((</span><span class="jsdoc-var">now </span><span class="jsdoc-syntax">- </span><span class="jsdoc-var">then</span><span class="jsdoc-syntax">) / 7) + 1, 2, </span><span class="jsdoc-string">&quot;0&quot;</span><span class="jsdoc-syntax">);
 541 };
 542
 543 </span><span class="jsdoc-comment">/**
 544  * Whether or not the current date is in a leap year.
 545  * @return {Boolean} True if the current date is in a leap year, else false
 546  */
 547 </span><span class="jsdoc-var">Date.prototype.isLeapYear </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">() {
 548     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">year </span><span class="jsdoc-syntax">= </span><span class="jsdoc-var">this.getFullYear</span><span class="jsdoc-syntax">();
 549     </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">((</span><span class="jsdoc-var">year </span><span class="jsdoc-syntax">&amp; 3) == 0 &amp;&amp; (</span><span class="jsdoc-var">year </span><span class="jsdoc-syntax">% 100 || (</span><span class="jsdoc-var">year </span><span class="jsdoc-syntax">% 400 == 0 &amp;&amp; </span><span class="jsdoc-var">year</span><span class="jsdoc-syntax">)));
 550 };
 551
 552 </span><span class="jsdoc-comment">/**
 553  * Get the first day of the current month, adjusted for leap year.  The returned value
 554  * is the numeric day index within the week (0-6) which can be used in conjunction with
 555  * the {@link #monthNames} array to retrieve the textual day name.
 556  * Example:
 557  *&lt;pre&gt;&lt;code&gt;
 558 var dt = new Date('1/10/2007');
 559 document.write(Date.dayNames[dt.getFirstDayOfMonth()]); //output: 'Monday'
 560 &lt;/code&gt;&lt;/pre&gt;
 561  * @return {Number} The day number (0-6)
 562  */
 563 </span><span class="jsdoc-var">Date.prototype.getFirstDayOfMonth </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">() {
 564     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">day </span><span class="jsdoc-syntax">= (</span><span class="jsdoc-var">this.getDay</span><span class="jsdoc-syntax">() - (</span><span class="jsdoc-var">this.getDate</span><span class="jsdoc-syntax">() - 1)) % 7;
 565     </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">day </span><span class="jsdoc-syntax">&lt; 0) ? (</span><span class="jsdoc-var">day </span><span class="jsdoc-syntax">+ 7) : </span><span class="jsdoc-var">day</span><span class="jsdoc-syntax">;
 566 };
 567
 568 </span><span class="jsdoc-comment">/**
 569  * Get the last day of the current month, adjusted for leap year.  The returned value
 570  * is the numeric day index within the week (0-6) which can be used in conjunction with
 571  * the {@link #monthNames} array to retrieve the textual day name.
 572  * Example:
 573  *&lt;pre&gt;&lt;code&gt;
 574 var dt = new Date('1/10/2007');
 575 document.write(Date.dayNames[dt.getLastDayOfMonth()]); //output: 'Wednesday'
 576 &lt;/code&gt;&lt;/pre&gt;
 577  * @return {Number} The day number (0-6)
 578  */
 579 </span><span class="jsdoc-var">Date.prototype.getLastDayOfMonth </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">() {
 580     </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">day </span><span class="jsdoc-syntax">= (</span><span class="jsdoc-var">this.getDay</span><span class="jsdoc-syntax">() + (</span><span class="jsdoc-var">Date.daysInMonth</span><span class="jsdoc-syntax">[</span><span class="jsdoc-var">this.getMonth</span><span class="jsdoc-syntax">()] - </span><span class="jsdoc-var">this.getDate</span><span class="jsdoc-syntax">())) % 7;
 581     </span><span class="jsdoc-keyword">return </span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">day </span><span class="jsdoc-syntax">&lt; 0) ? (</span><span class="jsdoc-var">day </span><span class="jsdoc-syntax">+ 7) : </span><span class="jsdoc-var">day</span><span class="jsdoc-syntax">;
 582 };
 583
 584
 585 </span><span class="jsdoc-comment">/**
 586  * Get the first date of this date's month
 587  * @return {Date}
 588  */
 589 </span><span class="jsdoc-var">Date.prototype.getFirstDateOfMonth </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">() {
 590     </span><span class="jsdoc-keyword">return new </span><span class="jsdoc-var">Date</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getFullYear</span><span class="jsdoc-syntax">(), </span><span class="jsdoc-var">this.getMonth</span><span class="jsdoc-syntax">(), 1);
 591 };
 592
 593 </span><span class="jsdoc-comment">/**
 594  * Get the last date of this date's month
 595  * @return {Date}
 596  */
 597 </span><span class="jsdoc-var">Date.prototype.getLastDateOfMonth </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">() {
 598     </span><span class="jsdoc-keyword">return new </span><span class="jsdoc-var">Date</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getFullYear</span><span class="jsdoc-syntax">(), </span><span class="jsdoc-var">this.getMonth</span><span class="jsdoc-syntax">(), </span><span class="jsdoc-var">this.getDaysInMonth</span><span class="jsdoc-syntax">());
 599 };
 600 </span><span class="jsdoc-comment">/**
 601  * Get the number of days in the current month, adjusted for leap year.
 602  * @return {Number} The number of days in the month
 603  */
 604 </span><span class="jsdoc-var">Date.prototype.getDaysInMonth </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">() {
 605     </span><span class="jsdoc-var">Date.daysInMonth</span><span class="jsdoc-syntax">[1] = </span><span class="jsdoc-var">this.isLeapYear</span><span class="jsdoc-syntax">() ? 29 : 28;
 606     </span><span class="jsdoc-keyword">return </span><span class="jsdoc-var">Date.daysInMonth</span><span class="jsdoc-syntax">[</span><span class="jsdoc-var">this.getMonth</span><span class="jsdoc-syntax">()];
 607 };
 608
 609 </span><span class="jsdoc-comment">/**
 610  * Get the English ordinal suffix of the current day (equivalent to the format specifier 'S').
 611  * @return {String} 'st, 'nd', 'rd' or 'th'
 612  */
 613 </span><span class="jsdoc-var">Date.prototype.getSuffix </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">() {
 614     </span><span class="jsdoc-keyword">switch </span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getDate</span><span class="jsdoc-syntax">()) {
 615         </span><span class="jsdoc-keyword">case </span><span class="jsdoc-syntax">1:
 616         </span><span class="jsdoc-keyword">case </span><span class="jsdoc-syntax">21:
 617         </span><span class="jsdoc-keyword">case </span><span class="jsdoc-syntax">31:
 618             </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;st&quot;</span><span class="jsdoc-syntax">;
 619         </span><span class="jsdoc-keyword">case </span><span class="jsdoc-syntax">2:
 620         </span><span class="jsdoc-keyword">case </span><span class="jsdoc-syntax">22:
 621             </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;nd&quot;</span><span class="jsdoc-syntax">;
 622         </span><span class="jsdoc-keyword">case </span><span class="jsdoc-syntax">3:
 623         </span><span class="jsdoc-keyword">case </span><span class="jsdoc-syntax">23:
 624             </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;rd&quot;</span><span class="jsdoc-syntax">;
 625         </span><span class="jsdoc-keyword">default</span><span class="jsdoc-syntax">:
 626             </span><span class="jsdoc-keyword">return </span><span class="jsdoc-string">&quot;th&quot;</span><span class="jsdoc-syntax">;
 627     }
 628 };
 629
 630 </span><span class="jsdoc-comment">// private
 631 </span><span class="jsdoc-var">Date.daysInMonth </span><span class="jsdoc-syntax">= [31,28,31,30,31,30,31,31,30,31,30,31];
 632
 633 </span><span class="jsdoc-comment">/**
 634  * An array of textual month names.
 635  * Override these values for international dates, for example...
 636  * Date.monthNames = ['JanInYourLang', 'FebInYourLang', ...];
 637  * @type Array
 638  * @static
 639  */
 640 </span><span class="jsdoc-var">Date.monthNames </span><span class="jsdoc-syntax">=
 641    [</span><span class="jsdoc-string">&quot;January&quot;</span><span class="jsdoc-syntax">,
 642     </span><span class="jsdoc-string">&quot;February&quot;</span><span class="jsdoc-syntax">,
 643     </span><span class="jsdoc-string">&quot;March&quot;</span><span class="jsdoc-syntax">,
 644     </span><span class="jsdoc-string">&quot;April&quot;</span><span class="jsdoc-syntax">,
 645     </span><span class="jsdoc-string">&quot;May&quot;</span><span class="jsdoc-syntax">,
 646     </span><span class="jsdoc-string">&quot;June&quot;</span><span class="jsdoc-syntax">,
 647     </span><span class="jsdoc-string">&quot;July&quot;</span><span class="jsdoc-syntax">,
 648     </span><span class="jsdoc-string">&quot;August&quot;</span><span class="jsdoc-syntax">,
 649     </span><span class="jsdoc-string">&quot;September&quot;</span><span class="jsdoc-syntax">,
 650     </span><span class="jsdoc-string">&quot;October&quot;</span><span class="jsdoc-syntax">,
 651     </span><span class="jsdoc-string">&quot;November&quot;</span><span class="jsdoc-syntax">,
 652     </span><span class="jsdoc-string">&quot;December&quot;</span><span class="jsdoc-syntax">];
 653
 654 </span><span class="jsdoc-comment">/**
 655  * An array of textual day names.
 656  * Override these values for international dates, for example...
 657  * Date.dayNames = ['SundayInYourLang', 'MondayInYourLang', ...];
 658  * @type Array
 659  * @static
 660  */
 661 </span><span class="jsdoc-var">Date.dayNames </span><span class="jsdoc-syntax">=
 662    [</span><span class="jsdoc-string">&quot;Sunday&quot;</span><span class="jsdoc-syntax">,
 663     </span><span class="jsdoc-string">&quot;Monday&quot;</span><span class="jsdoc-syntax">,
 664     </span><span class="jsdoc-string">&quot;Tuesday&quot;</span><span class="jsdoc-syntax">,
 665     </span><span class="jsdoc-string">&quot;Wednesday&quot;</span><span class="jsdoc-syntax">,
 666     </span><span class="jsdoc-string">&quot;Thursday&quot;</span><span class="jsdoc-syntax">,
 667     </span><span class="jsdoc-string">&quot;Friday&quot;</span><span class="jsdoc-syntax">,
 668     </span><span class="jsdoc-string">&quot;Saturday&quot;</span><span class="jsdoc-syntax">];
 669
 670 </span><span class="jsdoc-comment">// private
 671 </span><span class="jsdoc-var">Date.y2kYear </span><span class="jsdoc-syntax">= 50;
 672 </span><span class="jsdoc-comment">// private
 673 </span><span class="jsdoc-var">Date.monthNumbers </span><span class="jsdoc-syntax">= {
 674     </span><span class="jsdoc-var">Jan</span><span class="jsdoc-syntax">:0,
 675     </span><span class="jsdoc-var">Feb</span><span class="jsdoc-syntax">:1,
 676     </span><span class="jsdoc-var">Mar</span><span class="jsdoc-syntax">:2,
 677     </span><span class="jsdoc-var">Apr</span><span class="jsdoc-syntax">:3,
 678     </span><span class="jsdoc-var">May</span><span class="jsdoc-syntax">:4,
 679     </span><span class="jsdoc-var">Jun</span><span class="jsdoc-syntax">:5,
 680     </span><span class="jsdoc-var">Jul</span><span class="jsdoc-syntax">:6,
 681     </span><span class="jsdoc-var">Aug</span><span class="jsdoc-syntax">:7,
 682     </span><span class="jsdoc-var">Sep</span><span class="jsdoc-syntax">:8,
 683     </span><span class="jsdoc-var">Oct</span><span class="jsdoc-syntax">:9,
 684     </span><span class="jsdoc-var">Nov</span><span class="jsdoc-syntax">:10,
 685     </span><span class="jsdoc-var">Dec</span><span class="jsdoc-syntax">:11};
 686
 687 </span><span class="jsdoc-comment">/**
 688  * Creates and returns a new Date instance with the exact same date value as the called instance.
 689  * Dates are copied and passed by reference, so if a copied date variable is modified later, the original
 690  * variable will also be changed.  When the intention is to create a new variable that will not
 691  * modify the original instance, you should create a clone.
 692  *
 693  * Example of correctly cloning a date:
 694  * &lt;pre&gt;&lt;code&gt;
 695 //wrong way:
 696 var orig = new Date('10/1/2006');
 697 var copy = orig;
 698 copy.setDate(5);
 699 document.write(orig);  //returns 'Thu Oct 05 2006'!
 700
 701 //correct way:
 702 var orig = new Date('10/1/2006');
 703 var copy = orig.clone();
 704 copy.setDate(5);
 705 document.write(orig);  //returns 'Thu Oct 01 2006'
 706 &lt;/code&gt;&lt;/pre&gt;
 707  * @return {Date} The new Date instance
 708  */
 709 </span><span class="jsdoc-var">Date.prototype.clone </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">() {
 710         </span><span class="jsdoc-keyword">return new </span><span class="jsdoc-var">Date</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getTime</span><span class="jsdoc-syntax">());
 711 };
 712
 713 </span><span class="jsdoc-comment">/**
 714  * Clears any time information from this date
 715  @param {Boolean} clone true to create a clone of this date, clear the time and return it
 716  @return {Date} this or the clone
 717  */
 718 </span><span class="jsdoc-var">Date.prototype.clearTime </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">clone</span><span class="jsdoc-syntax">){
 719     </span><span class="jsdoc-keyword">if</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">clone</span><span class="jsdoc-syntax">){
 720         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-var">this.clone</span><span class="jsdoc-syntax">()</span><span class="jsdoc-var">.clearTime</span><span class="jsdoc-syntax">();
 721     }
 722     </span><span class="jsdoc-var">this.setHours</span><span class="jsdoc-syntax">(0);
 723     </span><span class="jsdoc-var">this.setMinutes</span><span class="jsdoc-syntax">(0);
 724     </span><span class="jsdoc-var">this.setSeconds</span><span class="jsdoc-syntax">(0);
 725     </span><span class="jsdoc-var">this.setMilliseconds</span><span class="jsdoc-syntax">(0);
 726     </span><span class="jsdoc-keyword">return </span><span class="jsdoc-var">this</span><span class="jsdoc-syntax">;
 727 };
 728
 729 </span><span class="jsdoc-comment">// private
 730 // safari setMonth is broken -- check that this is only donw once...
 731 </span><span class="jsdoc-keyword">if</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">Roo.isSafari </span><span class="jsdoc-syntax">&amp;&amp; </span><span class="jsdoc-keyword">typeof</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">Date.brokenSetMonth</span><span class="jsdoc-syntax">) == </span><span class="jsdoc-string">'undefined'</span><span class="jsdoc-syntax">){
 732     </span><span class="jsdoc-var">Date.brokenSetMonth </span><span class="jsdoc-syntax">= </span><span class="jsdoc-var">Date.prototype.setMonth</span><span class="jsdoc-syntax">;
 733         </span><span class="jsdoc-var">Date.prototype.setMonth </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">num</span><span class="jsdoc-syntax">){
 734                 </span><span class="jsdoc-keyword">if</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">num </span><span class="jsdoc-syntax">&lt;= -1){
 735                         </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">n </span><span class="jsdoc-syntax">= </span><span class="jsdoc-var">Math.ceil</span><span class="jsdoc-syntax">(-</span><span class="jsdoc-var">num</span><span class="jsdoc-syntax">);
 736                         </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">back_year </span><span class="jsdoc-syntax">= </span><span class="jsdoc-var">Math.ceil</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">n</span><span class="jsdoc-syntax">/12);
 737                         </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">month </span><span class="jsdoc-syntax">= (</span><span class="jsdoc-var">n </span><span class="jsdoc-syntax">% 12) ? 12 - </span><span class="jsdoc-var">n </span><span class="jsdoc-syntax">% 12 : 0 ;
 738                         </span><span class="jsdoc-var">this.setFullYear</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getFullYear</span><span class="jsdoc-syntax">() - </span><span class="jsdoc-var">back_year</span><span class="jsdoc-syntax">);
 739                         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-var">Date.brokenSetMonth.call</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this</span><span class="jsdoc-syntax">, </span><span class="jsdoc-var">month</span><span class="jsdoc-syntax">);
 740                 } </span><span class="jsdoc-keyword">else </span><span class="jsdoc-syntax">{
 741                         </span><span class="jsdoc-keyword">return </span><span class="jsdoc-var">Date.brokenSetMonth.apply</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this</span><span class="jsdoc-syntax">, </span><span class="jsdoc-var">arguments</span><span class="jsdoc-syntax">);
 742                 }
 743         };
 744 }
 745
 746 </span><span class="jsdoc-comment">/** Date interval constant
 747 * @static
 748 * @type String */
 749 </span><span class="jsdoc-var">Date.MILLI </span><span class="jsdoc-syntax">= </span><span class="jsdoc-string">&quot;ms&quot;</span><span class="jsdoc-syntax">;
 750 </span><span class="jsdoc-comment">/** Date interval constant
 751 * @static
 752 * @type String */
 753 </span><span class="jsdoc-var">Date.SECOND </span><span class="jsdoc-syntax">= </span><span class="jsdoc-string">&quot;s&quot;</span><span class="jsdoc-syntax">;
 754 </span><span class="jsdoc-comment">/** Date interval constant
 755 * @static
 756 * @type String */
 757 </span><span class="jsdoc-var">Date.MINUTE </span><span class="jsdoc-syntax">= </span><span class="jsdoc-string">&quot;mi&quot;</span><span class="jsdoc-syntax">;
 758 </span><span class="jsdoc-comment">/** Date interval constant
 759 * @static
 760 * @type String */
 761 </span><span class="jsdoc-var">Date.HOUR </span><span class="jsdoc-syntax">= </span><span class="jsdoc-string">&quot;h&quot;</span><span class="jsdoc-syntax">;
 762 </span><span class="jsdoc-comment">/** Date interval constant
 763 * @static
 764 * @type String */
 765 </span><span class="jsdoc-var">Date.DAY </span><span class="jsdoc-syntax">= </span><span class="jsdoc-string">&quot;d&quot;</span><span class="jsdoc-syntax">;
 766 </span><span class="jsdoc-comment">/** Date interval constant
 767 * @static
 768 * @type String */
 769 </span><span class="jsdoc-var">Date.MONTH </span><span class="jsdoc-syntax">= </span><span class="jsdoc-string">&quot;mo&quot;</span><span class="jsdoc-syntax">;
 770 </span><span class="jsdoc-comment">/** Date interval constant
 771 * @static
 772 * @type String */
 773 </span><span class="jsdoc-var">Date.YEAR </span><span class="jsdoc-syntax">= </span><span class="jsdoc-string">&quot;y&quot;</span><span class="jsdoc-syntax">;
 774
 775 </span><span class="jsdoc-comment">/**
 776  * Provides a convenient method of performing basic date arithmetic.  This method
 777  * does not modify the Date instance being called - it creates and returns
 778  * a new Date instance containing the resulting date value.
 779  *
 780  * Examples:
 781  * &lt;pre&gt;&lt;code&gt;
 782 //Basic usage:
 783 var dt = new Date('10/29/2006').add(Date.DAY, 5);
 784 document.write(dt); //returns 'Fri Oct 06 2006 00:00:00'
 785
 786 //Negative values will subtract correctly:
 787 var dt2 = new Date('10/1/2006').add(Date.DAY, -5);
 788 document.write(dt2); //returns 'Tue Sep 26 2006 00:00:00'
 789
 790 //You can even chain several calls together in one line!
 791 var dt3 = new Date('10/1/2006').add(Date.DAY, 5).add(Date.HOUR, 8).add(Date.MINUTE, -30);
 792 document.write(dt3); //returns 'Fri Oct 06 2006 07:30:00'
 793  &lt;/code&gt;&lt;/pre&gt;
 794  *
 795  * @param {String} interval   A valid date interval enum value
 796  * @param {Number} value      The amount to add to the current date
 797  * @return {Date} The new Date instance
 798  */
 799 </span><span class="jsdoc-var">Date.prototype.add </span><span class="jsdoc-syntax">= </span><span class="jsdoc-keyword">function</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">interval</span><span class="jsdoc-syntax">, </span><span class="jsdoc-var">value</span><span class="jsdoc-syntax">){
 800   </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">d </span><span class="jsdoc-syntax">= </span><span class="jsdoc-var">this.clone</span><span class="jsdoc-syntax">();
 801   </span><span class="jsdoc-keyword">if </span><span class="jsdoc-syntax">(!</span><span class="jsdoc-var">interval </span><span class="jsdoc-syntax">|| </span><span class="jsdoc-var">value </span><span class="jsdoc-syntax">=== 0) { </span><span class="jsdoc-keyword">return </span><span class="jsdoc-var">d</span><span class="jsdoc-syntax">; }
 802   </span><span class="jsdoc-keyword">switch</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">interval.toLowerCase</span><span class="jsdoc-syntax">()){
 803     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-var">Date.MILLI</span><span class="jsdoc-syntax">:
 804       </span><span class="jsdoc-var">d.setMilliseconds</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getMilliseconds</span><span class="jsdoc-syntax">() + </span><span class="jsdoc-var">value</span><span class="jsdoc-syntax">);
 805       </span><span class="jsdoc-keyword">break</span><span class="jsdoc-syntax">;
 806     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-var">Date.SECOND</span><span class="jsdoc-syntax">:
 807       </span><span class="jsdoc-var">d.setSeconds</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getSeconds</span><span class="jsdoc-syntax">() + </span><span class="jsdoc-var">value</span><span class="jsdoc-syntax">);
 808       </span><span class="jsdoc-keyword">break</span><span class="jsdoc-syntax">;
 809     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-var">Date.MINUTE</span><span class="jsdoc-syntax">:
 810       </span><span class="jsdoc-var">d.setMinutes</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getMinutes</span><span class="jsdoc-syntax">() + </span><span class="jsdoc-var">value</span><span class="jsdoc-syntax">);
 811       </span><span class="jsdoc-keyword">break</span><span class="jsdoc-syntax">;
 812     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-var">Date.HOUR</span><span class="jsdoc-syntax">:
 813       </span><span class="jsdoc-var">d.setHours</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getHours</span><span class="jsdoc-syntax">() + </span><span class="jsdoc-var">value</span><span class="jsdoc-syntax">);
 814       </span><span class="jsdoc-keyword">break</span><span class="jsdoc-syntax">;
 815     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-var">Date.DAY</span><span class="jsdoc-syntax">:
 816       </span><span class="jsdoc-var">d.setDate</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getDate</span><span class="jsdoc-syntax">() + </span><span class="jsdoc-var">value</span><span class="jsdoc-syntax">);
 817       </span><span class="jsdoc-keyword">break</span><span class="jsdoc-syntax">;
 818     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-var">Date.MONTH</span><span class="jsdoc-syntax">:
 819       </span><span class="jsdoc-keyword">var </span><span class="jsdoc-var">day </span><span class="jsdoc-syntax">= </span><span class="jsdoc-var">this.getDate</span><span class="jsdoc-syntax">();
 820       </span><span class="jsdoc-keyword">if</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">day </span><span class="jsdoc-syntax">&gt; 28){
 821           </span><span class="jsdoc-var">day </span><span class="jsdoc-syntax">= </span><span class="jsdoc-var">Math.min</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">day</span><span class="jsdoc-syntax">, </span><span class="jsdoc-var">this.getFirstDateOfMonth</span><span class="jsdoc-syntax">()</span><span class="jsdoc-var">.add</span><span class="jsdoc-syntax">(</span><span class="jsdoc-string">'mo'</span><span class="jsdoc-syntax">, </span><span class="jsdoc-var">value</span><span class="jsdoc-syntax">)</span><span class="jsdoc-var">.getLastDateOfMonth</span><span class="jsdoc-syntax">()</span><span class="jsdoc-var">.getDate</span><span class="jsdoc-syntax">());
 822       }
 823       </span><span class="jsdoc-var">d.setDate</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">day</span><span class="jsdoc-syntax">);
 824       </span><span class="jsdoc-var">d.setMonth</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getMonth</span><span class="jsdoc-syntax">() + </span><span class="jsdoc-var">value</span><span class="jsdoc-syntax">);
 825       </span><span class="jsdoc-keyword">break</span><span class="jsdoc-syntax">;
 826     </span><span class="jsdoc-keyword">case </span><span class="jsdoc-var">Date.YEAR</span><span class="jsdoc-syntax">:
 827       </span><span class="jsdoc-var">d.setFullYear</span><span class="jsdoc-syntax">(</span><span class="jsdoc-var">this.getFullYear</span><span class="jsdoc-syntax">() + </span><span class="jsdoc-var">value</span><span class="jsdoc-syntax">);
 828       </span><span class="jsdoc-keyword">break</span><span class="jsdoc-syntax">;
 829   }
 830   </span><span class="jsdoc-keyword">return </span><span class="jsdoc-var">d</span><span class="jsdoc-syntax">;
 831 };
 832 </span></code></body></html>