TIMEFROMPARTS (Transact-SQL)TIMEFROMPARTS (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

指定された有効桁数を使用して、指定された時刻を表す time 値を返します。Returns a time value for the specified time and with the specified precision.

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

構文Syntax

TIMEFROMPARTS ( hour, minute, seconds, fractions, precision )  

注意

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

引数Arguments

hourhour
時間を指定する整数式。Integer expression specifying hours.

minuteminute
分を指定する整数式。Integer expression specifying minutes.

secondsseconds
秒を指定する整数式。Integer expression specifying seconds.

fractionsfractions
小数部分を指定する整数式。Integer expression specifying fractions.

有効桁数 (precision)precision
返される time 値の有効桁数を指定する整数リテラル。Integer literal specifying the precision of the time value to be returned.

戻り値の型Return Types

time( precision )time( precision )

解説Remarks

TIMEROMPARTS では、完全に初期化された time 値が返されます。TIMEROMPARTS returns a fully initialized time value. 引数が無効な場合は、エラーが発生します。If the arguments are invalid, then an error is raised. パラメーターのいずれかが NULL の場合、NULL が返されます。If any of the parameters are null, null is returned. ただし場合、 有効桁数 引数が null の場合、エラーが発生します。However, if the precision argument is null, then an error is raised.

分数 引数によって異なります、 有効桁数 引数。The fractions argument depends on the precision argument. たとえば、precision が 7 の場合、小数部分はそれぞれ 100 ナノ秒を表します。precision が 3 の場合、小数部分はそれぞれ 1 ミリ秒を表します。For example, if precision is 7, then each fraction represents 100 nanoseconds; if precision is 3, then each fraction represents a millisecond. 場合の値 有効桁数 が 0 の場合、値の 分数 もする必要があります。 0 にするそれ以外の場合、エラーが発生します。If the value of precision is zero, then the value of fractions must also be zero; otherwise, an error is raised.

この関数は、SQL Server 2012 (11.x)SQL Server 2012 (11.x) 以上のサーバーに対してリモート処理が可能です。This function can be remoted to SQL Server 2012 (11.x)SQL Server 2012 (11.x) servers and higher. SQL Server 2012 (11.x)SQL Server 2012 (11.x) より前のバージョンのサーバーには、リモート処理は実行できません。It cannot be remoted to servers that have a version lower than SQL Server 2012 (11.x)SQL Server 2012 (11.x).

Examples

A.A. 秒の小数部を使用しない場合の簡単な例Simple example without fractions of a second

SELECT TIMEFROMPARTS ( 23, 59, 59, 0, 0 ) AS Result;  

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

Result  
--------------------  
23:59:59.0000000  
  
(1 row(s) affected)  

B.B. 秒の小数部を使用する場合の例Example with fractions of a second

以下の例は、fractions パラメーターと precision パラメーターの使用方法を示しています。The following example demonstrates the use of the fractions and precision parameters:

  1. ときに 分数 5 の値を持つと 有効桁数 しの値の 1 の値を持つ 分数 5/10 秒を表します。When fractions has a value of 5 and precision has a value of 1, then the value of fractions represents 5/10 of a second.

  2. ときに 分数 5 の値を持つと 有効桁数 しの値の 1 の値を持つ 分数 5/10 秒を表します。When fractions has a value of 50 and precision has a value of 2, then the value of fractions represents 50/100 of a second.

  3. ときに 分数 5 の値を持つと 有効桁数 しの値の 1 の値を持つ 分数 5/10 秒を表します。When fractions has a value of 500 and precision has a value of 3, then the value of fractions represents 500/1000 of a second.

SELECT TIMEFROMPARTS ( 14, 23, 44, 5, 1 );  
SELECT TIMEFROMPARTS ( 14, 23, 44, 50, 2 );  
SELECT TIMEFROMPARTS ( 14, 23, 44, 500, 3 );  
GO  

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

----------------  
14:23:44.5  
  
(1 row(s) affected)  
  
----------------  
14:23:44.50  
  
(1 row(s) affected)  
  
----------------  
14:23:44.500  
  
(1 row(s) affected)