YEAR (Transact-SQL)

  • 项目

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsAnalytics Platform System (PDW)

返回表示指定 date 的年份的整数。

有关所有 Transact-SQL 日期和时间数据类型及函数的概述，请参阅日期和时间数据类型及函数 (Transact-SQL)。

Transact-SQL 语法约定

语法

YEAR ( date )

注意

若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法，请参阅早期版本文档。

自变量

date
一个表达式，它可以解析为 time、date、smalldatetime、datetime、datetime2 或 datetimeoffset 值。 date 参数可以是表达式、列表达式、用户定义变量或字符串文字。

返回类型

int

返回值

YEAR 与 DATEPART (year, date) 返回相同的值。

如果 date 仅包含一个时间部分，则返回值为 1900，即基准年。

示例

下面的语句将返回 2010。 它是表示年份的数字。

SELECT YEAR('2010-04-30T01:01:01.1234567-07:00');

下面的语句将返回 1900, 1, 1。 date 的参数为数字 0。 SQL Server 将 0 解释为 1900 年 1 月 1 日。

SELECT YEAR(0), MONTH(0), DAY(0);

示例：Azure Synapse Analytics 和 Analytics Platform System (PDW)

下面的语句将返回 1900, 1, 1。 date 的参数为数字 0。 SQL Server 将 0 解释为 1900 年 1 月 1 日。

SELECT TOP 1 YEAR(0), MONTH(0), DAY(0);

另请参阅

CAST 和 CONVERT (Transact-SQL)