文档首页> 数据湖探索 DLI> SQL语法参考（即将下线）> Spark SQL语法参考（即将下线）> 内置函数> 日期函数> datepart
更新时间：2024-05-28 GMT+08:00
查看PDF

datepart

datepart函数用于计算日期date中符合指定时间单位datepart的值。

命令格式

datepart（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代表月份。
  • dd代表天。
  • HH代表24小时制时。
  • hh代表12小时制时。
  • mi代表分钟。
  • ss代表秒。
  • SSS代表毫秒

返回值说明

返回BIGINT类型。

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

示例代码

返回2023。

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

返回2023。

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

返回0。

select datepart(date '2023-08-14 17:00:00', 'mi');

返回NULL。

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