Date.prototype.setHours()

基线 广泛可用

此功能已得到良好建立，并且可在许多设备和浏览器版本中使用。它自以下时间起在各个浏览器中可用 2015 年 7 月.

setHours() 方法是 Date 实例的方法，它根据本地时间更改此日期的小时、分钟、秒和/或毫秒。

试一试

语法

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

参数

hoursValue

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

minutesValue 可选

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

secondsValue 可选

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

msValue 可选

表示毫秒的 0 到 999 之间的整数。如果指定 msValue，则还必须指定 minutesValue 和 secondsValue。

返回值

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

描述

如果不指定 minutesValue、secondsValue 和 msValue 参数，则使用与 getMinutes()、getSeconds() 和 getMilliseconds() 返回的值相同的值。

如果指定的参数超出预期范围，则会相应地更新其他参数和 Date 对象中的日期信息。例如，如果为 secondsValue 指定 100，则分钟加 1（minutesValue + 1），秒使用 40。

示例

使用 setHours()

js
const theBigDay = new Date();
theBigDay.setHours(7);

规范

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

浏览器兼容性

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

另请参阅