All Objects
Date Object
Date.setHours
METHOD: Date::setUTCHours
object.
setUTCHours
(hoursVal [, minutesVal, secondsVal, msVal])
This method is used to set the hours for the supplied date according to local time. If you do not supply the
minutesVal
and
secondsVal
and
msVal
arguments, JavaScript will use the values returned using the
getUTCMinutes
,
getUTCSeconds
and
getMilliseconds
methods. Also, if the supplied argument is outside the range expected, the
setUTCHours
method will alter the other parameters accordingly (see example below).
The available parameters are as follows:
hoursVal
- this value is an integer (0 thru 23) representing the hour.
minutesVal
- an integer (0 thru 59) representing the minutes.
secondsVal
- this value is an integer (0 thru 59) that represents the seconds. If you supply this parameter you also must supply
minutesVal
.
msVal
- this value is a number between 0 and 999 that represents milliseconds. If this value is supplied, you must also supply
minutesVal
and
secondsVal
.
The following code uses the
setUTCHours
method to change the value of the myDate object and also demonstrates how this method will adjust the other parameters if a value is supplied that exceeds the expected range. In this case the
minutesVal
supplied is 100 which causes the
hourVal
value to be incremented by 1. This is calculated thus:
100 - 60 (maximum expected value for minutes) = 40 (this increments
hoursVal
by one).
The result of this calculation (40) is then used for the
minutesVal
parameter.
Code:
myDate = new Date()
document.write(myDate +"<br>")
myDate.setUTCHours(15, 100)
document.write(myDate)
Output:
Fri Jul 9 13:47:32 UTC+0100 1999
Fri Jul 9 16:40:32 UTC+0100 1999
Copyright 1999-2001 by Infinite Software Solutions, Inc. All rights reserved.
Trademark Information