DATETIME_ADD

Fügt einem Datum oder einem Datum und einer Uhrzeit ein angegebenes Zeitintervall hinzu.

Verwendungsbeispiel

DATETIME_ADD(Order Date, INTERVAL 1 WEEK)

Syntax

DATETIME_ADD( datetime_expression, INTERVAL integer part )

Parameter

  • datetime_expression: Ein Feld oder Ausdruck vom Typ „Datum“ oder „Datum und Uhrzeit“.
  • integer: Ein Feld oder Ausdruck vom Typ „Ganzzahl“, das bzw. der die Anzahl von Teilen angibt, die hinzugefügt werden sollen.
  • part: Die Zeiteinheit, die hinzugefügt werden soll. DATETIME_ADD unterstützt die folgenden Werte für part:
    • MICROSECOND: Verfügbar für Felder und Ausdrücke vom Typ „Datum und Uhrzeit“.
    • MILLISECOND: Verfügbar für Felder und Ausdrücke vom Typ „Datum und Uhrzeit“.
    • SECOND: Verfügbar für Felder und Ausdrücke vom Typ „Datum und Uhrzeit“.
    • MINUTE: Verfügbar für Felder und Ausdrücke vom Typ „Datum und Uhrzeit“.
    • HOUR: Verfügbar für Felder und Ausdrücke vom Typ „Datum und Uhrzeit“.
    • DAY
    • WEEK: Dieser Datumsteil beginnt mit Sonntag.
    • ISOWEEK: Verwendet Wochengrenzen nach ISO 8601. ISO-Wochen beginnen mit Montag.
    • MONTH
    • QUARTER
    • YEAR
    • ISOYEAR: Verwendet die Jahresgrenze gemäß der ISO 8601-Wochennummerierung. Die ISO-Jahresgrenze ist der Montag der ersten Woche, in der der Donnerstag in das entsprechende gregorianische Kalenderjahr fällt.

Rückgabedatentyp

Datum und Uhrzeit

Beispiele

Beispielformel Ausgabe
DATETIME_ADD(DATETIME "2023-01-25 15:30:00", INTERVAL 10 MINUTE)

25. Jan. 2023, 15:40:00 Uhr

DATETIME_ADD(DATE "2023-01-25", INTERVAL 5 DAY)

30. Januar 2023, 00:00:00 Uhr

Hinweise

Diese Funktion ist für Typen von Kompatibilitätsmodus-Daten nicht verfügbar.

Wenn Komponenten von MONTH, QUARTER oder YEAR verwendet werden und das resultierende Datum am (oder nahe am) letzten Tag des Monats liegt, gibt DATETIME_ADD den letzten Tag des Monats zurück. Das kann vorkommen, wenn der Monat im resultierenden Datum weniger Tage hat als der Monat im Startdatum.

Ist beispielsweise Date = 31. August 2020, gibt DATETIME_ADD(Date, INTERVAL 1 MONTH) den 30. September 2020 zurück.