YEAR (Transact-SQL)

適用於： SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體Azure Synapse AnalyticsAnalytics Platform System (PDW)

傳回代表指定 date 中年份的整數。

如需所有 Transact-SQL 日期和時間資料類型與函式的概觀，請參閱日期和時間資料類型與函式 (Transact-SQL)。

Transact-SQL 語法慣例

Syntax

YEAR ( date )  

引數

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)