Fügt einem Datum ein angegebenes Zeitintervall hinzu.
Verwendungsbeispiel
DATETIME_ADD(Bestelldatum, INTERVAL 1 WEEK)
Syntax
DATETIME_ADD(datetime_expression, INTERVAL ganzzahliger Teil)
Parameter
datetime_expression
– ein Feld oder Ausdruck vom Typ "Datum" oder "Datum und Uhrzeit".integer
– ein Feld oder Ausdruck vom Typ "Ganzzahl", der die Anzahl von Teilen angibt, die addiert werden sollen.part
– die Zeiteinheit, die addiert werden soll. DATETIME_ADD unterstützt die folgenden Werte fürpart
:MICROSECOND
: verfügbar für Felder und Ausdrücke vom Typ "Datum und Uhrzeit".MILLISECOND
: verfügbar für Felder oder 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 oder Ausdrücke vom Typ "Datum und Uhrzeit".HOUR
: verfügbar für Felder und Ausdrücke vom Typ "Datum und Uhrzeit".DAY
WEEK
. Entspricht siebenDAY
s.MONTH
QUARTER
YEAR
Rückgabedatentyp
Datum und Uhrzeit
Beispiele
Formel | Ergebnis |
DATETIME_ADD(DATETIME "2023-01-25 15:30:00", INTERVAL 10 MINUTE) |
Jan 25, 2023, 3:40:00 PM |
|
Jan 30, 2023, 12:00:00 AM |
Hinweise
Diese Funktion ist für Typen von Kompatibilitätsmodus-Daten nicht verfügbar.
MONTH, QUARTER und YEAR müssen speziell behandelt werden, wenn das Datum der letzte Tag des Monats ist oder in dessen Nähe liegt. Wenn der daraus resultierende Monat weniger Tage als der Tag des ursprünglichen Tages vom Typ "Datum" oder "Datum und Uhrzeit" hat, ist der Ergebnistag der letzte Tag des neuen Monats.