Temporal.Duration.prototype.subtract()

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

Синтаксис

subtract(other)

Параметры

other

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

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

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

Исключения

RangeError

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

• Либо this, либо other является календарной длительностью (имеет ненулевое значение years, months или weeks), поскольку календарные длительности неоднозначны без календаря и ссылки на время.
• Разница между this и other превышает максимальную или опускается ниже минимальной представимой длительности, которая составляет ±2⁵³ секунд.

Примеры

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

const d1 = Temporal.Duration.from({ hours: 1, minutes: 30 });
const d2 = Temporal.Duration.from({ hours: -1, minutes: -20 });

const d3 = d1.subtract(d2);
console.log(d3.toString()); // "PT2H50M"

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

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

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

См. также

• Temporal.Duration
• Temporal.Duration.prototype.add()
• Temporal.Duration.prototype.negated()