DATEFROMPARTS (Transact-SQL)

  • [アーティクル]

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

この関数は、指定の年月日の値にマッピングされる date 値を返します。

Transact-SQL 構文表記規則

構文

DATEFROMPARTS ( year, month, day )

Note

SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

year
年を指定する整数式。

month
1 - 12 で月を指定する整数式。

day
日を指定する整数式。

戻り値の型

date

解説

DATEFROMPARTS は、日付部分が指定の年月日に設定され、時間部分が既定値に設定されている date の値を返します。 引数が無効な場合、DATEFROMPARTS はエラーを生成します。 DATEFROMPARTS は、必須引数に 1 つでも NULL 値が含まれている場合、NULL を返します。

この関数は、SQL Server 2012 (11.x) サーバー以降のリモート処理に対応しています。 SQL Server 2012 (11.x) より前のバージョンについては、リモート処理できません。

例

これは DATEFROMPARTS 関数の使用例です。

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

結果セットは次のようになります。

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

関連項目

date (Transact-SQL)