Udostępnij za pośrednictwem

Funkcja date_trunc

  • Artykuł

Dotyczy: zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime

Zwraca znacznik czasu obcięty do jednostki określonej w unit.

Składnia

date_trunc(unit, expr)

Argumenty

  • unitSTRING: literał.
  • expr: A DATE, TIMESTAMPlub STRING z prawidłowym formatem znacznika czasu.

Zwraca

Klasa TIMESTAMP.

Uwagi

Prawidłowe jednostki dla unit elementu to (bez uwzględniania wielkości liter):

  • 'YEAR', , 'YYYY''YY': obcinanie do pierwszej daty rokuexpr, w których przypada, część czasowa będzie równa zero
  • 'QUARTER': obcinanie do pierwszej daty kwartału expr , w których przypada, część czasowa będzie równa zero
  • 'MONTH', , 'MM''MON': obcinanie do pierwszej daty miesiąca, w których expr przypada, część czasowa będzie równa zero
  • 'WEEK': obcięty do poniedziałku tygodnia, w których expr wypada, część czasowa będzie równa zero
  • 'DAY', 'DD': zero out the time part
  • 'HOUR': zero out minuty i sekundy z części ułamkowej
  • 'MINUTE': zero out drugiego z części ułamkowej
  • 'SECOND': zeruje drugą część ułamkową
  • 'MILLISECOND': zero out the microseconds
  • 'MICROSECOND': wszystko pozostaje

Jeśli funkcja unit nie jest poprawnie sformułowana, funkcja zwraca wartość NULL.

Przykłady

> 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