此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Date.prototype.setUTCSeconds()

基线 广泛可用

自 2015年7月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

setUTCSeconds() 方法为一个依据国际通用时间的特定日期设置秒数。

尝试一下

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

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

date1.setUTCSeconds(39);

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

语法

dateObj.setUTCSeconds(secondsValue[, msValue])

参数

secondsValue

一个在 0 到 59 之间的整数,表示秒数。

msValue

可选参数。一个 0 到 999 之间的数字,代表毫秒数。

返回值

一个毫秒数,表示从国际通用时间 1970 年 00:00:00 到设置的时间值之间的时间跨度。

描述

如果你没有设置 msValue 参数的值,那么返回的值来自getUTCMilliseconds() 方法。

如果你指定的值超出了范围,setUTCSeconds() 因此会更新Date 对象中 date 的相关信息 . 举个例子,如果你设置 secondsValue 为 100, Date 对象中的分钟数会增加 1,并且秒数会变成 40.

示例

使用 setUTCSeconds()

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

规范

规范
ECMAScript® 2027 Language Specification
# sec-date.prototype.setutcseconds

浏览器兼容性

参见