date_trunc Funkció

  • Cikk

A következőre vonatkozik:yes Databricks SQL check marked yes Databricks Runtime

A megadott egységhez csonkolt időbélyeget ad unitvissza.

Szintaxis

date_trunc(unit, expr)

Argumentumok

  • unit: Egy STRING literál.
  • expr: A DATE, TIMESTAMPvagy STRING érvényes időbélyeg-formátummal.

Visszatérési érték

A TIMESTAMP.

Megjegyzések

Érvényes egységek a következőkhöz unit (kis- és nagybetűk megkülönböztetése):

  • 'YEAR', , 'YYYY''YY': truncate az év első dátumára, amelybe a expr esik, az időrész nulla lesz
  • 'QUARTER': truncate az első dátumot a negyedév, hogy a expr esik, az idő rész lesz nulla ki
  • 'MONTH', , 'MM''MON': truncate a hónap első dátumára, amelybe a expr esik, az időrész nulla lesz
  • 'WEEK': truncate a hét hétfője, hogy a expr esik, az idő rész lesz nulla ki
  • 'DAY', 'DD': nulla az idő rész
  • 'HOUR': nulla a perc és a másodperc törtrészével
  • 'MINUTE': nulla a másodpercből a törtrészlel
  • 'SECOND': nulla a második törtrészből
  • 'MILLISECOND': a mikroszekundumok nullázása
  • 'MICROSECOND': minden megmarad

Ha a unit nem megfelelően formázott, a függvény a függvényt adja NULLvissza.

Példák

> 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