Date
A Date object is used to work with dates and times.
Date objects are created with new Date().
There are four ways of creating a Date object:
var dt = new Date();
var dt = new Date(milliseconds);
var dt = new Date(dateString);
var dt = new Date(year, month, day, hours, minutes, seconds, milliseconds);
Example of setting a date
var startDate = new Date();
startDate.setFullYear(2013,0,14); // startDate == "Jan 14, 2013"
month is zero-based i.e. 0 == ‘January’
Example of comparing two dates
var startDate = new Date();
startDate.setFullYear(2013,0,14);
var today = new Date();
if (startDate > today) {
// startDate later than today's date
} else {
// startDate is on or before today's date
}
Date Properties
|
Property |
Description |
|---|---|
|
constructor |
Returns the function that created the Date object's prototype. |
|
prototype |
Allows you to add properties and methods to a Date object. |
Date Methods
|
Method |
Description |
|---|---|
|
getDate() |
Returns the day of the month (from 1-31). |
|
getDay() |
Returns the day of the week (from 0-6). |
|
getFullYear() |
Returns the year (four digits) |
|
getHours() |
Returns the hour (from 0-23). |
|
getMilliseconds() |
Returns the milliseconds (from 0-999). |
|
getMinutes() |
Returns the minutes (from 0-59). |
|
getMonth() |
Returns the month (from 0-11). |
|
getSeconds() |
Returns the seconds (from 0-59). |
|
getTime() |
Returns the number of milliseconds since midnight Jan 1, 1970. |
|
getTimezoneOffset() |
Returns the time difference between UTC time and local time, in minutes. |
|
getUTCDate() |
Returns the day of the month, according to universal time (from 1-31). |
|
getUTCDay() |
Returns the day of the week, according to universal time (from 0-6). |
|
getUTCFullYear() |
Returns the year, according to universal time (four digits). |
|
getUTCHours() |
Returns the hour, according to universal time (from 0-23). |
|
getUTCMilliseconds() |
Returns the milliseconds, according to universal time (from 0-999). |
|
getUTCMinutes() |
Returns the minutes, according to universal time (from 0-59). |
|
getUTCMonth() |
Returns the month, according to universal time (from 0-11). |
|
getUTCSeconds() |
Returns the seconds, according to universal time (from 0-59). |
|
getYear() |
Deprecated. Use the getFullYear() method instead. |
|
parse() |
Parses a date string and returns the number of milliseconds since midnight of January 1, 1970. |
|
setDate() |
Sets the day of the month of a date object. |
|
setFullYear() |
Sets the year (four digits) of a date object. |
|
setHours() |
Sets the hour of a date object . |
|
setMilliseconds() |
Sets the milliseconds of a date object. |
|
setMinutes() |
Set the minutes of a date object. |
|
setMonth() |
Sets the month of a date object. |
|
setSeconds() |
Sets the seconds of a date object. |
|
setTime() |
Sets a date and time by adding or subtracting a specified number of milliseconds to/from midnight January 1, 1970. |
|
setUTCDate() |
Sets the day of the month of a date object, according to universal time. |
|
setUTCFullYear() |
Sets the year of a date object, according to universal time (four digits). |
|
setUTCHours() |
Sets the hour of a date object, according to universal time. |
|
setUTCMilliseconds() |
Sets the milliseconds of a date object, according to universal time. |
|
setUTCMinutes() |
Set the minutes of a date object, according to universal time. |
|
setUTCMonth() |
Sets the month of a date object, according to universal time. |
|
setUTCSeconds() |
Set the seconds of a date object, according to universal time. |
|
setYear() |
Deprecated. Use the setFullYear() method instead |
|
toDateString() |
Converts the date portion of a Date object into a readable string |
|
toGMTString() |
Deprecated. Use the toUTCString() method instead. |
|
toISOString() |
Returns the date as a string, using the ISO standard. |
|
toJSON() |
Returns the date as a string, formated as a JSON date. |
|
toLocaleDateString() |
Returns the date portion of a Date object as a string, using locale conventions. |
|
toLocaleTimeString() |
Returns the time portion of a Date object as a string, using locale conventions. |
|
toLocaleString() |
Converts a Date object to a string, using locale conventions |
|
toString() |
Converts a Date object to a string. |
|
toTimeString() |
Converts the time portion of a Date object to a string |
|
toUTCString() |
Converts a Date object to a string, according to universal time |
|
UTC() |
Returns the number of milliseconds in a date string since midnight of January 1, 1970, according to universal time. |
|
valueOf() |
Returns the primitive value of a Date object. |