Date.prototype.setUTCSeconds()

基线 广泛可用

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

setUTCSeconds() 方法是 Date 实例的方法,它根据世界标准时间更改此日期的秒数和/或毫秒数。

试一试

语法

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 语言规范
# sec-date.prototype.setutcseconds

浏览器兼容性

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

另请参阅