文档首页> 数据湖探索 DLI> Spark SQL语法参考> 内置函数> 日期函数> datetrunc
更新时间：2023-10-25 GMT+08:00
查看PDF

datetrunc

datetrunc函数用于计算将日期date按照datepart指定的时间单位进行截取后的日期值。

截取datepart之前的部分，除截取的部分外自动填充为默认值。可参考示例代码。

命令格式

datetrunc (string date, string datepart)

参数说明

表1 参数说明

参数

是否必选

参数类型

说明

date

是

DATE

或

STRING

代表起始日期。

格式为：

  • yyyy-mm-dd
  • yyyy-mm-dd hh:mi:ss
  • yyyy-mm-dd hh:mi:ss.ff3

datepart

是

STRING

代表需要返回的时间单位。

参数datepart支持扩展的日期格式：年-year、月-month或-mon、日-day和小时-hour。

  • YYYY或yyyy代表年份。
  • MM代表月份。
  • mm代表分钟。
  • dd代表天。
  • HH代表24小时制时。
  • hh代表12小时制时。
  • mi代表分钟。
  • ss代表秒。
  • SSS代表毫秒

返回值说明

返回DATE或STRING类型的日期值。

  • date非DATE或STRING类型时，返回报错，错误信息：data type mismatch；
  • date为DATE或STRING类型，但不符合日期值的入参格式时，返回NULL；
  • datepart值为NULL时，返回NULL。
  • datepart值为时、分、秒时，按照天截取返回

示例代码

静态数据示例

返回2023-01-01 00:00:00。

select datetrunc('2023-08-14 17:00:00', 'yyyy');

返回2023-08-01 00:00:00。

select datetrunc('2023-08-14 17:00:00', 'month');

返回2023-08-14。

select datetrunc('2023-08-14 17:00:00', 'DD');

返回2023-01-01。

select datetrunc('2023-08-14', 'yyyy');

返回2023-08-14。

select datetrunc('2023-08-14 17:00:00', 'HH');

返回NULL。

select datetrunc('2023-08-14', null);
父主题： 日期函数