共用方式為

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