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) на основі вихідного коду бібліотеки.