DATETIME2FROMPARTS (Transact-SQL)
指定された有効桁数を使用して、指定された日付と時刻を表す datetime2 値を返します。
構文
DATETIME2FROMPARTS ( year, month, day, hour, minute, seconds, fractions, precision )
引数
year
年を指定する整数式。month
月を指定する整数式。day
日を指定する整数式。hour
時間を指定する整数式。minute
分を指定する整数式。seconds
秒を指定する整数式。fractions
小数部分を指定する整数式。precision
返される datetime2 値の有効桁数を指定する整数リテラル。
戻り値の型
datetime2 ( precision )
説明
DATETIME2FROMPARTS は、完全に初期化された datetime2 値を返します。 引数が有効でない場合は、エラーが発生します。 必要な引数が NULL の場合は、NULL が返されます。 ただし、precision 引数が NULL の場合は、エラーが発生します。
fractions 引数は precision 引数に依存します。 たとえば、precision が 7 の場合、小数部分はそれぞれ 100 ナノ秒を表します。precision が 3 の場合、小数部分はそれぞれ 1 ミリ秒を表します。 precision の値がゼロの場合、fractions の値もゼロにする必要があります。そうでない場合は、エラーが発生します。
この関数は、SQL Server 2012 以上のサーバーに対してリモート処理が可能です。 SQL Server 2012 より前のバージョンをインストールしているサーバーには、リモート処理が行われません。
使用例
A. 秒の小数部を使用しない場合の簡単な例
SELECT DATETIME2FROMPARTS ( 2010, 12, 31, 23, 59, 59, 0, 0 ) AS Result;
以下に結果セットを示します。
Result
---------------------------
2010-12-31 23:59:59.0000000
(1 row(s) affected)
B. 秒の小数部を使用する場合の例
以下の例は、fractions パラメーターと precision パラメーターの使用方法を示しています。
fractions の値が 5 で precision の値が 1 の場合、fractions の値は 1 秒の 5/10 を表します。
fractions の値が 50 で precision の値が 2 の場合、fractions の値は 1 秒の 50/100 を表します。
fractions の値が 500 で precision の値が 3 の場合、fractions の値は 1 秒の 500/1000 を表します。
SELECT DATETIME2FROMPARTS ( 2011, 8, 15, 14, 23, 44, 5, 1 );
SELECT DATETIME2FROMPARTS ( 2011, 8, 15, 14, 23, 44, 50, 2 );
SELECT DATETIME2FROMPARTS ( 2011, 8, 15, 14, 23, 44, 500, 3 );
GO
以下に結果セットを示します。
----------------------
2011-08-15 14:23:44.5
(1 row(s) affected)
----------------------
2011-08-15 14:23:44.50
(1 row(s) affected)
----------------------
2011-08-15 14:23:44.500
(1 row(s) affected)