Temporal.ZonedDateTime.prototype.toJSON()

Метод toJSON() экземпляров Temporal.ZonedDateTime возвращает строку, представляющую эту дату-время в том же формате RFC 9557, что и при вызове toString(). Он предназначен для неявного вызова JSON.stringify().

Синтаксис

toJSON()

Параметры

Нет.

Возвращаемое значение

Строка, представляющая данную дату-время в формате RFC 9557, с включенной аннотацией календаря, если она не "iso8601", и с всегда включенной аннотацией смещения и часового пояса.

Описание

Метод toJSON() автоматически вызывается JSON.stringify() при сериализации объекта Temporal.ZonedDateTime в строку. Этот метод, как правило, предназначен для полезной сериализации объектов Temporal.ZonedDateTime по умолчанию во время сериализации JSON, которая затем может быть десериализована с использованием функции Temporal.ZonedDateTime.from() в качестве обработчика для JSON.parse().

Примеры

Использование 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

Этот пример показывает, как Temporal.ZonedDateTime может быть сериализован как JSON без дополнительных усилий, и как его разобрать обратно.

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;
});

Спецификации

Совместимость с браузерами

См. также

• Temporal.ZonedDateTime
• Temporal.ZonedDateTime.from()
• Temporal.ZonedDateTime.prototype.toString()
• Temporal.ZonedDateTime.prototype.toLocaleString()