Temporal.Instant.prototype.subtract()

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

Если вы хотите вычесть два мгновения и получить длительность, используйте вместо этого since() или until().

Синтаксис

subtract(duration)

Параметры

duration

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

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

Новый объект Temporal.Instant, представляющий вычитание duration из этого мгновения. Если duration положительное, возвращаемое мгновение раньше этого мгновения; если duration отрицательное, возвращаемое мгновение позже этого мгновения.

Исключения

RangeError

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

• duration является календарной длительностью (имеет ненулевые years, months или weeks) или имеет ненулевой days, поскольку календарные длительности неоднозначны без календаря и временной ссылки.
• Результат выходит за пределы представимого диапазона, который составляет ±10⁸ дней, или примерно ±273 972,6 лет, от Unix epoch.

Описание

Вычитание длительности эквивалентно сложению ее отрицания, поэтому применимы все те же соображения.

Примеры

Вычитание Temporal.Duration

const instant = Temporal.Instant.fromEpochMilliseconds(1000);
const duration = Temporal.Duration.from("PT1S"); // One-second duration
const newInstant = instant.subtract(duration);
console.log(newInstant.epochMilliseconds); // 0

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

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

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

См. также

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