Temporal.PlainDate.prototype.toJSON()

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

toJSON() 方法是 Temporal.PlainDate 实例的一个方法,它返回一个字符串,表示该日期的格式与调用 toString() 时的 RFC 9557 格式相同。它旨在被 JSON.stringify() 隐式调用。

语法

js
toJSON()

参数

无。

返回值

一个表示给定日期的字符串,采用 RFC 9557 格式,如果日历注解不是 "iso8601",则包含日历注解。

描述

Temporal.PlainDate 对象被序列化为字符串时,toJSON() 方法会被 JSON.stringify() 自动调用。此方法通常旨在默认情况下有效地序列化 Temporal.PlainDate 对象,然后可以通过 Temporal.PlainDate.from() 函数作为 JSON.parse() 的 reviver 进行反序列化。

示例

使用 toJSON()

js
const date = Temporal.PlainDate.from({ year: 2021, month: 8, day: 1 });
const dateStr = date.toJSON(); // '2021-08-01'
const d2 = Temporal.PlainDate.from(dateStr);

JSON 序列化和解析

此示例演示了如何在无需额外工作的情况下将 Temporal.PlainDate 序列化为 JSON,以及如何将其解析回来。

js
const date = Temporal.PlainDate.from({ year: 2021, month: 8, day: 1 });
const jsonStr = JSON.stringify({ date }); // '{"date":"2021-08-01"}'
const obj = JSON.parse(jsonStr, (key, value) => {
  if (key === "date") {
    return Temporal.PlainDate.from(value);
  }
  return value;
});

规范

规范
Temporal
# sec-temporal.plaindate.prototype.tojson

浏览器兼容性

另见