The setUTCHours() method sets the hour for a specified date according to universal time, and returns the number of milliseconds since 1 January 1970 00:00:00 UTC until the time represented by the updated Date instance.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Syntax
dateObj.setUTCHours(hoursValue[, minutesValue[, secondsValue[, msValue]]])
参数
-
hoursValue - 表示小时的整数,取值0到23之间。
-
minutesValue - 可选参数。表示分钟的整数,取值0到59之间。
-
secondsValue -
可选参数。表示秒数的整数,取值0到59之间。如果指定了该参数,就要同时指定
minutesValue这个参数。 -
msValue -
可选参数。表示毫秒的整数,取值0到999之间。如果指定了该参数,就要指定
minutesValue和secondsValue这两个参数。
返回值
返回从1970-01-01 00:00:00 UTC 到更新后的日期所表示时间的毫秒数。
描述
If you do not specify the minutesValue, secondsValue, and msValue parameters, the values returned from the 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 (minutesValue + 1), and 40 will be used for seconds.
例子
使用 setUTCHours()
var theBigDay = new Date(); theBigDay.setUTCHours(8);
规范
| Specification | Status | Comment |
|---|---|---|
| ECMAScript 1st Edition (ECMA-262) | Standard | Initial definition. Implemented in JavaScript 1.3. |
| ECMAScript 5.1 (ECMA-262) Date.prototype.setUTCHours |
Standard | |
| ECMAScript 2015 (6th Edition, ECMA-262) Date.prototype.setUTCHours |
Standard | |
| ECMAScript Latest Draft (ECMA-262) Date.prototype.setUTCHours |
Draft |
浏览器兼容性
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
| Desktop | Mobile | Server | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
setUTCHours |
Chrome Full support 1 | Edge Full support 12 | Firefox Full support 1 | IE Full support 4 | Opera Full support Yes | Safari Full support Yes | WebView Android Full support 1 | Chrome Android Full support 18 | Firefox Android Full support 4 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support 1.0 | nodejs Full support Yes |
Legend
- Full support
- Full support