SQL Academy
Premium
Funktionsreferenz

TIMESTAMPADD

Addiert die angegebene Anzahl von Zeiteinheiten zu einem Datum.

MySQL 8.4
TIMESTAMPADD(unit, value, datetime)
unit
Einheit des Intervalls
Schlüsselwort
MICROSECONDSECONDMINUTEHOURDAYWEEKMONTHQUARTERYEAR
value
Anzahl der Einheiten, kann negativ sein
INT
datetime
Ausgangsdatum oder Datum mit Uhrzeit
DATETIME

Rückgabewert

Datum, wenn zu einem Datum Tage oder größere Einheiten addiert werden, sonst Datum mit Uhrzeit; gibt es den Tag im Monat nicht, wird der letzte Tag des Monats verwendet

Beispiele

Drei Stunden zu einem Datum

MySQL 8.4
SELECT TIMESTAMPADD(HOUR, 3, '2022-12-05 10:37:22') AS shifted;
shifted
2022-12-05 13:37:22

Ein Monat zum 31. Januar

MySQL 8.4
SELECT TIMESTAMPADD(MONTH, 1, '2024-01-31') AS next_month;
next_month
2024-02-29

Negativer Wert

MySQL 8.4
SELECT TIMESTAMPADD(MINUTE, -90, '2022-12-05') AS shifted;
shifted
2022-12-04 22:30:00

Details

Anders als bei DATE_ADD steht die Einheit als erstes Argument, und zusammengesetzte Einheiten wie HOUR_MINUTE werden nicht unterstützt.

Siehe auch