Temporal.ZonedDateTime.prototype.until()

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

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

Синтаксис

until(other)
until(other, options)

Параметры

other

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

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

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

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

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

Исключения

RangeError

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

• У other календарь отличается от календаря this.
• Недопустимо любое из значений параметров.
• У other часовой пояс отличается от часового пояса this, а largestUnit равен "days" или больше.

Примеры

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

const flight = Temporal.ZonedDateTime.from(
  "2024-12-21T13:31:00-05:00[America/New_York]",
);
const now = Temporal.Now.zonedDateTimeISO("America/New_York").round("second");
if (Temporal.ZonedDateTime.compare(flight, now) < 0) {
  console.error(
    "The flight is already in the past. The result may not make sense.",
  );
}
const duration = now.until(flight, { largestUnit: "days" });
console.log(`The flight is in ${duration.toLocaleString("en-US")}`);

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

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

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

См. также

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