projects / roojs1 / blob
? search:


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