Date.prototype.getTime()

Baseline 已廣泛支援

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

getTime() 方法用於 Date 例項,返回自 紀元(定義為 UTC 1970 年 1 月 1 日午夜)以來的毫秒數。

試一試

const moonLanding = new Date("July 20, 69 20:17:40 GMT+00:00");

// Milliseconds since Jan 1, 1970, 00:00:00.000 GMT
console.log(moonLanding.getTime());
// Expected output: -14182940000

語法

js
getTime()

引數

無。

返回值

一個數字,表示此日期的 時間戳(以毫秒為單位)。如果日期 無效,則返回 NaN

描述

Date 物件根本上由一個 時間戳 表示,而此方法允許您檢索該時間戳。您可以使用此方法將日期和時間分配給另一個 Date 物件。此方法在功能上等同於 valueOf() 方法。

示例

使用 getTime() 複製日期

使用相同的時間值構造日期物件。

js
// Since month is zero based, birthday will be January 10, 1995
const birthday = new Date(1994, 12, 10);
const copy = new Date();
copy.setTime(birthday.getTime());

測量執行時間

對新生成的 Date 物件進行兩次連續的 getTime() 呼叫,然後相減,即可得到兩次呼叫之間的時間跨度。這可用於計算某些操作的執行時間。另請參閱 Date.now(),以避免例項化不必要的 Date 物件。

js
let end, start;

start = new Date();
for (let i = 0; i < 1000; i++) {
  Math.sqrt(i);
}
end = new Date();

console.log(`Operation took ${end.getTime() - start.getTime()} msec`);

注意: 在支援 Performance API 的高解析度時間功能的瀏覽器中,Performance.now() 可以比 Date.now() 提供更可靠、更精確的經過時間測量。

規範

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

瀏覽器相容性

另見