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

瀏覽器相容性

另見