DATEFROMPARTS (Transact-SQL)DATEFROMPARTS (Transact-SQL)

07/29/2017

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

この関数は、指定の年月日の値にマッピングされる date 値を返します。This function returns a date value that maps to the specified year, month, and day values.

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

構文Syntax

DATEFROMPARTS ( year, month, day )

注意

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

引数Arguments

yearyear
年を指定する整数式。An integer expression that specifies a year.

monthmonth
1 - 12 で月を指定する整数式。An integer expression that specifies a month, from 1 to 12.

dayday
日を指定する整数式。An integer expression that specifies a day.

戻り値の型Return types

datedate

解説Remarks

DATEFROMPARTS は、日付部分が指定の年月日に設定され、時間部分が既定値に設定されている date の値を返します。DATEFROMPARTS returns a date value, with the date portion set to the specified year, month and day, and the time portion set to the default. 引数が無効な場合、DATEFROMPARTS はエラーを生成します。For invalid arguments, DATEFROMPARTS will raise an error. DATEFROMPARTS は、必須引数に 1 つでも NULL 値が含まれている場合、NULL を返します。DATEFROMPARTS returns null if at least one required argument has a null value.

この関数は、SQL Server 2012 (11.x)SQL Server 2012 (11.x) サーバー以降のリモート処理に対応しています。This function can handle remoting to SQL Server 2012 (11.x)SQL Server 2012 (11.x) servers and above. SQL Server 2012 (11.x)SQL Server 2012 (11.x) より前のバージョンについては、リモート処理できません。It cannot handle remoting to servers with a version below SQL Server 2012 (11.x)SQL Server 2012 (11.x).

例Examples

これは DATEFROMPARTS 関数の使用例です。This example shows the DATEFROMPARTS function in action.

SELECT DATEFROMPARTS ( 2010, 12, 31 ) AS Result;

結果セットは次のようになります。Here is the result set.

Result  
----------------------------------  
2010-12-31  
  
(1 row(s) affected)