Temporal.Duration.prototype.toJSON()

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

Синтаксис

toJSON()

Параметры

Нет.

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

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

Описание

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

Примеры

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

const duration = Temporal.Duration.from({ hours: 1, minutes: 30, seconds: 15 });
const durationStr = duration.toJSON(); // 'PT1H30M15S'
const d2 = Temporal.Duration.from(durationStr);

JSON-сериализация и парсинг

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

const duration = Temporal.Duration.from({ hours: 1, minutes: 30, seconds: 15 });
const jsonStr = JSON.stringify({ data: duration }); // '{"data":"PT1H30M15S"}'
const obj = JSON.parse(jsonStr, (key, value) => {
  if (key === "data") {
    return Temporal.Duration.from(value);
  }
  return value;
});

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

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

Смотрите также

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