Temporal.PlainDate.prototype.subtract()

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

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

Синтаксис

subtract(duration)
subtract(duration, options)

Параметры

duration

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

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

Объект, содержащий следующее свойство:

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

Строка, указывающая поведение, когда компонент даты выходит за пределы диапазона. Возможные значения:

"constrain" (по умолчанию)

Компонент даты приводится к допустимому диапазону.

"reject"

Генерируется RangeError, если компонент даты выходит за пределы диапазона.

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

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

Описание

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

Исключения

RangeError

Генерируется, если результат не находится в представимом диапазоне, который составляет ±(10⁸ + 1) дней, или около ±273 972,6 лет, от эпохи Unix.

Примеры

Вычитание длительности

const start = Temporal.PlainDate.from("2022-01-01");
const end = start.subtract({ years: 1, months: 2, weeks: 3, days: 4 });
console.log(end.toString()); // 2020-10-07

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

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

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

Смотри также

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