YEAR

📄字数 434

👁️阅读量 加载中...

功能描述

返回日期所在的年份。

语法格式

YEAR(expr)

输入参数

• expr：DATE、DATETIME 或 DATETIME WITH TIME ZONE 类型，或能隐式转换为上述类型的其他类型，参数取值范围：[0001-01-01 00:00:00.000000, 9999-12-31 23:59:59.999999]。

提示

• 因 NULL 无具体的类型，所以当参数为 NULL 时，会产生异常 E10100 候选函数出现多义性，需要手动为参数指定具体的类型，如：YEAR(NULL::DATETIME)。

输出结果

返回 INTEGER 类型，返回值范围为 [1, 9999]，输入参数为 NULL 时，输出结果为 NULL。

执行类型

TYPE	VALUE	说明
NATIVE	0	函数只能在本地计算
VOLATI	0	函数的每次计算值不同
STABLE	0	函数的每次计算值相同
COMPUTE	0	函数支持预计算取值
NOT_CONST	0	函数不支持转常数
HAVE_DEF	0	函数参数有默认值

示例

-- 日期所在的年份
SQL> SELECT YEAR('2025-11-01 12:12:12');

+-------+
| EXPR1 |
+-------+
| 2025  |
+-------+