Date.prototype.setUTCHours()
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 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 (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 (ECMA-262) Date.prototype.setUTCHours |
Living Standard |
浏览器兼容性
BCD tables only load in the browser
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.