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
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
See also
Document Tags and Contributors
Tags:
Contributors to this page:
eduardoboucas,
fscholz,
Mingun,
WP-Makyen,
Sheppy,
evilpie,
BradSpencer,
Ptak82,
Maian,
Dria
Last updated by:
eduardoboucas,