2 * Date prototype extensions. Doesn't depend on any
3 * other code. Doens't overwrite existing methods.
5 * Adds dayNames, abbrDayNames, monthNames and abbrMonthNames static properties and isLeapYear,
6 * isWeekend, isWeekDay, getDaysInMonth, getDayName, getMonthName, getDayOfYear, getWeekOfYear,
7 * setDayOfYear, addYears, addMonths, addDays, addHours, addMinutes, addSeconds methods
9 * Copyright (c) 2006 J̦rn Zaefferer and Brandon Aaron (brandon.aaron@gmail.com || http://brandonaaron.net)
11 * Additional methods and properties added by Kelvin Luck: firstDayOfWeek, dateFormat, zeroTime, asString, fromString -
12 * I've added my name to these methods so you know who to blame if they are broken!
14 * Dual licensed under the MIT and GPL licenses:
15 * http://www.opensource.org/licenses/mit-license.php
16 * http://www.gnu.org/licenses/gpl.html
21 * An Array of day names starting with Sunday.
23 * @example dayNames[0]
28 * @cat Plugins/Methods/Date
30 Date
.dayNames
= ['', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
33 * An Array of abbreviated day names starting with Sun.
35 * @example abbrDayNames[0]
40 * @cat Plugins/Methods/Date
42 Date
.abbrDayNames
= ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
45 * An Array of month names starting with Janurary.
47 * @example monthNames[0]
52 * @cat Plugins/Methods/Date
54 Date
.monthNames
= ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];
57 * An Array of abbreviated month names starting with Jan.
59 * @example abbrMonthNames[0]
64 * @cat Plugins/Methods/Date
66 Date
.abbrMonthNames
= ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
69 * The first day of the week for this locale.
71 * @name firstDayOfWeek
73 * @cat Plugins/Methods/Date
76 Date
.firstDayOfWeek
= 1;
79 * The format that string dates should be represented as (e.g. 'dd/mm/yyyy' for UK, 'mm/dd/yyyy' for US, 'yyyy-mm-dd' for Unicode etc).
83 * @cat Plugins/Methods/Date
86 Date
.format
= 'dd/mm/yyyy';
87 //Date.format = 'mm/dd/yyyy';
88 //Date.format = 'yyyy-mm-dd';
89 //Date.format = 'dd mmm yy';
92 * The first two numbers in the century to be used when decoding a two digit year. Since a two digit year is ambiguous (and date.setYear
93 * only works with numbers < 99 and so doesn't allow you to set years after 2000) we need to use this to disambiguate the two digit year codes.
97 * @cat Plugins/Methods/Date
100 Date
.fullYearStart
= '20';
105 * Adds a given method under the given name
106 * to the Date prototype if it doesn't
111 function add(name
, method
) {
112 if( !Date
.prototype[name
] ) {
113 Date
.prototype[name
] = method
;
118 * Checks if the year is a leap year.
120 * @example var dtm = new Date("01/12/2008");
126 * @cat Plugins/Methods/Date
128 add("isLeapYear", function() {
129 var y
= this.getFullYear();
130 return (y
%4==0 && y
%100!=0) || y
%400==0;
134 * Checks if the day is a weekend day (Sat or Sun).
136 * @example var dtm = new Date("01/12/2008");
142 * @cat Plugins/Methods/Date
144 add("isWeekend", function() {
145 return this.getDay()==0 || this.getDay()==6;
149 * Check if the day is a day of the week (Mon-Fri)
151 * @example var dtm = new Date("01/12/2008");
157 * @cat Plugins/Methods/Date
159 add("isWeekDay", function() {
160 return !this.isWeekend();
164 * Gets the number of days in the month.
166 * @example var dtm = new Date("01/12/2008");
167 * dtm.getDaysInMonth();
170 * @name getDaysInMonth
172 * @cat Plugins/Methods/Date
174 add("getDaysInMonth", function() {
175 return [31,(this.isLeapYear() ? 29:28),31,30,31,30,31,31,30,31,30,31][this.getMonth()];
179 * Gets the name of the day.
181 * @example var dtm = new Date("01/12/2008");
185 * @example var dtm = new Date("01/12/2008");
186 * dtm.getDayName(true);
189 * @param abbreviated Boolean When set to true the name will be abbreviated.
192 * @cat Plugins/Methods/Date
194 add("getDayName", function(abbreviated
) {
195 return abbreviated
? Date
.abbrDayNames
[this.getDay()] : Date
.dayNames
[this.getDay()];
199 * Gets the name of the month.
201 * @example var dtm = new Date("01/12/2008");
202 * dtm.getMonthName();
205 * @example var dtm = new Date("01/12/2008");
206 * dtm.getMonthName(true);
209 * @param abbreviated Boolean When set to true the name will be abbreviated.
212 * @cat Plugins/Methods/Date
214 add("getMonthName", function(abbreviated
) {
215 return abbreviated
? Date
.abbrMonthNames
[this.getMonth()] : Date
.monthNames
[this.getMonth()];
219 * Get the number of the day of the year.
221 * @example var dtm = new Date("01/12/2008");
222 * dtm.getDayOfYear();
227 * @cat Plugins/Methods/Date
229 add("getDayOfYear", function() {
230 var tmpdtm
= new Date("1/1/" + this.getFullYear());
231 return Math
.floor((this.getTime() - tmpdtm
.getTime()) / 86400000);
235 * Get the number of the week of the year.
237 * @example var dtm = new Date("01/12/2008");
238 * dtm.getWeekOfYear();
241 * @name getWeekOfYear
243 * @cat Plugins/Methods/Date
245 add("getWeekOfYear", function() {
246 return Math
.ceil(this.getDayOfYear() / 7);
250 * Set the day of the year.
252 * @example var dtm = new Date("01/12/2008");
253 * dtm.setDayOfYear(1);
255 * @result 'Tue Jan 01 2008 00:00:00'
259 * @cat Plugins/Methods/Date
261 add("setDayOfYear", function(day
) {
268 * Add a number of years to the date object.
270 * @example var dtm = new Date("01/12/2008");
273 * @result 'Mon Jan 12 2009 00:00:00'
277 * @cat Plugins/Methods/Date
279 add("addYears", function(num
) {
280 this.setFullYear(this.getFullYear() + num
);
285 * Add a number of months to the date object.
287 * @example var dtm = new Date("01/12/2008");
290 * @result 'Tue Feb 12 2008 00:00:00'
294 * @cat Plugins/Methods/Date
296 add("addMonths", function(num
) {
297 var tmpdtm
= this.getDate();
299 this.setMonth(this.getMonth() + num
);
301 if (tmpdtm
> this.getDate())
302 this.addDays(-this.getDate());
308 * Add a number of days to the date object.
310 * @example var dtm = new Date("01/12/2008");
313 * @result 'Sun Jan 13 2008 00:00:00'
317 * @cat Plugins/Methods/Date
319 add("addDays", function(num
) {
320 this.setDate(this.getDate() + num
);
325 * Add a number of hours to the date object.
327 * @example var dtm = new Date("01/12/2008");
330 * @result 'Sun Jan 13 2008 00:00:00'
334 * @cat Plugins/Methods/Date
336 add("addHours", function(num
) {
337 this.setHours(this.getHours() + num
);
342 * Add a number of minutes to the date object.
344 * @example var dtm = new Date("01/12/2008");
345 * dtm.addMinutes(60);
347 * @result 'Sat Jan 12 2008 01:00:00'
351 * @cat Plugins/Methods/Date
353 add("addMinutes", function(num
) {
354 this.setMinutes(this.getMinutes() + num
);
359 * Add a number of seconds to the date object.
361 * @example var dtm = new Date("01/12/2008");
362 * dtm.addSeconds(60);
364 * @result 'Sat Jan 12 2008 00:01:00'
368 * @cat Plugins/Methods/Date
370 add("addSeconds", function(num
) {
371 this.setSeconds(this.getSeconds() + num
);
376 * Sets the time component of this Date to zero for cleaner, easier comparison of dates where time is not relevant.
378 * @example var dtm = new Date();
381 * @result 'Sat Jan 12 2008 00:01:00'
385 * @cat Plugins/Methods/Date
386 * @author Kelvin Luck
388 add("zeroTime", function() {
389 this.setMilliseconds(0);
397 * Returns a string representation of the date object according to Date.format.
398 * (Date.toString may be used in other places so I purposefully didn't overwrite it)
400 * @example var dtm = new Date("01/12/2008");
402 * @result '12/01/2008' // (where Date.format == 'dd/mm/yyyy'
406 * @cat Plugins/Methods/Date
407 * @author Kelvin Luck
409 add("asString", function() {
412 .split('yyyy').join(this.getFullYear())
413 .split('yy').join((this.getFullYear() + '').substring(2))
414 .split('mmm').join(this.getMonthName(true))
415 .split('mm').join(_zeroPad(this.getMonth()+1))
416 .split('dd').join(_zeroPad(this.getDate()));
420 * Returns a new date object created from the passed String according to Date.format or false if the attempt to do this results in an invalid date object
421 * (We can't simple use Date.parse as it's not aware of locale and I chose not to overwrite it incase it's functionality is being relied on elsewhere)
423 * @example var dtm = Date.fromString("12/01/2008");
425 * @result 'Sat Jan 12 2008 00:00:00' // (where Date.format == 'dd/mm/yyyy'
429 * @cat Plugins/Methods/Date
430 * @author Kelvin Luck
432 Date
.fromString = function(s
)
435 var d
= new Date('01/01/1977');
436 var iY
= f
.indexOf('yyyy');
438 d
.setFullYear(Number(s
.substr(iY
, 4)));
440 // TODO - this doesn't work very well - are there any rules for what is meant by a two digit year?
441 d
.setFullYear(Number(Date
.fullYearStart
+ s
.substr(f
.indexOf('yy'), 2)));
443 var iM
= f
.indexOf('mmm');
445 var mStr
= s
.substr(iM
, 3);
446 for (var i
=0; i
<Date
.abbrMonthNames
.length
; i
++) {
447 if (Date
.abbrMonthNames
[i
] == mStr
) break;
451 d
.setMonth(Number(s
.substr(f
.indexOf('mm'), 2)) - 1);
453 d
.setDate(Number(s
.substr(f
.indexOf('dd'), 2)));
454 if (isNaN(d
.getTime())) {
461 var _zeroPad = function(num
) {
463 return s
.substring(s
.length
-2)
464 //return ('0'+num).substring(-2); // doesn't work on IE :(