The setHours()
method of Date
instances changes the hours, minutes, seconds, and/or milliseconds for this date according to local time.
The setHours()
method of Date
instances changes the hours, minutes, seconds, and/or milliseconds for this date according to local time.
setHours(hoursValue) setHours(hoursValue, minutesValue) setHours(hoursValue, minutesValue, secondsValue) setHours(hoursValue, minutesValue, secondsValue, msValue)
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 specify minutesValue
.
msValue
Optional
An integer between 0 and 999 representing the milliseconds. If you specify msValue
, you must also specify minutesValue
and secondsValue
.
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.
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.
const theBigDay = new Date(); theBigDay.setHours(7);
Desktop | Mobile | Server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | WebView Android | Deno | Node.js | ||
setHours |
1 | 12 | 1 | 3 | 1 | 18 | 4 | 10.1 | 1 | 1.0 | 4.4 | 1.0 | 0.10.0 |
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/setHours