date_trunc Funktion

Gäller för:check markerad ja Databricks SQL-kontroll markerad ja Databricks Runtime

Returnerar tidsstämpel trunkerad till den enhet som anges i unit.

Syntax

date_trunc(unit, expr)

Argument

  • unit: En STRING literal.
  • expr: Ett DATE, TIMESTAMP, eller STRING med ett giltigt tidsstämpelformat.

Returnerar

A TIMESTAMP.

Anteckningar

Giltiga enheter för unit är (skiftlägesokänsliga):

  • 'YEAR', 'YYYY', 'YY': trunkera till det första datumet på året då expr infaller, tidsdelen blir noll ut
  • 'QUARTER': trunkera till det första datumet i kvartalet som expr infaller, tidsdelen blir noll
  • 'MONTH', 'MM', 'MON': trunkera till det första datumet i månaden som expr infaller, tidsdelen blir noll ut
  • 'WEEK': trunkera till måndagen i veckan som expr faller in, tidsdelen blir noll ut
  • 'DAY', 'DD': nollställ tidsdelen
  • 'HOUR': nolla minut och sekund med bråkdel
  • 'MINUTE': nollställ den andra med bråkdel
  • 'SECOND': nollställ den andra deldelen
  • 'MILLISECOND': nollställ mikrosekunderna
  • 'MICROSECOND': allt återstår

Om inte unit är välformulerad returnerar NULLfunktionen .

Exempel

> SELECT date_trunc('YEAR', '2015-03-05T09:32:05.359');
 2015-01-01 00:00:00

> SELECT date_trunc('MM', '2015-03-05T09:32:05.359');
 2015-03-01 00:00:00

> SELECT date_trunc('DD', '2015-03-05T09:32:05.359');
 2015-03-05 00:00:00

> SELECT date_trunc('HOUR', '2015-03-05T09:32:05.359');
 2015-03-05 09:00:00

> SELECT date_trunc('MILLISECOND', '2015-03-05T09:32:05.123456');
 2015-03-05 09:32:05.123

-- Not a recognised unit
> SELECT date_trunc('MS', '2015-03-05T09:32:05.123456');
 NULL