SQL Academy
Premium
Funktionsreferenz

ADDDATE

Addiert ein Zeitintervall oder eine Anzahl von Tagen zu einem Datum.

MySQL 8.1
ADDDATE(date, INTERVAL expr unit | days)

Parameter

dateDATE
Ausgangsdatum oder Datum mit Uhrzeit
INTERVAL expr unitSchlüsselwort
Zu addierendes Intervall: Anzahl expr und Einheit unit, zum Beispiel INTERVAL 7 DAY
Werte:MICROSECONDSECONDMINUTEHOURDAYWEEKMONTHQUARTERYEARSECOND_MICROSECONDMINUTE_MICROSECONDMINUTE_SECONDHOUR_MICROSECONDHOUR_SECONDHOUR_MINUTEDAY_MICROSECONDDAY_SECONDDAY_MINUTEDAY_HOURYEAR_MONTH
daysINT
Anzahl der Tage als Kurzform statt INTERVAL

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

Zehn Tage zu einem Datum

MySQL 8.1
SELECT ADDDATE('2022-06-16', INTERVAL 10 DAY) AS new_date;
new_date
2022-06-26

Kurzform mit Tagen

MySQL 8.1
SELECT ADDDATE('2022-06-16', 10) AS new_date;
new_date
2022-06-26

Zusammengesetzte Intervalleinheit

MySQL 8.1
SELECT ADDDATE(
		'2022-06-16 10:00:00',
		INTERVAL '1:30' HOUR_MINUTE
	) AS new_date;
new_date
2022-06-16 11:30:00

Details

Statt der Funktion kannst du ein Intervall auch mit einem Operator addieren oder subtrahieren: date + INTERVAL 7 DAY. In PostgreSQL gibt es diese Funktion nicht: Ein Datum wird dort mit demselben Operator verschoben, aber das Intervall wird als String geschrieben: date + INTERVAL '7 days'.

Zusammengesetzte EinheitFormat des Strings exprBeispiel
SECOND_MICROSECONDSekunden.Mikrosekunden'10.000500'
MINUTE_MICROSECONDMinuten:Sekunden.Mikrosekunden'5:10.000500'
MINUTE_SECONDMinuten:Sekunden'5:10'
HOUR_MICROSECONDStunden:Minuten:Sekunden.Mikrosekunden'2:05:10.000500'
HOUR_SECONDStunden:Minuten:Sekunden'2:05:10'
HOUR_MINUTEStunden:Minuten'1:30'
DAY_MICROSECONDTage Stunden:Minuten:Sekunden.Mikrosekunden'1 2:05:10.000500'
DAY_SECONDTage Stunden:Minuten:Sekunden'1 2:05:10'
DAY_MINUTETage Stunden:Minuten'1 2:05'
DAY_HOURTage Stunden'1 12'
YEAR_MONTHJahre-Monate'1-6'

Siehe auch