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

浏览器兼容性

另见