Temporal.ZonedDateTime.prototype.toJSON()

main Documentación oficial Licencia CC-BY-SA-2.5Descargado el 2026-08-02

En esta página

Syntax#
Parameters#
Return value#
Description#
Examples#
Using toJSON()#
JSON serialization and parsing#
Specifications#
Browser compatibility#
See also#

The toJSON() method of {{jsxref("Temporal.ZonedDateTime")}} instances returns a string representing this date-time in the same RFC 9557 format as calling {{jsxref("Temporal/ZonedDateTime/toString", "toString()")}}. It is intended to be implicitly called by {{jsxref("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", and the offset and time zone annotation always included.

Description#

The toJSON() method is automatically called by {{jsxref("JSON.stringify()")}} when a Temporal.ZonedDateTime object is stringified. This method is generally intended to, by default, usefully serialize Temporal.ZonedDateTime objects during JSON serialization, which can then be deserialized using the {{jsxref("Temporal/ZonedDateTime/from", "Temporal.ZonedDateTime.from()")}} function as the reviver of {{jsxref("JSON.parse()")}}.

Examples#

Using toJSON()#

const zdt = Temporal.ZonedDateTime.from({
  year: 2021,
  month: 8,
  day: 1,
  timeZone: "America/New_York",
});
const zdtStr = zdt.toJSON(); // '2021-08-01T00:00:00-04:00[America/New_York]'
const zdt2 = Temporal.ZonedDateTime.from(zdtStr);

JSON serialization and parsing#

This example shows how Temporal.ZonedDateTime can be serialized as JSON without extra effort, and how to parse it back.

const zdt = Temporal.ZonedDateTime.from({
  year: 2021,
  month: 8,
  day: 1,
  timeZone: "America/New_York",
});
const jsonStr = JSON.stringify({ meeting: zdt }); // '{"meeting":"2021-08-01T00:00:00-04:00[America/New_York]"}'
const obj = JSON.parse(jsonStr, (key, value) => {
  if (key === "meeting") {
    return Temporal.ZonedDateTime.from(value);
  }
  return value;
});