YEAR 函数

功能描述

YEAR 函数用于从不同类型的日期表达式中提取年份部分，并以整数形式返回。

语法

YEAR(expr)

参数说明

• expr: 可以是不同类型的日期表达式，包括字符串（date/string）、时间（time/timez）和时间戳（timestamp/timestamptz）。

返回类型

整数（int）

使用示例

1. 从字符串形式的日期中提取年份：

   SELECT YEAR('2022-03-31');
   -- 结果：2022
   

2. 从时间戳形式的日期中提取年份：

   SELECT YEAR(TIMESTAMP "2022-03-31 14:59:59");
   -- 结果：2022
   

3. 从当前时间戳中提取年份：

   SELECT YEAR(now());
   -- 结果：根据当前时间戳返回年份
   

注意事项

• 当输入的日期表达式为字符串类型时，请确保其符合数据库支持的日期格式，否则可能导致解析错误。
• 当输入的时间表达式仅包含时间部分时，YEAR 函数将返回0000作为年份。
• 在使用 YEAR 函数时，请确保传入的参数类型正确，以避免类型不匹配的错误。