DATETIME_SUB

Subtrahiert ein angegebenes Zeitintervall von einem Datum.

Verwendungsbeispiel

DATETIME_SUB(Order Date, INTERVAL 1 WEEK)

Syntax

DATETIME_SUB( 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 abgezogen werden sollen.
  • part: Die Zeiteinheit, die abgezogen 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_SUB(DATETIME "2008-12-25 15:30:00", INTERVAL 10 MINUTE) 2008-12-25 15:20:00
DATETIME_SUB(DATE "2008-12-25", INTERVAL 5 DAY) 2008-12-20

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.