DATETIME_ADD

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

Example formula Output
DATETIME_ADD(DATETIME "2023-01-25 15:30:00", INTERVAL 10 MINUTE)

25. Januar 2023, 15:40 Uhr

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

30. Januar 2023, 00:00 Uhr

Hinweise

Diese Funktion ist für Datumstypen im Kompatibilitätsmodus 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 passieren, wenn der Monat im resultierenden Datum weniger Tage hat als der Monat im Startdatum.

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