Date : Object

An object that represents a date and time. Internally the time is stored

as the number of milliseconds since 01 January, 1970 UTC.

Use %%#new_Date|**new Date()**%% to get a Date for the current time or

%%#now|**Date.now()**%% to get the current time in milliseconds since

01 January, 1970 UTC.

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9

----

Date() : String

Returns a string representation of the current date and time.

<example>

console.log(Date());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.2

----

new Date() : Date

Returns a new **Date** object that represents the current date and time.

<example>

var d = new Date();

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.3.3

----

new Date(year : Number, month : Number, [date = 1 : Number, [hours = 0: Number, [minutes = 0: Number, [seconds = 0: Number, [milliseconds = 0: Number]]]]]) : Date

Returns a new **Date** object that represents the specified date and time.

**month** 0 is January, 1 is February, etc.

**date** is the calendar day, starting with 1 and will be at most 31.

<example>

var d = new Date(2002, 5, 24, 18, 30);

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.3.1

----

new Date(millisecondsSince1970 : Number) : Date

Returns a new **Date** object that is the specified number of milliseconds from

01 January, 1970 UTC.

<example>

var d = new Date(365 * 24 * 60 * 60 * 1000);

console.log(d.toUTCString());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.3.1

----

new Date(string : String) : Date

Parses **string** and returns a new Date object representing the specified date and time.

See also %%#parse|**Date.parse(string)**%%.

<example>

var d = new Date('Fri, 01 Jan 1971 00:00:00 GMT');

console.log(d.getUTCFullYear());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.3.2

----

parse(string : String) : Number

Parses **string** into a date and returns the number of milliseconds this date

is from 01 January, 1970 UTC.

Use %%#new_Date_String|**new Date(string)**%% to get a Date object from a string.

<example>

var d = Date.parse('Fri, 01 Jan 1971 00:00:00 GMT');

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.4.2

----

UTC(year : Number, month : Number, [date = 1 : Number, [hour = 0: Number, [minutes = 0: Number, [seconds = 0: Number, [milliseconds = 0: Number]]]]]) : Number

Returns the number of milliseconds fom 01 January, 1970 UTC of the specified

date and time in UTC.

**month** 0 is January, 1 is February, etc.

**date** is the calendar day, starting with 1 and will be at most 31.

<example>

var d = Date.UTC(1971, 0, 1);

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.4.3

----

now() : Number

Returns the number of milliseconds from 01 January, 1970 of the current

time in UTC.

<example>

var now = Date.now();

console.log(now);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.4.4

----

prototype.toDateString() : String

Returns a string representing the date portion of **this**.

<example>

var d = new Date();

console.log(d.toDateString());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.3

----

prototype.toTimeString() : String

Returns a string representing the time portion of **this**.

<example>

var d = new Date();

console.log(d.toTimeString());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.4

----

prototype.toLocaleString() : String

Returns a human readable string of **this** in the local time.

<example>

var d = new Date();

console.log(d.toLocaleString());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.5

----

prototype.toLocaleDateString() : String

Returns a human readable string of the date portion of **this** in

local time.

<example>

var d = new Date();

console.log(d.toLocaleDateString());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.6

----

prototype.toLocaleTimeString() : String

Returns a human readable string of the time potion of **this** in

local time.

<example>

var d = new Date();

console.log(d.toLocaleTimeString());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.7

----

prototype.valueOf() : Number

Returns the number of milliseconds since 01 January, 1970 UTC for **this**.

You can also obtain the value by using the date in a number context such as **+date**.

If you need the value of the current time, use %%#now|**Date.now()**%% to

avoid the cost of creating a **Date** object.

See also %%#getTime|**getTime()**%%.

<example>

var d = new Date();

console.log(d.valueOf());

console.log(d.getTime());

console.log(+d);

console.log(d / 1000 / 60 / 60 / 24 / 365 + ' years since 1970');

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.8

----

prototype.getTime() : Number

Returns the number of milliseconds since 01 January, 1970 for **this**.

