Date.setSeconds()
Sets the seconds of a date object
The setSeconds() method sets the seconds for a specified date according to local time.
var event = new Date('August 19, 1975 23:15:30');
event.setSeconds(42);
console.log(event.getSeconds());
// expected output: 42
console.log(event);
// Sat Apr 19 1975 23:15:42 GMT+0100 (CET)
// (note: your timezone may vary)
Syntax
dateObj.setSeconds(secondsValue[, msValue])
Versions prior to JavaScript 1.3
dateObj.setSeconds(secondsValue)
Parameters
secondsValue
An integer between 0 and 59, representing the seconds.
msValue
Optional. A number between 0 and 999, representing the milliseconds.
Return value
The number of milliseconds between 1 January 1970 00:00:00 UTC and the updated date.
Description
If you do not specify the msValue
parameter, the value returned from the getMilliseconds()
method is used.
If a parameter you specify is outside of the expected range, setSeconds()
attempts to update the date information in the Date
object accordingly. For example, if you use 100 for secondsValue
, the minutes stored in the Date
object will be incremented by 1, and 40 will be used for seconds.
Examples
Using setSeconds()
setSeconds()
var theBigDay = new Date();
theBigDay.setSeconds(30);
References
Contributors to this page
Uros Durdevic
Last updated