共用方式為

date_trunc 功能

  • 發行項

適用于：核取標示為是 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