See also %%#valueOf|**valueOf()**%%.

<example>

var d = new Date();

console.log(d.getTime());

console.log(d.valueOf());

console.log(+d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.9

----

prototype.getFullYear() : Number

Returns the year of **this** in local time.

<example>

var d = new Date();

console.log(d.getFullYear());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.10

----

prototype.getUTCFullYear() : Number

Returns the year of **this** in UTC time.

<example>

var d = new Date();

console.log(d.getUTCFullYear());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.11

----

prototype.getMonth() : Number

Returns the month of **this** in local time.

0 is January, 1 is February, etc.

<example>

var d = new Date();

console.log(d.getMonth());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.12

----

prototype.getUTCMonth() : Number

Returns the month of **this** in UTC time.

0 is January, 1 is February, etc.

<example>

var d = new Date();

console.log(d.getUTCMonth());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.13

----

prototype.getDate() : Number

Returns the date of **this** in local time.

Date is the calendar day, starting with 1 and will be at most 31.

<example>

var d = new Date();

console.log(d.getDate());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.14

----

prototype.getUTCDate() : Number

Returns the date of **this** in UTC time.

Date is the calendar day, starting with 1 and will be at most 31.

<example>

var d = new Date();

console.log(d.getUTCDate());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.15

----

prototype.getDay() : Number

Returns the day of the week of **this** in local time. 0 = Sunday, 1 = Monday,

2 = Tuesday, etc.

<example>

var d = new Date();

console.log(d.getDay());

var dayNames = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];

console.log(dayNames[d.getDay()]);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.16

----

prototype.getUTCDay() : Number

Returns the day of the week of **this** in UTC time. 0 = Sunday, 1 = Monday,

2 = Tuesday, 3 = Wednesday, 4 = Thursday, 5 = Friday, 6 = Saturday.

<example>

var d = new Date();

console.log(d.getUTCDay());

var dayNames = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];

console.log(dayNames[d.getUTCDay()]);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.17

----

prototype.getHours() : Number

Returns the hours of **this** in local time.

<example>

var d = new Date();

console.log(d.getHours());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.18

----

prototype.getUTCHours() : Number

Returns the hours of **this** in UTC time.

<example>

var d = new Date();

console.log(d.getUTCHours());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.19

----

prototype.getMinutes() : Number

Returns the minutes of **this** in local time.

<example>

var d = new Date();

console.log(d.getMinutes());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.20

----

prototype.getUTCMinutes() : Number

Returns the minutes of **this** in UTC time.

<example>

var d = new Date();

console.log(d.getUTCMinutes());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.21

----

prototype.getSeconds() : Number

Returns the seconds of **this** in local time.

<example>

var d = new Date();

console.log(d.getSeconds());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.22

----

prototype.getUTCSeconds() : Number

Returns the seconds of **this** in UTC time.

<example>

var d = new Date();

console.log(d.getUTCSeconds());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.23

----

prototype.getMilliseconds() : Number

Returns the milliseconds of **this** in local time.

<example>

var d = new Date();

console.log(d.getMilliseconds());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.24

----

prototype.getUTCMilliseconds() : Number

Returns the milliseconds of **this** in UTC time.

<example>

var d = new Date();

console.log(d.getUTCMilliseconds());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.25

----

prototype.getTimezoneOffset() : Number

Returns the number of minutes between local time and UTC time.

<example>

var d = new Date();

console.log(d.getTimezoneOffset());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.26

----

prototype.setTime(millisecondsSince1970 : Number) : Number

Set this date to be the specified number of milliseconds from

01 January, 1970 UTC.

<example>

var d = new Date();

d.setTime(365 * 24 * 60 * 60 * 1000);

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.27

----

prototype.setMilliseconds(milliseconds : Number) : Number

Sets the number of milliseconds of **this**.

The other time components remain unchanged. Returns the time value

of **this**.

<example>

var d = new Date();

console.log(d);

d.setMilliseconds(0);

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.28

----

prototype.setUTCMilliseconds(milliseconds : Number) : Number

