Share via

trunc 功能

  • 發行項

適用于：核取標示為是 Databricks SQL 檢查標示為是 Databricks Runtime

傳回日期，其日期截斷為格式模型 unit 所指定的單位。

語法

trunc(expr, unit)

參數

  • expr：DATE 運算式。
  • unit：指定如何截斷的 STRING 運算式。

返回

DATE。

注意

fmt 必須是不區分大小寫的其中一個 () ：

  • 'YEAR'、 'YYYY' 、 'YY' - 截斷為日期落在年份的第一個日期。
  • 'QUARTER' - 截斷為日期落在季的第一個日期。
  • 'MONTH'、 'MM' 、 'MON' - 截斷為日期落在月份的第一個日期。
  • 'WEEK' - 截斷為日期落在一周的星期一。

如果 fmt 格式不正確，函式會傳 NULL 回 。

例子

> SELECT trunc('2019-08-04', 'week');
 2019-07-29

> SELECT trunc('2019-08-04', 'quarter');
 2019-07-01

> SELECT trunc('2009-02-12', 'MM');
 2009-02-01

> SELECT trunc('2015-10-27', 'YEAR');
 2015-01-01

-- 'JAHR' is not a recognized unit
> SELECT trunc('2015-10-27', 'JAHR');
 NULL