Date.prototype.setUTCMilliseconds()

Baseline 已广泛支持

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

setUTCMilliseconds() 方法用于更改 Date 实例的毫秒值(根据通用时间)。

试一试

const date = new Date("2018-01-24T12:38:29.069Z");

console.log(date.getUTCMilliseconds());
// Expected output: 69

date.setUTCMilliseconds(420);

console.log(date.getUTCMilliseconds());
// Expected output: 420

语法

js
setUTCMilliseconds(millisecondsValue)

参数

millisecondsValue

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

返回值

此方法会就地修改 Date 对象,并返回其新的 时间戳。如果 millisecondsValueNaN(或被 强制转换为 NaN 的其他值,例如 undefined),则日期将设置为 Invalid Date,并返回 NaN

描述

如果提供的参数超出了预期的范围,setUTCMilliseconds() 会尝试相应地更新 Date 对象中的日期信息。例如,如果您为 millisecondsValue 指定 1100,则存储在 Date 对象中的秒数将增加 1,而毫秒数将使用 100。

示例

使用 setUTCMilliseconds()

js
const theBigDay = new Date();
theBigDay.setUTCMilliseconds(500);

规范

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

浏览器兼容性

另见