SQL Academy
Premium
Funktionsreferenz

TIMESTAMPADD

Addiert die angegebene Anzahl von Zeiteinheiten zu einem Datum.

MySQL 8.1
TIMESTAMPADD(unit, value, datetime)

Parameter

unitSchlüsselwort
Einheit des Intervalls
Werte:MICROSECONDSECONDMINUTEHOURDAYWEEKMONTHQUARTERYEAR
valueINT
Anzahl der Einheiten, kann negativ sein
datetimeDATETIME
Ausgangsdatum oder Datum mit Uhrzeit

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.1
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.1
SELECT TIMESTAMPADD(MONTH, 1, '2024-01-31') AS next_month;
next_month
2024-02-29

Negativer Wert

MySQL 8.1
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