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

浏览器兼容性

另见