Temporal.Duration.prototype.toString()

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

Синтаксис

toString()
toString(options)

Параметры

options Необязательно

Объект, содержащий некоторые или все из следующих свойств (в порядке их извлечения и проверки):

fractionalSecondDigits Необязательно

Либо целое число от 0 до 9, либо строка "auto". Значение по умолчанию — "auto". Если "auto", то конечные нули удаляются из дробных секунд. В противном случае дробная часть компонента секунд содержит это количество цифр, дополненных нулями или округленных по мере необходимости.

roundingMode Необязательно

Строка, определяющая, как округлять дробные цифры секунд сверх fractionalSecondDigits. См. Intl.NumberFormat(). По умолчанию используется "trunc".

smallestUnit Необязательно

Строка, определяющая наименьшую единицу измерения, которую следует включить в вывод. Возможные значения: "second", "millisecond", "microsecond" и "nanosecond", или их формы множественного числа, которые эквивалентны значениям fractionalSecondDigits: 0, 3, 6, 9, соответственно. Если указано, то fractionalSecondDigits игнорируется.

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

Строка, представляющая заданную продолжительность в формате ISO 8601, с компонентами субсекунд, отформатированными в соответствии с параметрами. Нулевая продолжительность представляется как "PT0S".

Исключения

RangeError

Выбрасывается, если какой-либо из параметров недействителен.

Примеры

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

const duration = Temporal.Duration.from({ hours: 1, minutes: 30, seconds: 15 });
console.log(duration.toString()); // 'PT1H30M15S'

// Stringification implicitly calls toString()
console.log(`${duration}`); // 'PT1H30M15S'

Использование параметров

const worldRecord = Temporal.Duration.from({ seconds: 9, milliseconds: 580 });
console.log(worldRecord.toString()); // 'PT9.58S'
console.log(worldRecord.toString({ fractionalSecondDigits: 1 })); // 'PT9.5S'
console.log(worldRecord.toString({ fractionalSecondDigits: 0 })); // 'PT9S'
console.log(worldRecord.toString({ smallestUnit: "millisecond" })); // 'PT9.580S'
console.log(
  worldRecord.toString({
    fractionalSecondDigits: 1,
    roundingMode: "halfExpand",
  }),
); // 'PT9.6S'

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

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

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

• Temporal.Duration
• Temporal.Duration.prototype.toJSON()
• Temporal.Duration.prototype.toLocaleString()