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