Temporal.PlainTime.prototype.toString()

Метод toString() экземпляров Temporal.PlainTime возвращает строку, представляющую это время в формате RFC 9557.

Синтаксис

toString()
toString(options)

Параметры

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

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

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

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

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

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

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

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

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

Строка в формате RFC 9557, представляющая это время.

Исключения

RangeError

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

TypeError

Выбрасывается, если options не является объектом или undefined.

Примеры

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

const time = Temporal.PlainTime.from("12:34:56");
console.log(time.toString()); // '12:34:56'

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

const time1 = Temporal.PlainTime.from("12:00:00");
console.log(time1.toString()); // '12:00:00'
console.log(time1.toString({ fractionalSecondDigits: 1 })); // '12:00:00.0'
console.log(time1.toString({ smallestUnit: "minute" })); // '12:00'
console.log(time1.toString({ smallestUnit: "nanosecond" })); // '12:00:00.000000000'

const time2 = Temporal.PlainTime.from("12:34:56.123456789");
console.log(time2.toString({ fractionalSecondDigits: 4 })); // '12:34:56.1234'
console.log(
  time2.toString({ fractionalSecondDigits: 4, roundingMode: "halfExpand" }),
); // '12:34:56.1235'

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

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

См. также

• Temporal.PlainTime
• Temporal.PlainTime.from()
• Temporal.PlainTime.prototype.toJSON()
• Temporal.PlainTime.prototype.toLocaleString()