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" 

        
Note:

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.