更新时间：2026-07-03 GMT+08:00
datepart1
datepart1函数用于计算日期date中符合指定时间单位datepart1的值。
命令格式
datepart1(string date,string datepart)
参数说明
| 参数 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
| date | 是 | DATE 或 STRING | 代表起始日期。 格式为：
|
| datepart | 是 | STRING | 代表需要返回的时间单位。 参数datepart支持扩展的日期格式：年-year、月-month或-mon、日-day和小时-hour。
|
返回值说明
返回BIGINT类型。
- date非DATE或STRING类型时，返回报错，错误信息：data type mismatch；
- date为DATE或STRING类型，但不符合日期值的入参格式时，返回NULL；
- date值为NULL时，返回NULL。
- datepart值为NULL时，返回NULL。
示例代码
返回2023。
select datepart1(date '2023-08-14 17:00:00', 'yyyy');
返回2023。
select datepart1('2023-08-14 17:00:00', 'yyyy'); 返回59。
select datepart1('2023-08-14 17:59:59', 'mi') 返回NULL。
select datepart1(date '2023-08-14', null);
父主题： 日期函数
