Date.prototype.setUTCSeconds()

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

setUTCSeconds() 方法用于更改 Date 实例根据世界协调时(UTC)的秒和/或毫秒。

试一试

const date = new Date("December 31, 1975, 23:15:30 GMT+11:00");

console.log(date.getUTCSeconds());
// Expected output: 30

date.setUTCSeconds(39);

console.log(date.getUTCSeconds());
// Expected output: 39

语法

js
setUTCSeconds(secondsValue)
setUTCSeconds(secondsValue, msValue)

参数

secondsValue

一个介于 0 和 59 之间的整数,代表秒。

msValue 可选

一个介于 0 和 999 之间的整数,表示毫秒。

返回值

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

描述

如果您不指定 msValue 参数,则将使用从 getUTCMilliseconds() 方法返回的值。

如果指定的参数超出预期的范围,setUTCSeconds() 会尝试相应地更新 Date 对象中的日期信息。例如,如果您使用 100 作为 secondsValue,则 Date 对象中存储的分钟数将增加 1,秒数将设置为 40。

示例

使用 setUTCSeconds()

js
const theBigDay = new Date();
theBigDay.setUTCSeconds(20);

规范

规范
ECMAScript® 2026 语言规范
# sec-date.prototype.setutcseconds

浏览器兼容性

另见