大网数据广告活动
Web 标准与前端开发

Date.prototype.setUTCHours()

· 52CE 我爱测

Date 实例的 **`setUTCHours()`** 方法用于根据世界协调时更改日期对象的小时、分钟、秒或毫秒。

Date 实例的 setUTCHours() 方法用于根据世界协调时更改日期对象的小时、分钟、秒或毫秒。

JavaScript Demo: Date.setUTCHours()

const event = new Date("August 19, 1975 23:15:30 GMT-3:00");

console.log(event.toUTCString());
// Expected output: "Wed, 20 Aug 1975 02:15:30 GMT"

console.log(event.getUTCHours());
// Expected output: 2

event.setUTCHours(23);

console.log(event.toUTCString());
// Expected output: "Wed, 20 Aug 1975 23:15:30 GMT"

语法

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,则必须同时指定 minutesValue 和 secondsValue。

返回值

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

描述

如果你未指定 minutesValue、secondsValue 和 msValue 参数,那么将使用 Date/getUTCMinutes、Date/getUTCSeconds 和 Date/getUTCMilliseconds 方法返回的值。

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

示例

使用 setUTCHours()

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

规范

浏览器兼容性

参见

  • Date.prototype.getUTCHours()
  • Date.prototype.setHours()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。