Sets the number of milliseconds of **this**.

The other time components remain unchanged. Returns the time value

of **this**.

<example>

var d = new Date();

console.log(d);

d.setUTCMilliseconds(0);

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.29

----

prototype.setSeconds(seconds : Number, [milliseconds : Number]) : Number

Sets the number of seconds (and optionally milliseconds) of **this**.

The other time components remain unchanged.

<example>

var d = new Date();

console.log(d);

d.setSeconds(0);

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.30

----

prototype.setUTCSeconds(seconds : Number, [milliseconds : Number]) : Number

Sets the number of seconds (and optionally milliseconds) of **this**.

The other time components remain unchanged.

<example>

var d = new Date();

console.log(d);

d.setUTCSeconds(0);

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.31

----

prototype.setMinutes(minutes : Number, [seconds : Number, [milliseconds : Number]]) : Number

Sets the number of minutes (and optionally seconds and milliseconds) of **this**.

The other time components remain unchanged.

<example>

var d = new Date();

console.log(d);

d.setMinutes(0);

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.32

----

prototype.setUTCMinutes(minutes : Number, [seconds : Number, [milliseconds : Number]]) : Number

Sets the number of minutes (and optionally seconds and milliseconds) of **this**.

The other time components remain unchanged.

<example>

var d = new Date();

console.log(d);

d.setUTCMinutes(0);

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.33

----

prototype.setHours(hours : Number, [minutes : Number, [seconds : Number, [milliseconds : Number]]]) : Number

Sets the number of hours (and optionally minutes, seconds and milliseconds) of **this**.

The other time components remain unchanged.

<example>

var d = new Date();

console.log(d);

d.setHours(0);

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.34

----

prototype.setUTCHours(hours : Number, [minutes : Number, [seconds : Number, [milliseconds : Number]]]) : Number

Sets the number of hours (and optionally minutes, seconds and milliseconds) of **this**.

The other time components remain unchanged.

<example>

var d = new Date();

console.log(d);

d.setUTCHours(0);

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.35

----

prototype.setDate(date : Number) : Number

Sets the date of **this**.

The other time components remain unchanged.

<example>

var d = new Date();

console.log(d);

d.setDate(1);

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.36

----

prototype.setUTCDate(date : Number) : Number

Sets the date of **this**.

The other time components remain unchanged.

<example>

var d = new Date();

console.log(d);

d.setUTCDate(1);

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.37

----

prototype.setMonth(month : Number, [date : Number]) : Number

Sets the month (and optionally date) of **this**.

Month 0 is January, 1 is February, etc.

The other time components remain unchanged.

<example>

var d = new Date();

console.log(d);

d.setMonth(0);

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.38

----

prototype.setUTCMonth(month : Number, [date : Number]) : Number

Sets the month (and optionally date) of **this**.

Month 0 is January, 1 is February, etc.

The other time components remain unchanged.

<example>

var d = new Date();

console.log(d);

d.setUTCMonth(0);

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.39

----

prototype.setFullYear(year : Number, [month : Number, [date : Number]]) : Number

Sets the year (and optionally month and date) of **this**.

The other time components remain unchanged.

<example>

var d = new Date();

console.log(d);

d.setFullYear(1980);

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.40

----

prototype.setUTCFullYear(year : Number, [month : Number, [date : Number]]) : Number

Sets the year (and optionally month and date) of **this**.

The other time components remain unchanged.

<example>

var d = new Date();

console.log(d);

d.setUTCFullYear(1980);

console.log(d);

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.41

----

prototype.toUTCString() : String

Returns a human readable string of **this** in UTC.

<example>

var d = new Date();

console.log(d.toUTCString());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.42

----

prototype.toISOString() : String

Returns a string representation if **this** in ISO 8601 format.

<example>

var d = new Date();

console.log(d.toISOString());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.43

----

prototype.toJSON() : String

Returns a string representation of **this** suitable for storage in JSON.

<example>

var d = new Date();

console.log(d.toJSON());

</example>

Spec:

http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.44