Date.prototype.setUTCSeconds()

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

setUTCSeconds() 方法用於更改 Date 例項根據世界協調時(UTC)的秒和/或毫秒。

試一試

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

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

date.setUTCSeconds(39);

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

語法

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® 2026 語言規範
# sec-date.prototype.setutcseconds

瀏覽器相容性

另見