Temporal.PlainTime

Объект Temporal.PlainTime представляет время без даты или часового пояса; например, повторяющееся событие, которое происходит каждый день в одно и то же время. По сути, он представляется как комбинация значений часов, минут, секунд, миллисекунд, микросекунд и наносекунд.

Описание

PlainTime — это, по сути, временная часть объекта Temporal.PlainDateTime, из которой удалена информация о дате. Поскольку информация о дате и времени не имеет большого взаимодействия, вся общая информация о свойствах времени документирована здесь.

Формат RFC 9557

Объекты PlainTime могут быть сериализованы и разобраны с использованием формата RFC 9557, расширения формата ISO 8601 / RFC 3339. Строка имеет следующую форму:

HH:mm:ss.sssssssss

HH

Двузначное число от 00 до 23. Оно может предваряться обозначением времени T или t.

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

Двузначное число от 00 до 59. По умолчанию 00.

ss.sssssssss Необязательно

Двузначное число от 00 до 59. За ним может опционально следовать . или , и от одной до девяти цифр. По умолчанию 00. Компоненты HH, mm и ss могут быть разделены : или ничем. Вы можете опустить либо только ss, либо оба ss и mm, поэтому время может иметь одну из трех форм: HH, HH:mm или HH:mm:ss.sssssssss.

В качестве входных данных вы можете опционально включить дату, смещение, идентификатор часового пояса и календарь в том же формате, что и PlainDateTime, но они будут проигнорированы. Строка, содержащая только дату, будет отклонена. Другие аннотации в формате [key=value] также игнорируются, и они не должны иметь критический флаг.

При сериализации вы можете настроить количество цифр дробной части секунды.

Конструктор

Temporal.PlainTime()

Создает новый объект Temporal.PlainTime, напрямую предоставляя исходные данные.

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

Temporal.PlainTime.compare()

Возвращает число (-1, 0 или 1), указывающее, идет ли первое время перед вторым, совпадает ли оно с ним или идет после него. Эквивалентно пошаговому сравнению полей часов, минут, секунд, миллисекунд, микросекунд и наносекунд.

Temporal.PlainTime.from()

Создает новый объект Temporal.PlainTime из другого объекта Temporal.PlainTime, объекта со свойствами времени или строки в формате RFC 9557.

Свойства экземпляра

Эти свойства определены для Temporal.PlainTime.prototype и совместно используются всеми экземплярами Temporal.PlainTime.

Temporal.PlainTime.prototype.constructor

Конструктор, создавший объект экземпляра. Для экземпляров Temporal.PlainTime начальным значением является конструктор Temporal.PlainTime().

Temporal.PlainTime.prototype.hour

Возвращает целое число от 0 до 23, представляющее компонент часа этого времени.

Temporal.PlainTime.prototype.microsecond

Возвращает целое число от 0 до 999, представляющее компонент микросекунды (10^-6 секунды) этого времени.

Temporal.PlainTime.prototype.millisecond

Возвращает целое число от 0 до 999, представляющее компонент миллисекунды (10^-3 секунды) этого времени.

Temporal.PlainTime.prototype.minute

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

Temporal.PlainTime.prototype.nanosecond

Возвращает целое число от 0 до 999, представляющее компонент наносекунды (10^-9 секунды) этого времени.

Temporal.PlainTime.prototype.second

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

Temporal.PlainTime.prototype[Symbol.toStringTag]

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

Методы экземпляра

Temporal.PlainTime.prototype.add()

Возвращает новый объект Temporal.PlainTime, представляющий это время, сдвинутое вперед на заданную длительность (в форме, преобразуемой Temporal.Duration.from()), с переходом через полночь при необходимости.

Temporal.PlainTime.prototype.equals()

Возвращает true, если это время эквивалентно другому времени по значению (в форме, преобразуемой Temporal.PlainTime.from()), и false в противном случае. Они сравниваются по их временным значениям. Эквивалентно Temporal.PlainTime.compare(this, other) === 0.

Temporal.PlainTime.prototype.round()

Возвращает новый объект Temporal.PlainTime, представляющий это время, округленное до указанной единицы.

Temporal.PlainTime.prototype.since()

Возвращает новый объект Temporal.Duration, представляющий длительность от другого времени (в форме, преобразуемой Temporal.PlainTime.from()) до этого времени. Длительность положительна, если другое время идет перед этим временем, и отрицательна, если после.

Temporal.PlainTime.prototype.subtract()

Возвращает новый объект Temporal.PlainTime, представляющий это время, сдвинутое назад на заданную длительность (в форме, преобразуемой Temporal.Duration.from()), с переходом через полночь при необходимости.

Temporal.PlainTime.prototype.toJSON()

Возвращает строку, представляющую это время, в том же формате RFC 9557, что и при вызове toString(). Предназначен для неявного вызова JSON.stringify().

Temporal.PlainTime.prototype.toLocaleString()

Возвращает строку с локализованным представлением этого времени.

Temporal.PlainTime.prototype.toString()

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

Temporal.PlainTime.prototype.until()

Возвращает новый объект Temporal.Duration, представляющий длительность от этого времени до другого времени (в форме, преобразуемой Temporal.PlainTime.from()). Длительность положительна, если другое время идет после этого времени, и отрицательна, если перед ним.

Temporal.PlainTime.prototype.valueOf()

Выбрасывает TypeError, что предотвращает неявное преобразование экземпляров Temporal.PlainTime в примитивы при использовании в арифметических или сравнительных операциях.

Temporal.PlainTime.prototype.with()

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

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

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

См. также

• Temporal
• Temporal.Duration
• Temporal.PlainDateTime