date.setTime

The setTime() method sets the Date object to the time represented by a number of milliseconds since January 1, 1970, 00:00:00 UTC.

Syntax

dateObj.setTime(timeValue)

Parameters

timeValue

An integer representing the number of milliseconds since 1 January 1970, 00:00:00 UTC.

Return value

The number of milliseconds between 1 January 1970 00:00:00 UTC and the updated date (effectively, the value of the argument).

Description

Use the setTime() method to help assign a date and time to another Date object.

Examples

Using setTime()

var theBigDay = new Date('July 1, 1999');
var sameAsBigDay = new Date();
sameAsBigDay.setTime(theBigDay.getTime());

Specifications

Specification	Status	Comment
ECMAScript 1st Edition (ECMA-262)	Standard	Initial definition. Implemented in JavaScript 1.0.
ECMAScript 5.1 (ECMA-262) The definition of 'Date.prototype.setTime' in that specification.	Standard
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Date.prototype.setTime' in that specification.	Standard
ECMAScript 2017 Draft (ECMA-262) The definition of 'Date.prototype.setTime' in that specification.	Draft

Browser compatibility

See also

• Date.prototype.getTime()
• Date.prototype.setUTCHours()