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 |
浏览器兼容性
加载中…