適用於:
Databricks SQL
Databricks Runtime
傳回截斷至 unit 中所指定單位的時間戳記。
語法
date_trunc(unit, expr)
引數
-
unit:常STRING值。 -
expr:具有DATE有效時間戳格式的 、TIMESTAMP或STRING。
傳回
TIMESTAMP。
備註
的有效單位 unit 為 (不區分大小寫):
-
'YEAR'、 、'YYYY'、'YY'截斷到落在年份expr的第一個日期,時間部分將會是零 -
'QUARTER':截斷至落入的季度expr第一個日期,時間部分將會是零 -
'MONTH'、 、'MM''MON'、 截斷到落在月份的第expr一個日期,時間部分將會是零 -
'WEEK':截斷到當周expr的星期一,跌倒的時間部分會是零 -
'DAY','DD': 零時間部分 -
'HOUR':以分數部分將分秒零 -
'MINUTE':以分數部分將第二個零 -
'SECOND':零出第二個分數部分 -
'MILLISECOND':零秒 -
'MICROSECOND':一切都維持不變
unit如果 格式不正確,則函式會傳NULL回 。
範例
> 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