offset

function offset(date: Date, amount: number, unit: TimeUnit): Date;

Возвращается новый Date, переданный остаётся нетронутым. Отрицательное количество сдвигает назад.

Прибавление месяца сохраняет день месяца, если он существует, и подтягивает его к концу месяца, если нет: 31 января плюс месяц — это 28 февраля, а не 3 марта.

Параметры

Параметр	Тип	Описание
`date`	`Date`	Дата, которую читаем. Должна быть корректным `Date`.
`amount`	`number`	На сколько единиц сдвигать. Отрицательное значение — назад.
`unit`	`TimeUnit`	От `"millisecond"` до `"year"`, как у `diff`.

Возвращает

Date — новая, сдвинутая дата.

Исключения

Исключение	Условие
`IllegalArgumentException`	аргумент не является корректным `Date`.

Примеры

Сдвиг даты

const start = new Date(2026, 0, 31);

offset(start, 1, "month"); // 28 February 2026 — the day is clamped
offset(start, -1, "day"); // 30 January 2026

Смотрите также

Исходный код

src/time/offset.ts

23 September 2026

Эта документация сгенерирована нейросетью (Claude) на основе исходного кода библиотеки.