Temporal.PlainTime.prototype.until()

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

Этот метод выполняет other - this. Чтобы выполнить this - other, используйте метод since().

Синтаксис

until(other)
until(other, options)

Параметры

other

Строка, объект или экземпляр Temporal.PlainTime, представляющий время, из которого вычитается текущее время. Он преобразуется в объект Temporal.PlainTime с использованием того же алгоритма, что и Temporal.PlainTime.from(). Он должен иметь тот же календарь, что и this.

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

Те же параметры, что и у since().

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

Новый объект Temporal.Duration, представляющий длительность от текущего времени до other. Длительность положительна, если other позже текущего времени, и отрицательна, если раньше.

Исключения

RangeError

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

Примеры

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

const lunchTime = Temporal.PlainTime.from("12:30:00");
const now = Temporal.Now.plainTimeISO();
const duration = now.until(lunchTime);
console.log(`It will be ${duration.toLocaleString("en-US")} until lunch`);
// Example output: "It will be 3 hr, 42 min, 21 sec, 343 ms, 131 μs, 718 ns until lunch"

Дополнительные примеры см. в since().

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

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

См. также

• Temporal.PlainTime
• Temporal.Duration
• Temporal.PlainTime.prototype.add()
• Temporal.PlainTime.prototype.subtract()
• Temporal.PlainTime.prototype.since()