Temporal.Instant.prototype.until()

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

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

Синтаксис

until(other)
until(other, options)

Параметры

other

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

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

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

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

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

Исключения

RangeError

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

Примеры

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

const launch = Temporal.Instant.fromEpochMilliseconds(2051222400000);
const now = Temporal.Now.instant();
const duration = now.until(launch, { smallestUnit: "minutes" });
console.log(`It will be ${duration.toLocaleString("en-US")} until the launch`);

Для получения дополнительных примеров см. since().

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

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

См. также

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