trunc-Funktion

  • Artikel

Gilt für:durch Häkchen mit „Ja“ markiert Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime

Gibt ein Datum zurück, wobei das Datum auf die durch das Formatmodell unit angegebene Einheit abgeschnitten wird.

Syntax

trunc(expr, unit)

Argumente

  • expr: Ein DATE-Ausdruck.
  • unit: Ein STRING-Ausdruck, der angibt, wie abgeschnitten werden soll.

Gibt zurück

Ein DATE-Element.

Notizen

fmt muss eine der folgenden Optionen sein (Groß-/Kleinschreibung wird nicht beachtet):

  • 'YEAR', 'YYYY', 'YY': Schneidet bis zum ersten Datum des Jahres ab, in das das Datum fällt.
  • 'QUARTER': Schneidet bis zum ersten Datum des Quartals ab, in das das Datum fällt.
  • 'MONTH', 'MM', 'MON': Schneidet bis zum ersten Datum des Monats ab, in dem das Datum fällt.
  • 'WEEK': Schneidet bis zum Montag der Woche ab, in der das Datum liegt.

Wenn fmt nicht wohlgeformt ist, gibt die Funktion NULL zurück.

Beispiele

> SELECT trunc('2019-08-04', 'week');
 2019-07-29

> SELECT trunc('2019-08-04', 'quarter');
 2019-07-01

> SELECT trunc('2009-02-12', 'MM');
 2009-02-01

> SELECT trunc('2015-10-27', 'YEAR');
 2015-01-01

-- 'JAHR' is not a recognized unit
> SELECT trunc('2015-10-27', 'JAHR');
 NULL