467 lines
11 KiB
JavaScript
467 lines
11 KiB
JavaScript
/*
|
|
* Date prototype extensions. Doesn't depend on any
|
|
* other code. Doens't overwrite existing methods.
|
|
*
|
|
* Adds dayNames, abbrDayNames, monthNames and abbrMonthNames static properties and isLeapYear,
|
|
* isWeekend, isWeekDay, getDaysInMonth, getDayName, getMonthName, getDayOfYear, getWeekOfYear,
|
|
* setDayOfYear, addYears, addMonths, addDays, addHours, addMinutes, addSeconds methods
|
|
*
|
|
* Copyright (c) 2006 Jörn Zaefferer and Brandon Aaron (brandon.aaron@gmail.com || http://brandonaaron.net)
|
|
*
|
|
* Additional methods and properties added by Kelvin Luck: firstDayOfWeek, dateFormat, zeroTime, asString, fromString -
|
|
* I've added my name to these methods so you know who to blame if they are broken!
|
|
*
|
|
* Dual licensed under the MIT and GPL licenses:
|
|
* http://www.opensource.org/licenses/mit-license.php
|
|
* http://www.gnu.org/licenses/gpl.html
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* An Array of day names starting with Sunday.
|
|
*
|
|
* @example dayNames[0]
|
|
* @result 'Sunday'
|
|
*
|
|
* @name dayNames
|
|
* @type Array
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
Date.dayNames = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
|
|
|
|
/**
|
|
* An Array of abbreviated day names starting with Sun.
|
|
*
|
|
* @example abbrDayNames[0]
|
|
* @result 'Sun'
|
|
*
|
|
* @name abbrDayNames
|
|
* @type Array
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
Date.abbrDayNames = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
|
|
|
|
/**
|
|
* An Array of month names starting with Janurary.
|
|
*
|
|
* @example monthNames[0]
|
|
* @result 'January'
|
|
*
|
|
* @name monthNames
|
|
* @type Array
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
Date.monthNames = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];
|
|
|
|
/**
|
|
* An Array of abbreviated month names starting with Jan.
|
|
*
|
|
* @example abbrMonthNames[0]
|
|
* @result 'Jan'
|
|
*
|
|
* @name monthNames
|
|
* @type Array
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
Date.abbrMonthNames = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
|
|
|
|
/**
|
|
* The first day of the week for this locale.
|
|
*
|
|
* @name firstDayOfWeek
|
|
* @type Number
|
|
* @cat Plugins/Methods/Date
|
|
* @author Kelvin Luck
|
|
*/
|
|
Date.firstDayOfWeek = 1;
|
|
|
|
/**
|
|
* 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).
|
|
*
|
|
* @name format
|
|
* @type String
|
|
* @cat Plugins/Methods/Date
|
|
* @author Kelvin Luck
|
|
*/
|
|
Date.format = 'dd/mm/yyyy';
|
|
//Date.format = 'mm/dd/yyyy';
|
|
//Date.format = 'yyyy-mm-dd';
|
|
//Date.format = 'dd mmm yy';
|
|
|
|
/**
|
|
* 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
|
|
* 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.
|
|
*
|
|
* @name format
|
|
* @type String
|
|
* @cat Plugins/Methods/Date
|
|
* @author Kelvin Luck
|
|
*/
|
|
Date.fullYearStart = '20';
|
|
|
|
(function() {
|
|
|
|
/**
|
|
* Adds a given method under the given name
|
|
* to the Date prototype if it doesn't
|
|
* currently exist.
|
|
*
|
|
* @private
|
|
*/
|
|
function add(name, method) {
|
|
if( !Date.prototype[name] ) {
|
|
Date.prototype[name] = method;
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Checks if the year is a leap year.
|
|
*
|
|
* @example var dtm = new Date("01/12/2008");
|
|
* dtm.isLeapYear();
|
|
* @result true
|
|
*
|
|
* @name isLeapYear
|
|
* @type Boolean
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
add("isLeapYear", function() {
|
|
var y = this.getFullYear();
|
|
return (y%4==0 && y%100!=0) || y%400==0;
|
|
});
|
|
|
|
/**
|
|
* Checks if the day is a weekend day (Sat or Sun).
|
|
*
|
|
* @example var dtm = new Date("01/12/2008");
|
|
* dtm.isWeekend();
|
|
* @result false
|
|
*
|
|
* @name isWeekend
|
|
* @type Boolean
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
add("isWeekend", function() {
|
|
return this.getDay()==0 || this.getDay()==6;
|
|
});
|
|
|
|
/**
|
|
* Check if the day is a day of the week (Mon-Fri)
|
|
*
|
|
* @example var dtm = new Date("01/12/2008");
|
|
* dtm.isWeekDay();
|
|
* @result false
|
|
*
|
|
* @name isWeekDay
|
|
* @type Boolean
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
add("isWeekDay", function() {
|
|
return !this.isWeekend();
|
|
});
|
|
|
|
/**
|
|
* Gets the number of days in the month.
|
|
*
|
|
* @example var dtm = new Date("01/12/2008");
|
|
* dtm.getDaysInMonth();
|
|
* @result 31
|
|
*
|
|
* @name getDaysInMonth
|
|
* @type Number
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
add("getDaysInMonth", function() {
|
|
return [31,(this.isLeapYear() ? 29:28),31,30,31,30,31,31,30,31,30,31][this.getMonth()];
|
|
});
|
|
|
|
/**
|
|
* Gets the name of the day.
|
|
*
|
|
* @example var dtm = new Date("01/12/2008");
|
|
* dtm.getDayName();
|
|
* @result 'Saturday'
|
|
*
|
|
* @example var dtm = new Date("01/12/2008");
|
|
* dtm.getDayName(true);
|
|
* @result 'Sat'
|
|
*
|
|
* @param abbreviated Boolean When set to true the name will be abbreviated.
|
|
* @name getDayName
|
|
* @type String
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
add("getDayName", function(abbreviated) {
|
|
return abbreviated ? Date.abbrDayNames[this.getDay()] : Date.dayNames[this.getDay()];
|
|
});
|
|
|
|
/**
|
|
* Gets the name of the month.
|
|
*
|
|
* @example var dtm = new Date("01/12/2008");
|
|
* dtm.getMonthName();
|
|
* @result 'Janurary'
|
|
*
|
|
* @example var dtm = new Date("01/12/2008");
|
|
* dtm.getMonthName(true);
|
|
* @result 'Jan'
|
|
*
|
|
* @param abbreviated Boolean When set to true the name will be abbreviated.
|
|
* @name getDayName
|
|
* @type String
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
add("getMonthName", function(abbreviated) {
|
|
return abbreviated ? Date.abbrMonthNames[this.getMonth()] : Date.monthNames[this.getMonth()];
|
|
});
|
|
|
|
/**
|
|
* Get the number of the day of the year.
|
|
*
|
|
* @example var dtm = new Date("01/12/2008");
|
|
* dtm.getDayOfYear();
|
|
* @result 11
|
|
*
|
|
* @name getDayOfYear
|
|
* @type Number
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
add("getDayOfYear", function() {
|
|
var tmpdtm = new Date("1/1/" + this.getFullYear());
|
|
return Math.floor((this.getTime() - tmpdtm.getTime()) / 86400000);
|
|
});
|
|
|
|
/**
|
|
* Get the number of the week of the year.
|
|
*
|
|
* @example var dtm = new Date("01/12/2008");
|
|
* dtm.getWeekOfYear();
|
|
* @result 2
|
|
*
|
|
* @name getWeekOfYear
|
|
* @type Number
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
add("getWeekOfYear", function() {
|
|
return Math.ceil(this.getDayOfYear() / 7);
|
|
});
|
|
|
|
/**
|
|
* Set the day of the year.
|
|
*
|
|
* @example var dtm = new Date("01/12/2008");
|
|
* dtm.setDayOfYear(1);
|
|
* dtm.toString();
|
|
* @result 'Tue Jan 01 2008 00:00:00'
|
|
*
|
|
* @name setDayOfYear
|
|
* @type Date
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
add("setDayOfYear", function(day) {
|
|
this.setMonth(0);
|
|
this.setDate(day);
|
|
return this;
|
|
});
|
|
|
|
/**
|
|
* Add a number of years to the date object.
|
|
*
|
|
* @example var dtm = new Date("01/12/2008");
|
|
* dtm.addYears(1);
|
|
* dtm.toString();
|
|
* @result 'Mon Jan 12 2009 00:00:00'
|
|
*
|
|
* @name addYears
|
|
* @type Date
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
add("addYears", function(num) {
|
|
this.setFullYear(this.getFullYear() + num);
|
|
return this;
|
|
});
|
|
|
|
/**
|
|
* Add a number of months to the date object.
|
|
*
|
|
* @example var dtm = new Date("01/12/2008");
|
|
* dtm.addMonths(1);
|
|
* dtm.toString();
|
|
* @result 'Tue Feb 12 2008 00:00:00'
|
|
*
|
|
* @name addMonths
|
|
* @type Date
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
add("addMonths", function(num) {
|
|
var tmpdtm = this.getDate();
|
|
|
|
this.setMonth(this.getMonth() + num);
|
|
|
|
if (tmpdtm > this.getDate())
|
|
this.addDays(-this.getDate());
|
|
|
|
return this;
|
|
});
|
|
|
|
/**
|
|
* Add a number of days to the date object.
|
|
*
|
|
* @example var dtm = new Date("01/12/2008");
|
|
* dtm.addDays(1);
|
|
* dtm.toString();
|
|
* @result 'Sun Jan 13 2008 00:00:00'
|
|
*
|
|
* @name addDays
|
|
* @type Date
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
add("addDays", function(num) {
|
|
this.setDate(this.getDate() + num);
|
|
return this;
|
|
});
|
|
|
|
/**
|
|
* Add a number of hours to the date object.
|
|
*
|
|
* @example var dtm = new Date("01/12/2008");
|
|
* dtm.addHours(24);
|
|
* dtm.toString();
|
|
* @result 'Sun Jan 13 2008 00:00:00'
|
|
*
|
|
* @name addHours
|
|
* @type Date
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
add("addHours", function(num) {
|
|
this.setHours(this.getHours() + num);
|
|
return this;
|
|
});
|
|
|
|
/**
|
|
* Add a number of minutes to the date object.
|
|
*
|
|
* @example var dtm = new Date("01/12/2008");
|
|
* dtm.addMinutes(60);
|
|
* dtm.toString();
|
|
* @result 'Sat Jan 12 2008 01:00:00'
|
|
*
|
|
* @name addMinutes
|
|
* @type Date
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
add("addMinutes", function(num) {
|
|
this.setMinutes(this.getMinutes() + num);
|
|
return this;
|
|
});
|
|
|
|
/**
|
|
* Add a number of seconds to the date object.
|
|
*
|
|
* @example var dtm = new Date("01/12/2008");
|
|
* dtm.addSeconds(60);
|
|
* dtm.toString();
|
|
* @result 'Sat Jan 12 2008 00:01:00'
|
|
*
|
|
* @name addSeconds
|
|
* @type Date
|
|
* @cat Plugins/Methods/Date
|
|
*/
|
|
add("addSeconds", function(num) {
|
|
this.setSeconds(this.getSeconds() + num);
|
|
return this;
|
|
});
|
|
|
|
/**
|
|
* Sets the time component of this Date to zero for cleaner, easier comparison of dates where time is not relevant.
|
|
*
|
|
* @example var dtm = new Date();
|
|
* dtm.zeroTime();
|
|
* dtm.toString();
|
|
* @result 'Sat Jan 12 2008 00:01:00'
|
|
*
|
|
* @name zeroTime
|
|
* @type Date
|
|
* @cat Plugins/Methods/Date
|
|
* @author Kelvin Luck
|
|
*/
|
|
add("zeroTime", function() {
|
|
this.setMilliseconds(0);
|
|
this.setSeconds(0);
|
|
this.setMinutes(0);
|
|
this.setHours(0);
|
|
return this;
|
|
});
|
|
|
|
/**
|
|
* Returns a string representation of the date object according to Date.format.
|
|
* (Date.toString may be used in other places so I purposefully didn't overwrite it)
|
|
*
|
|
* @example var dtm = new Date("01/12/2008");
|
|
* dtm.asString();
|
|
* @result '12/01/2008' // (where Date.format == 'dd/mm/yyyy'
|
|
*
|
|
* @name asString
|
|
* @type Date
|
|
* @cat Plugins/Methods/Date
|
|
* @author Kelvin Luck
|
|
*/
|
|
add("asString", function() {
|
|
var r = Date.format;
|
|
return r
|
|
.split('yyyy').join(this.getFullYear())
|
|
.split('yy').join((this.getFullYear() + '').substring(2))
|
|
.split('mmm').join(this.getMonthName(true))
|
|
.split('mm').join(_zeroPad(this.getMonth()+1))
|
|
.split('dd').join(_zeroPad(this.getDate()));
|
|
});
|
|
|
|
/**
|
|
* 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
|
|
* (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)
|
|
*
|
|
* @example var dtm = Date.fromString("12/01/2008");
|
|
* dtm.toString();
|
|
* @result 'Sat Jan 12 2008 00:00:00' // (where Date.format == 'dd/mm/yyyy'
|
|
*
|
|
* @name fromString
|
|
* @type Date
|
|
* @cat Plugins/Methods/Date
|
|
* @author Kelvin Luck
|
|
*/
|
|
Date.fromString = function(s)
|
|
{
|
|
var f = Date.format;
|
|
var d = new Date('01/01/1977');
|
|
var iY = f.indexOf('yyyy');
|
|
if (iY > -1) {
|
|
d.setFullYear(Number(s.substr(iY, 4)));
|
|
} else {
|
|
// TODO - this doesn't work very well - are there any rules for what is meant by a two digit year?
|
|
d.setFullYear(Number(Date.fullYearStart + s.substr(f.indexOf('yy'), 2)));
|
|
}
|
|
var iM = f.indexOf('mmm');
|
|
if (iM > -1) {
|
|
var mStr = s.substr(iM, 3);
|
|
for (var i=0; i<Date.abbrMonthNames.length; i++) {
|
|
if (Date.abbrMonthNames[i] == mStr) break;
|
|
}
|
|
d.setMonth(i);
|
|
} else {
|
|
d.setMonth(Number(s.substr(f.indexOf('mm'), 2)) - 1);
|
|
}
|
|
d.setDate(Number(s.substr(f.indexOf('dd'), 2)));
|
|
if (isNaN(d.getTime())) {
|
|
return false;
|
|
}
|
|
return d;
|
|
};
|
|
|
|
// utility method
|
|
var _zeroPad = function(num) {
|
|
var s = '0'+num;
|
|
return s.substring(s.length-2)
|
|
//return ('0'+num).substring(-2); // doesn't work on IE :(
|
|
};
|
|
|
|
})(); |