文档首页/ 数据湖探索 DLI/ SQL语法参考（即将下线）/ Spark SQL语法参考（即将下线）/ 内置函数/ 日期函数/ datepart
更新时间：2024-11-08 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代表年份。
  • MM代表月份。
  • dd代表天。
  • hh代表小时。
  • mi代表分钟。
  • ss代表秒。

返回值说明

返回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');

返回59。

select datepart('2023-08-14 17:59:59', 'mi')

返回NULL。

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