YEAR (Transact-SQL)YEAR (Transact-SQL)

適用対象:Applies to: はいSQL ServerSQL Server (サポートされているすべてのバージョン) yesSQL ServerSQL Server (all supported versions) はいAzure SQL データベースAzure SQL DatabaseYesAzure SQL データベースAzure SQL Database はいAzure SQL Managed InstanceAzure SQL Managed InstanceYesAzure SQL Managed InstanceAzure SQL Managed Instance はいAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics はいParallel Data WarehouseParallel Data WarehouseyesParallel Data WarehouseParallel Data Warehouse適用対象:Applies to: はいSQL ServerSQL Server (サポートされているすべてのバージョン) yesSQL ServerSQL Server (all supported versions) はいAzure SQL データベースAzure SQL DatabaseYesAzure SQL データベースAzure SQL Database はいAzure SQL Managed InstanceAzure SQL Managed InstanceYesAzure SQL Managed InstanceAzure SQL Managed Instance はいAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics はいParallel Data WarehouseParallel Data WarehouseyesParallel Data WarehouseParallel Data Warehouse

指定された 日付 の年を表す整数を返します。Returns an integer that represents the year of the specified date.

すべての Transact-SQLTransact-SQL 日付および時刻のデータ型と関数の概要については、「日付と時刻のデータ型および関数 (Transact-SQL)」を参照してください。For an overview of all Transact-SQLTransact-SQL date and time data types and functions, see Date and Time Data Types and Functions (Transact-SQL).

トピック リンク アイコン Transact-SQL 構文表記規則Topic link icon Transact-SQL Syntax Conventions

構文Syntax

YEAR ( date )  

注意

SQL Server 2014 以前の Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。To view Transact-SQL syntax for SQL Server 2014 and earlier, see Previous versions documentation.

引数Arguments

datedate
timedatesmalldatetimedatetimedatetime2、または datetimeoffset 値に解決できる式です。Is an expression that can be resolved to a time, date, smalldatetime, datetime, datetime2, or datetimeoffset value. date 引数には、式、列式、ユーザー定義変数、または文字列リテラルを指定できます。The date argument can be an expression, column expression, user-defined variable or string literal.

戻り値の型Return Types

intint

戻り値Return Value

YEAR は DATEPART (yeardate) と同じ値を返します。YEAR returns the same value as DATEPART (year, date).

日付 には、時刻部分のみが含まれる、戻り値は基準年を 1900 年にです。If date only contains a time part, the return value is 1900, the base year.

Examples

次のステートメントでは、2010 が返されます。The following statement returns 2010. これは年の数値です。This is the number of the year.

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

次のステートメントでは、1900, 1, 1 が返されます。The following statement returns 1900, 1, 1. 引数 日付 番号 0です0The argument for date is the number 0. SQL ServerSQL Server は、0 を 1900 年 1 月 1 日と解釈します。interprets 0 as January 1, 1900.

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

例: Azure Synapse AnalyticsAzure Synapse AnalyticsParallel Data WarehouseParallel Data WarehouseExamples: Azure Synapse AnalyticsAzure Synapse Analytics and Parallel Data WarehouseParallel Data Warehouse

次のステートメントでは、1900, 1, 1 が返されます。The following statement returns 1900, 1, 1. 引数 日付 番号 0です0The argument for date is the number 0. SQL ServerSQL Server は、0 を 1900 年 1 月 1 日と解釈します。interprets 0 as January 1, 1900.

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

参照See Also

CAST および CONVERT (Transact-SQL)CAST and CONVERT (Transact-SQL)