Temporal.PlainYearMonth.prototype.until()

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

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

Синтаксис

until(other)
until(other, options)

Параметры

other

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

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

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

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

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

Исключения

RangeError

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

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

Примеры

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

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

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

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

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

См. также

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