Date.prototype.setHours()
The setHours()
method of Date
instances changes the hours, minutes, seconds, and/or milliseconds for this date according to local time.
Try it
Syntax
js
setHours(hoursValue)
setHours(hoursValue, minutesValue)
setHours(hoursValue, minutesValue, secondsValue)
setHours(hoursValue, minutesValue, secondsValue, msValue)
Parameters
hoursValue
-
An integer between 0 and 23 representing the hours.
minutesValue
Optional-
An integer between 0 and 59 representing the minutes.
secondsValue
Optional-
An integer between 0 and 59 representing the seconds. If you specify
secondsValue
, you must also specifyminutesValue
. msValue
Optional-
An integer between 0 and 999 representing the milliseconds. If you specify
msValue
, you must also specifyminutesValue
andsecondsValue
.
Return value
Changes the Date
object in place, and returns its new timestamp. If a parameter is NaN
(or other values that get coerced to NaN
, such as undefined
), the date is set to Invalid Date and NaN
is returned.
Description
If you do not specify the minutesValue
, secondsValue
, and msValue
parameters, the same values as what are returned by getMinutes()
, getSeconds()
, and getMilliseconds()
are used.
If a parameter you specify is outside of the expected range, other parameters and the date information in the Date
object are updated accordingly. For example, if you specify 100 for secondsValue
, the minutes are incremented by 1 (minutesValue + 1
), and 40 is used for seconds.
Examples
Using setHours()
js
const theBigDay = new Date();
theBigDay.setHours(7);
Specifications
Specification |
---|
ECMAScript Language Specification # sec-date.prototype.sethours |
Browser compatibility
BCD tables only load in the browser