Core JavaScript 1.5 Reference:Global Objects:Date:setUTCHours

From MDC

Contents 1 Summary 2 Syntax 3 Parameters 4 Description 5 Examples 5.1 Example: Using setUTCHours 6 See Also

[edit] Summary

Sets the hour for a specified date according to universal time.

Method of Date
Implemented in:	JavaScript 1.3
ECMA Version:	ECMA-262

[edit] Syntax

setUTCHours(hoursValue[, minutesValue[, secondsValue[, msValue]]])

[edit] Parameters

hoursValue 

An integer between 0 and 23, representing the hour.

minutesValue 

An integer between 0 and 59, representing the minutes.

secondsValue 

An integer between 0 and 59, representing the seconds. If you specify the secondsValue parameter, you must also specify the minutesValue.

msValue 

A number between 0 and 999, representing the milliseconds. If you specify the msValue parameter, you must also specify the minutesValue and secondsValue.

[edit] Description

If you do not specify the minutesValue, secondsValue, and msValue parameters, the values returned from the getUTCMinutes, getUTCSeconds, and getUTCMilliseconds methods are used.

If a parameter you specify is outside of the expected range, setUTCHours attempts to update the date information in the Date object accordingly. For example, if you use 100 for secondsValue, the minutes will be incremented by 1 (min + 1), and 40 will be used for seconds.

[edit] Examples

[edit] Example: Using setUTCHours

theBigDay = new Date();
theBigDay.setUTCHours(8);

[edit] See Also

getUTCHours, setHours