DATETIME_TRUNC

Kürzt ein Datum auf die angegebene Granularität.

Verwendungsbeispiel

DATETIME_TRUNC(Order Date, MONTH)

Syntax

DATETIME_TRUNC( date_expression, part )

Parameter

date_expression: Ein Feld oder Ausdruck vom Typ „Datum“ oder „Datum und Uhrzeit“.

part: Die Zeitkomponente, die zurückgegeben werden soll. DATETIME_TRUNC unterstützt die folgenden Zeitkomponenten:

  • 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_TRUNC(DATE '2008-12-25', MONTH) 2008-12-01 00:00:00
DATETIME_TRUNC(DATETIME "2008-12-25 15:30:00", DAY) 2008-12-25 00:00:00

Im folgenden Beispiel liegt der ursprüngliche date_expression im gregorianischen Kalenderjahr 2015. DATE_TRUNC mit dem Datumsteil ISOYEAR kürzt date_expression jedoch bis zum Anfang des ISO-Jahres und nicht des gregorianischen Kalenderjahres. Der erste Donnerstag des Kalenderjahres 2015 fiel auf den 01.01.2015. Deshalb beginnt das ISO-Jahr 2015 mit dem Montag davor am 29.12.2014. Entsprechend fällt die ISO-Jahresgrenze vor dem date_expression 15.06.2015 auf den 29.12.2014.

Beispielformel Ausgabe
DATE_TRUNC('2015-06-15', ISOYEAR) 2014-12-29
EXTRACT(ISOYEAR FROM DATETIME '2015-06-15') 2015

Hinweise

Diese Funktion ist für Datumstypen im Kompatibilitätsmodus nicht verfügbar.