The toJSON() method of Temporal.PlainDateTime instances returns a string representing this date-time in the same RFC 9557 format as calling Temporal/PlainDateTime/toString. It is intended to be implicitly called by JSON.stringify().
Syntax
toJSON()
Parameters
None.
Return value
A string representing the given date-time in the RFC 9557 format, with the calendar annotation included if it is not "iso8601".
Description
The method is automatically called by JSON.stringify() when a Temporal.PlainDateTime object is encountered during JSON serialization. The serialized value can then be deserialized using the Temporal/PlainDateTime/from function within the reviver of JSON.parse().
Examples
Using toJSON()
const dt = Temporal.PlainDateTime.from({ year: 2021, month: 8, day: 1 });
const dtStr = dt.toJSON(); // '2021-08-01T00:00:00'
const dt2 = Temporal.PlainDateTime.from(dtStr);
JSON serialization and parsing
This example shows how Temporal.PlainDateTime can be serialized as JSON without extra effort, and how to parse it back.
const dt = Temporal.PlainDateTime.from({ year: 2021, month: 8, day: 1 });
const jsonStr = JSON.stringify({ nextBilling: dt }); // '{"nextBilling":"2021-08-01T00:00:00"}'
const obj = JSON.parse(jsonStr, (key, value) => {
if (key === "nextBilling") {
return Temporal.PlainDateTime.from(value);
}
return value;
});
Specifications
Browser compatibility
See also
- Temporal.PlainDateTime
- Temporal/PlainDateTime/from
- Temporal/PlainDateTime/toString
- Temporal/PlainDateTime/toLocaleString
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
