Temporal.Instant.prototype.toString()

Метод toString() экземпляров Temporal.Instant возвращает строку, представляющую этот момент времени в формате 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 игнорируется.

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

Строка или экземпляр Temporal.ZonedDateTime, представляющий используемую временную зону. Если это экземпляр Temporal.ZonedDateTime, используется его временная зона. Если это строка, она может быть именованным идентификатором временной зоны, идентификатором временной зоны со смещением или строкой даты-времени, содержащей идентификатор временной зоны или смещение (см. временные зоны и смещения для получения дополнительной информации). По умолчанию "UTC".

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

Строка в формате RFC 9557, представляющая этот момент времени с использованием указанной временной зоны. Аннотации, такие как названия временных зон, не включаются.

Исключения

RangeError

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

Примеры

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

const instant = Temporal.Instant.fromEpochMilliseconds(1627814412345);
console.log(instant.toString()); // '2021-08-01T10:40:12.345Z'

// Stringification implicitly calls toString()
console.log(`${instant}`); // '2021-08-01T10:40:12.345Z'

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

const instant = Temporal.Instant.fromEpochMilliseconds(1627814412345);
console.log(instant.toString({ fractionalSecondDigits: 1 })); // '2021-08-01T10:40:12.3Z'
console.log(instant.toString({ smallestUnit: "minute" })); // '2021-08-01T10:40Z'
console.log(instant.toString({ timeZone: "America/New_York" })); // '2021-08-01T06:40:12.345-04:00'

// The time zone name automatically resolves to the correct offset
// based on the instant; for example, America/New_York is UTC-4 in summer,
// but UTC-5 in winter.
const instant2 = Temporal.Instant.fromEpochMilliseconds(1577836800000);
console.log(instant2.toString({ timeZone: "UTC" })); // '2029-12-31T23:00:00Z'
console.log(instant2.toString({ timeZone: "America/New_York" })); // '2019-12-31T19:00:00-05:00'

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

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

См. также

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