offset

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

Un nouveau Date est renvoyé ; celui passé en argument reste intact. Un montant négatif recule.

Ajouter un mois conserve le quantième là où il existe et le ramène en fin de mois sinon : le 31 janvier plus un mois donne le 28 février, pas le 3 mars.

Paramètres

Paramètre	Type	Description
`date`	`Date`	La date à lire. Ce doit être un `Date` valide.
`amount`	`number`	De combien d'unités décaler. Un nombre négatif recule.
`unit`	`TimeUnit`	De `"millisecond"` à `"year"`, comme pour `diff`.

Valeur de retour

Date — une nouvelle date, décalée.

Exceptions

Exception	Condition
`IllegalArgumentException`	un argument n'est pas un `Date` valide.

Exemples

Décaler une 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

Voir aussi

Code source

src/time/offset.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.