Date.prototype.setUTCHours()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
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"
语法
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，则必须同时指定minutesValue和secondsValue。
返回值
该方法会原地修改 Date 对象，并返回其新的时间戳。如果参数为 NaN（或其他会被强制转换为 NaN 的值，例如 undefined），则日期会被设置为无效日期，并返回 NaN。
描述
如果你未指定 minutesValue、secondsValue 和 msValue 参数，那么将使用 getUTCMinutes()、getUTCSeconds() 和 getUTCMilliseconds() 方法返回的值。
如果你指定的参数超出了预期范围，setUTCHours() 会尝试相应地更新 Date 对象中的日期信息。例如，如果你将 secondsValue 设置为 100，分钟数将增加 1（minutesValue + 1），而秒数将变为 40。
示例
使用 setUTCHours()
js
const theBigDay = new Date();
theBigDay.setUTCHours(8);
规范
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.setutchours |
浏览器兼容性
Loading…