date_trunc Functie

Van toepassing op: Databricks Databricks Runtime

Retourneert tijdstempel afgekapt naar de eenheid die is opgegeven in unit.

Syntaxis

date_trunc(unit, expr)

Argumenten

• unit: een STRING letterlijke.
• expr: A DATE, TIMESTAMPof STRING met een geldige tijdstempelnotatie.

Retourneert

Een TIMESTAMP.

Notities

Geldige eenheden voor unit zijn (niet hoofdlettergevoelig):

• 'YEAR', 'YYYY', 'YY': afgekapt tot de eerste datum van het jaar waarin de expr valt, wordt het tijddeel nul uit
• 'QUARTER': afkappen tot de eerste datum van het kwartaal waarin het expr valt, is het tijdgedeelte nul uit
• 'MONTH', 'MM', 'MON': afkappen tot de eerste datum van de maand waarin de expr valt, is het tijdgedeelte nul uit
• 'WEEK': afkappen tot de maandag van de week waarin de expr valt, is het tijdgedeelte nul uit
• 'DAY', 'DD': nul het tijdgedeelte
• 'HOUR': nul de minuut en seconde met breukdeel
• 'MINUTE': nul de seconde met breukdeel
• 'SECOND': nul het tweede breukdeel
• 'MILLISECOND': nul de microseconden
• 'MICROSECOND': alles blijft

Als de unit niet goed is gevormd, retourneert NULLde functie .

Voorbeelden

> 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

Gerelateerde functies

• trunc, functie