Temporal.Now

Объект пространства имен Temporal.Now содержит статические методы для получения текущего времени в различных форматах.

Описание

В отличие от большинства глобальных объектов, Temporal.Now не является конструктором. Вы не можете использовать его с оператором new или вызывать объект Temporal.Now как функцию. Все свойства и методы Temporal.Now являются статическими (так же как объект Math).

По сути, системное время возвращается операционной системой как время, прошедшее с начала эпохи Unix. Temporal.Now.instant() возвращает это время в виде объекта Temporal.Instant. Хотя этот объект может представлять наносекунды, разрешение текущего времени зависит от системных часов и настроек браузера.

Момент времени может быть интерпретирован в часовом поясе (который по умолчанию является системным часовым поясом Temporal.Now.timeZoneId()) таким же образом, как и Temporal.Instant.prototype.toZonedDateTimeISO(). Чтобы получить объект Temporal.ZonedDateTime, вы можете использовать Temporal.Now.zonedDateTimeISO(). Вы также можете получить различные части даты и времени, используя Temporal.Now.plainDateISO(), Temporal.Now.plainTimeISO() и Temporal.Now.plainDateTimeISO().

Например, если на компьютере установлен часовой пояс "America/New_York", Temporal.Now.zonedDateTimeISO() возвращает зонированное время-дату, похожее на: 2021-08-01T10:40:12.345-04:00[America/New_York]. В этом случае Temporal.Now.plainTimeISO() вернет часть времени этой зонированной даты-времени: 10:40:12.345. Однако, если вы вызовете Temporal.Now.plainTimeISO("UTC"), он вернет часть времени зонированной даты-времени в часовом поясе UTC: 14:40:12.345. Это особенно полезно для межсистемного взаимодействия, когда другая сторона может ожидать время в другом часовом поясе.

Пониженная точность времени

Для защиты от атак по времени и сбора информации о системе (fingerprinting) точность текущего времени, возвращаемого методами Temporal.Now, может быть снижена в зависимости от настроек браузера.

В Chrome интервал округления составляет 0,1 мс или 0,005 мс в изолированных кросс-доменных контекстах.

В Firefox эти методы получают текущее время так же, как Date.now(). Они наследуют точность этого считывания времени без внесения дополнительной неточности. Временная метка всегда является целым числом миллисекунд, поэтому ее разрешение ограничено 1 мс во всех контекстах. Доступ к epochNanoseconds не увеличивает ее точность.

Статические свойства

Temporal.Now[Symbol.toStringTag]

Начальное значение свойства [Symbol.toStringTag] — это строка "Temporal.Now". Это свойство используется в Object.prototype.toString().

Статические методы

Temporal.Now.instant()

Возвращает текущее время в виде объекта Temporal.Instant.

Temporal.Now.plainDateISO()

Возвращает текущую дату в виде объекта Temporal.PlainDate, в календаре ISO 8601 и указанном часовом поясе.

Temporal.Now.plainDateTimeISO()

Возвращает текущие дату и время в виде объекта Temporal.PlainDateTime, в календаре ISO 8601 и указанном часовом поясе.

Temporal.Now.plainTimeISO()

Возвращает текущее время в виде объекта Temporal.PlainTime, в указанном часовом поясе.

Temporal.Now.timeZoneId()

Возвращает идентификатор часового пояса, представляющий текущий часовой пояс системы.

Temporal.Now.zonedDateTimeISO()

Возвращает текущие дату и время в виде объекта Temporal.ZonedDateTime, в календаре ISO 8601 и указанном часовом поясе.

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

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

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

• Temporal
• Temporal.Instant
• Temporal.PlainDate
• Temporal.PlainDateTime
• Temporal.PlainTime
• Temporal.ZonedDateTime