Temporal.PlainDate.prototype.until()

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

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

Синтаксис

until(other)
until(other, options)

Параметры

other

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

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

Те же опции, что и since().

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

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

Исключения

RangeError

Выбрасывается в одном из следующих случаев:

• other имеет календарь, отличный от this.
• Любая из опций недействительна.

Примеры

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

const launch = Temporal.PlainDate.from("2035-01-01");
const now = Temporal.Now.plainDateISO();
const duration = now.until(launch);
console.log(`It will be ${duration.toLocaleString("en-US")} until the launch`);

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

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

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

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

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