Date.prototype.setMilliseconds()

試一試

const event = new Date("August 19, 1975 23:15:30");

console.log(event.getMilliseconds());
// Expected output: 0

event.setMilliseconds(456);

console.log(event.getMilliseconds());
// Expected output: 456

語法

setMilliseconds(millisecondsValue)

引數

millisecondsValue

一個介於 0 和 999 之間的整數，表示毫秒。

返回值

該方法會就地修改 Date 物件，並返回其新的 時間戳。如果 millisecondsValue 是 NaN（或任何會被 強制轉換為 NaN 的值，例如 undefined），則日期將被設定為 無效日期，並返回 NaN。

描述

如果您指定的值超出預期範圍，`Date` 物件中的日期資訊將相應更新。例如，如果您指定 1005，秒數將增加 1，毫秒數將是 5。

由於 setMilliseconds() 操作的是本地時間，因此在跨越夏令時（DST）邊界時，可能會導致實際經過的時間與預期不符。例如，如果設定毫秒值跨越了春季向前調整（丟失一小時），則新舊日期之間的時間戳差異將比名義時間差少一小時。反之，如果跨越了秋季向後調整（增加一小時），則會多出一個小時。如果您需要按固定時間量調整日期，請考慮使用 setUTCMilliseconds() 或 setTime()。

如果新的本地時間落在偏移量轉換範圍內，則確切時間將使用與 Temporal 的 disambiguation: "compatible" 選項相同的行為來確定。也就是說，如果本地時間對應兩個瞬間，則選擇較早的那個；如果本地時間不存在（存在間隙），則向前推進間隙持續的時間。

示例

使用 setMilliseconds()

const theBigDay = new Date();
theBigDay.setMilliseconds(100);

規範

瀏覽器相容性

另見

• Date.prototype.getMilliseconds()
• Date.prototype.setUTCMilliseconds()