trunc 函数

  • 项目

适用于：check marked yes Databricks SQL check marked yes Databricks Runtime

返回一个日期，该日期被截断为格式模型 unit 所指定的单位。

语法

trunc(expr, unit)

参数

  • expr：一个日期表达式。
  • unit：指定截断方式的字符串表达式。

返回

一个 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