offset

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

Zurück kommt ein neues Date; das übergebene bleibt unberührt. Ein negativer Betrag verschiebt rückwärts.

Ein Monat weiter behält den Monatstag, wo es ihn gibt, und zieht ihn sonst ans Monatsende: der 31. Januar plus ein Monat ist der 28. Februar, nicht der 3. März.

Parameter

Parameter	Typ	Beschreibung
`date`	`Date`	Das zu lesende Datum. Es muss ein gültiges `Date` sein.
`amount`	`number`	Um wie viele Einheiten verschoben wird. Negativ heißt rückwärts.
`unit`	`TimeUnit`	Von `"millisecond"` bis `"year"`, wie bei `diff`.

Rückgabewert

Date — ein neues, verschobenes Datum.

Ausnahmen

Ausnahme	Bedingung
`IllegalArgumentException`	ein Argument ist kein gültiges `Date`.

Beispiele

Ein Datum verschieben

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

Siehe auch

Quellcode

src/time/offset.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.