JavaScript Date and Time Functions
JavaScript provides the following date and time functions. Note that UTC stands for Universal Coordinated Time which refers to the time as set by the World Time Standard. Previously referred to as Greenwich Mean Time or GMT.
Function | Description | Returned Values |
---|---|---|
getdate() getUTCDate() |
Day of the month | 1-31 |
getday() getUTCDay() |
Day of the week (integer) | 0-6 |
getFullYear() getUTCFullYear() |
Year (full four digit) | 1900+ |
getHours() getUTCHours() |
Hour of the day (integer) | 0-23 |
getMilliseconds() getUTCMilliseconds() |
Milliseconds (since last second) | 0-999 |
getMinutes() getUTCMinutes() |
Minutes (since last hour) | 0-59 |
getMonth() getUTCMonth() |
Month | 0-11 |
getSeconds() getUTCSeconds() |
Seconds (since last minute) | 0-59 |
getTime() | Number of milliseconds since 1 January 1970 | |
getTimezoneOffset() | Difference between local time and GMT in minutes | The difference, in minutes, between UTC and local time. The value is positive if the local timezone is behind UTC and negative if it is ahead. For example, a timezone of UTC+10 (Australian Eastern Standard Time) will return -600. |
getYear() | Year |
0-99 for years between 1900-1999 Four digit for 2000+ |
parse() | Returns the number of milliseconds since midnight 1 January 1970 for a given date and time string passed to it. | |
setdate() setUTCDate() |
Sets the day, given a number between 1-31 | Date in milliseconds |
setFullYear() setUTCFullYear() |
Sets the year, given a four digit number | Date in milliseconds |
setHours() setUTCHours() |
Sets the hour, given a number between 0-23 | Date in milliseconds |
setMilliseconds() setUTCMilliseconds() |
Sets the milliseconds, given a number | Date in milliseconds |
setMinutes() setUTCMinutes() |
Sets the minutes, given a number between 0-59 | Date in milliseconds |
setMonth() setUTCMonth() |
Sets the month, given a number between 0-11 | Date in milliseconds |
setSeconds() setUTCSeconds() |
Sets the seconds,l given a number between 0-59 | Date in milliseconds |
setTime() | Sets the date, given the number of milliseconds since 1 January 1970 | Date in milliseconds |
setYear() | Sets the year, given either a two digit or four digit number | Date in milliseconds |
toGMTString() toUTCString() |
GMT date and time as a string | day dd mmm yyyy hh:mm:ss GMT |
toLocaleString() | Local date and time as a string | Depends on operating system, locale, and browser |
toString() | Local date and time as a string | Depends on operating system, locale, and browser |
UTC() | Returns the number of milliseconds since 1 January 1970 for a given date in year, month, day (and optionally, hours, minutes, seconds, and milliseconds) | Date in milliseconds |
valueOf() | Number of milliseconds since 1 January 1970 | Date in milliseconds |
To learn how to display the current date and time see JavaScript Date and Time.