Temporal.PlainDateTime.prototype.toJSON()

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

Синтаксис

toJSON()

Параметры

Нет.

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

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

Описание

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

Примеры

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

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

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

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

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

См. также

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