更新时间：2025-01-22 GMT+08:00
year
year函数用于返回指定日期中的年份。
命令格式
year(string date)
参数说明
参数 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
date | 是 | DATE或STRING | 需要处理的日期。 格式：
|
返回值说明
返回INT类型的值。
- date非DATE或STRING类型时，返回报错，错误信息：data type mismatch。
- date为DATE或STRING类型，但不符合日期值的入参格式时，返回NULL。
- date值为NULL时，返回NULL。
示例代码
返回2023。
select year('2023-08-16 10:54:36'); 返回NULL。
select year('23-01-01'); 返回NULL。
select year('2023/08/16'); 返回NULL。
select year(null);
父主题：日期函数
