Temporal.Instant.prototype.toJSON()

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

Синтаксис

toJSON()

Параметры

Нет.

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

Строка, представляющая данный момент времени в формате RFC 9557, с точностью до долей секунды, необходимой для точного представления продолжительности, и с обозначением часового пояса UTC Z.

Описание

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

Примеры

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

const instant = Temporal.Instant.fromEpochMilliseconds(1627821296000);
const instantStr = instant.toJSON(); // '2021-08-01T12:34:56Z'
const i2 = Temporal.Instant.from(instantStr);

Сериализация и десериализация JSON

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

const instant = Temporal.Instant.fromEpochMilliseconds(1627821296000);
const jsonStr = JSON.stringify({ time: instant }); // '{"time":"2021-08-01T12:34:56Z"}'
const obj = JSON.parse(jsonStr, (key, value) => {
  if (key === "time") {
    return Temporal.Instant.from(value);
  }
  return value;
});

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

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

См. также

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