Date.prototype.getTime()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Date 實例的 getTime() 方法會回傳此日期從紀元（定義為 UTC 時間 1970 年 1 月 1 日的午夜）開始計算的毫秒數。

嘗試一下

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

// 從 1970 年 1 月 1 日 00:00:00.000 GMT 起算的毫秒數
console.log(moonLanding.getTime());
// 預期輸出：-14182940000

語法

js
getTime()

參數

無。

回傳值

一個數字，表示此日期的時間戳（以毫秒為單位）。如果日期是無效的，則回傳 NaN。

描述

Date 物件基本上是由一個時間戳表示，而此方法允許你取得該時間戳。你可以使用此方法來協助將日期和時間指派給另一個 Date 物件。此方法在功能上等同於 valueOf() 方法。

範例

使用 getTime() 複製日期

建立一個具有相同時間值的日期物件。

js
// 因為月份是從 0 開始計算，所以 birthday 會是 1995 年 1 月 10 日
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(`操作耗時 ${end.getTime() - start.getTime()} 毫秒`);

備註： 在支援 Performance API 高解析度時間功能的瀏覽器中，Performance.now() 比 Date.now() 能提供更可靠且更精確的經過時間測量。

規範

Specification
ECMAScript® 2026 Language Specification
# sec-date.prototype.gettime

瀏覽器相容性

參見