Date.prototype.setTime()

Baseline 已廣泛支援

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

setTime() 方法用於更改 Date 例項的時間戳。時間戳是指自紀元(定義為 UTC 時間 1970 年 1 月 1 日午夜)以來的毫秒數。

試一試

const launchDate = new Date("July 1, 1999, 12:00:00");
const futureDate = new Date();
futureDate.setTime(launchDate.getTime());

console.log(futureDate);
// Expected output: "Thu Jul 01 1999 12:00:00 GMT+0200 (CEST)"

const fiveMinutesInMs = 5 * 60 * 1000;
futureDate.setTime(futureDate.getTime() + fiveMinutesInMs);

console.log(futureDate);
// Expected output: "Thu Jul 01 1999 12:05:00 GMT+0200 (CEST)"
// Note: your timezone may vary

語法

js
setTime(timeValue)

引數

timeValue

一個整數,表示新的時間戳——自 UTC 時間 1970 年 1 月 1 日午夜以來的毫秒數。

返回值

該方法會就地修改 Date 物件,並返回其新的時間戳。如果 timeValueNaN(或被強制轉換NaN 的其他值,例如 undefined),則日期將被設定為無效日期,並返回 NaN

示例

使用 setTime()

js
const theBigDay = new Date("1999-07-01");
const sameAsBigDay = new Date();
sameAsBigDay.setTime(theBigDay.getTime());

規範

規範
ECMAScript® 2026 語言規範
# sec-date.prototype.settime

瀏覽器相容性

另見