TIMEFROMPARTS (Transact-SQL)

Статья
10/16/2024

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

Возвращает значение time, соответствующее указанному времени с заданной точностью.

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

hour
Целочисленное выражение, задающее часы.

minute
Целочисленное выражение, задающее минуты.

seconds
Целочисленное выражение, задающее секунды.

fractions
Целочисленное выражение, задающее доли секунд.

precision
Целочисленное литеральное значение, определяющее точность возвращаемого значения time.

Типы возвращаемых данных

time( precision )

Замечания

TIMEROMPARTS возвращает полностью инициализированное значение времени. Если аргументы недопустимы, то возникает ошибка. Если любой из параметров имеет значение NULL, возвращается NULL. Однако если аргумент precision равен NULL, то возникает ошибка.

Аргумент fractions зависит от аргумента precision. Например, если значение precision равно 7, то каждая дробная часть представляет 100 наносекунд; если значение precision равно 3, то каждая дробная часть представляет миллисекунду. Если значение precision равно нулю, то значение fractions также должно быть равно нулю, иначе возникает ошибка.

Эта функция может быть удалена на серверы SQL Server 2012 (11.x) и более поздних версий. Это не может быть удалено на серверы с более низкой версией, чем SQL Server 2012 (11.x).

Примеры

А. Простой пример без долей секунд

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

Вот результирующий набор.

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

B. Пример с долями секунд

В приведенном ниже примере показано использование параметров fractions и precision.

Если параметр fractions имеет значение 5, а параметр precision — значение 1, то значение параметра fractions представляет 5/10 секунды.
Если параметр fractions имеет значение 50, а параметр precision — значение 2, то значение параметра fractions представляет 50/100 секунды.
Если параметр fractions имеет значение 500, а параметр precision — значение 3, то значение параметра fractions представляет 500/1000 секунды.

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