Date.prototype.toISOString()

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

toISOString() 方法用于 Date 实例,返回一个字符串,该字符串表示此日期符合 日期时间字符串格式。这是一种基于 ISO 8601简化格式,长度始终为 24 或 27 个字符(分别是 YYYY-MM-DDTHH:mm:ss.sssZ±YYYYYY-MM-DDTHH:mm:ss.sssZ)。时区始终是 UTC,用后缀 Z 表示。

试一试

const event = new Date("05 October 2011 14:48 UTC");
console.log(event.toString());
// Expected output: "Wed Oct 05 2011 16:48:00 GMT+0200 (CEST)"
// Note: your timezone may vary

console.log(event.toISOString());
// Expected output: "2011-10-05T14:48:00.000Z"

语法

js
toISOString()

参数

无。

返回值

根据通用时间,返回一个表示给定日期的日期时间字符串格式的字符串。它与 Date.parse() 需要识别的格式相同。

异常

RangeError

如果日期 无效,或者它对应的年份无法在日期字符串格式中表示,则抛出该错误。

示例

使用 toISOString()

js
const d = new Date(0);

console.log(d.toISOString()); // "1970-01-01T00:00:00.000Z"

规范

规范
ECMAScript® 2026 语言规范
# sec-date.prototype.toisostring

浏览器兼容性

另见