TIMEFROMPARTS(Transact-SQL)

  • 아티클

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System(PDW)

지정한 전체 자릿수를 사용하여 지정한 시간에 대한 time 값을 반환합니다.

Transact-SQL 구문 표기 규칙

Syntax

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

참고 항목

SQL Server 2014(12.x) 및 이전 버전에 대한 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조 하세요.

인수

hour
시간을 지정하는 정수 식입니다.

minute
분을 지정하는 정수 식입니다.

초
초를 지정하는 정수 식입니다.

fractions
소수 자릿수를 지정하는 정수 식입니다.

전체 자릿수
반환할 time 값의 전체 자릿수를 지정하는 정수 리터럴입니다.

반환 형식

time(precision)

설명

TIMEROMPARTS는 완전히 초기화된 시간 값을 반환합니다. 인수가 유효하지 않으면 오류가 발생합니다. 매개 변수에 Null이 포함되어 있으면 Null이 반환됩니다. 그러나 precision 인수가 Null일 경우에는 오류가 발생합니다.

fractions 인수는 precision 인수에 의존합니다. 예를 들어 precision이 7이면 각 소수 자릿수가 100나노초를 나타내고 precision이 3이면 각 소수 자릿수가 1밀리초를 나타냅니다. precision의 값이 0이면 fractions의 값도 0이어야 합니다. 그렇지 않으면 오류가 발생합니다.

이 함수는 SQL Server 2012(11.x) 이상 서버에 대해서는 원격으로 실행할 수 있지만 SQL Server 2012(11.x) 이전 버전의 서버에 대해서는 원격으로 실행할 수 없습니다.

예

A. 소수 단위 초를 사용하지 않는 간단한 예

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

결과 집합은 다음과 같습니다.

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

B. 소수 단위 초를 사용하는 예

다음 예에서는 fractions 및 precision 매개 변수의 사용 방법을 설명합니다.

  1. fractions의 값이 5이고 precision의 값이 1이면, fractions의 값은 1초의 5/10를 나타냅니다.

  2. fractions의 값이 50이고 precision의 값이 2이면 fractions의 값은 1초의 50/100을 나타냅니다.

  3. fractions의 값이 500이고 precision의 값이 3이면 fractions의 값은 1초의 500/1000을 나타냅니다.

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

결과 집합은 다음과 같습니다.

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