VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

YEAR

功能描述

YEAR函数用于获取给定时间的年。

语法格式

YEAR(time)

参数说明

time支持的数据类型如下:

  • date

  • datetime

  • timestamp

  • timestamptz

  • time

  • timetz

  • timestamp类型的字符串

  • timestamptz类型的字符串

  • date类型的字符串

  • datetime类型的字符串

注意事项

  • 若函数的参数是time类型时,由于time类型不包含年月日,按照MySQL的处理,返回当前的年份。
  • 输入null时,返回值为空。
  • 输入的时间格式非法时,报错信息为时间格式语法异常。
  • 数据的时间超范围时,报错信息为输入的时间范围异常。
  • 具备该函数的访问权限,例如Year(time)函数如果位于pg_catalog模式下,用户需要具备以下权限:
    • pg_catalog模式的usage权限。
    • year(time)函数的excute权限。

兼容性

完全兼容。

示例

示例1:查询当前年份。

select year(current_date);

结果返回如下:

 year 
------
 2022
(1 row)

示例2:查询date类型年份。

1、直接调用。

select year(date '2022-1-23') as result;

结果返回如下:

 result
--------
   2022
(1 row)

2、创建测试表并插入测试数据。

create table test(info date);
insert into test values ('2022-1-1');

3、结合表调用year函数。

select info,year(info) from test;

结果返回如下:

         info          | year
-----------------------+------
 2021-11-1 21:11:23    | 2021
 2021-11-1 21:11:23+08 | 2021
(2 rows)

示例3:查询date类型的字符串年份。

1、直接调用year函数。

select year('2012-1-5') as result;

2、创建测试表并插入数据。

create table test(info text);
insert into test values ('2021-11-1');

3、结合表调用year函数。

select info,year(info) from test;

结果返回如下:

   info    | year
-----------+------
 2021-11-1 | 2021
(1 row)