Temporal.PlainDateTime.prototype.toString()

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

Синтаксис

toString()
toString(options)

Параметры

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

Объект, содержащий следующие свойства:

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

Нужно ли отображать аннотацию календаря ([u-ca=calendar_id]) в возвращаемом значении. Возможные значения:

"auto" (по умолчанию)

Включить аннотацию календаря, если календарь не является "iso8601".

"always"

Всегда включать аннотацию календаря.

"never"

Никогда не включать аннотацию календаря. Из-за этого возвращаемую строку нельзя восстановить до того же экземпляра Temporal.PlainDateTime, хотя значение даты остается прежним.

"critical"

Всегда включать аннотацию календаря и добавлять критический флаг: [!u-ca=calendar_id]. Полезно при отправке строки в определенные системы, но бесполезно для самого Temporal.

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 dt = Temporal.PlainDateTime.from("2021-08-01T12:34:56");
console.log(dt.toString()); // '2021-08-01T12:34:56'

Примеры округления времени см. в Temporal.PlainTime.prototype.toString(). Примеры отображения календарей см. в Temporal.PlainDate.prototype.toString().

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

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

См. также

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