Date.prototype.setUTCHours()

基线 广泛可用

此功能已得到良好建立,可在许多设备和浏览器版本上运行。它自以下时间起在浏览器中可用: 2015年7月.

setUTCHours()Date 实例的方法,它根据世界标准时间更改此日期的小时、分钟、秒和/或毫秒。

试一试

语法

js
setUTCHours(hoursValue)
setUTCHours(hoursValue, minutesValue)
setUTCHours(hoursValue, minutesValue, secondsValue)
setUTCHours(hoursValue, minutesValue, secondsValue, msValue)

参数

hoursValue

表示小时的 0 到 23 之间的整数。

minutesValue 可选

表示分钟的 0 到 59 之间的整数。

secondsValue 可选

表示秒的 0 到 59 之间的整数。如果指定 secondsValue,则还必须指定 minutesValue

msValue 可选

表示毫秒的 0 到 999 之间的整数。如果指定 msValue,则还必须指定 minutesValuesecondsValue

返回值

就地更改 Date 对象,并返回其新的 时间戳。如果参数为 NaN(或其他被 强制转换为 NaN 的值,例如 undefined),则日期将设置为 无效日期 并返回 NaN

描述

如果未指定 minutesValuesecondsValuemsValue 参数,则使用 getUTCMinutes()getUTCSeconds()getUTCMilliseconds() 方法返回的值。

如果指定的参数超出预期范围,则 setUTCHours() 会尝试相应地更新 Date 对象中的日期信息。例如,如果将 100 用于 secondsValue,则分钟将增加 1(minutesValue + 1),并将 40 用于秒。

示例

使用 setUTCHours()

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

规范

规范
ECMAScript 语言规范
# sec-date.prototype.setutchours

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