DATEFROMPARTS(Transact-SQL)

対象者:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analyticsアナリティクスプラットフォームシステム(PDW)Microsoft FabricにおけるSQLデータベース

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

Transact-SQL 構文表記規則

構文

DATEFROMPARTS ( year, month, day )  

引数

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)  

関連項目

日付(Transact-SQL)