Temporal.PlainYearMonth.prototype.toJSON()

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

Синтаксис

toJSON()

Параметры

Нет.

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

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

Описание

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

Примеры

Использование toJSON()

const ym = Temporal.PlainYearMonth.from({ year: 2021, month: 8 });
const ymStr = ym.toJSON(); // '2021-08'
const ym2 = Temporal.PlainYearMonth.from(ymStr);

Сериализация и разбор JSON

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

const ym = Temporal.PlainYearMonth.from({ year: 2021, month: 8 });
const ymStr = JSON.stringify({ event: ym }); // '{"event":"2021-08"}'
const obj = JSON.parse(ymStr, (key, value) => {
  if (key === "event") {
    return Temporal.PlainYearMonth.from(value);
  }
  return value;
});

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

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

См. также

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