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 ISO 8601-Jahresgrenze zur Nummerierung der Wochen. 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.

Die Komponenten MONTH, QUARTER und YEAR bedürfen einer Sonderbehandlung, wenn das Datum am (oder nahe am) letzten Tag des Monats 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.