The setHours()
method of Date instances changes the hours, minutes, seconds, and/or milliseconds for this date according to local time.
Syntax
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
- : An integer between 0 and 59 representing the minutes.
secondsValue
- : An integer between 0 and 59 representing the seconds. If you specify
secondsValue
, you must also specifyminutesValue
.
- : An integer between 0 and 59 representing the seconds. If you specify
msValue
- : An integer between 0 and 999 representing the milliseconds. If you specify
msValue
, you must also specifyminutesValue
andsecondsValue
.
- : An integer between 0 and 999 representing the milliseconds. If you specify
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()
const theBigDay = new Date();
theBigDay.setHours(7);