trunc 函数

适用于:勾选“是” Databricks SQL 勾选“是” 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