Partilhar via


TIMEFROMPARTS (Transact-SQL)

Aplica-se a:Banco de Dados SQL doAzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsAnalytics Platform System (PDW)Banco de Dados SQL no Microsoft Fabric

Retorna um valor de de tempo de para o tempo especificado e com a precisão especificada.

Transact-SQL convenções de sintaxe

Sintaxe

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

Argumentos

hora
Expressão inteira especificando horas.

minuto
Expressão inteira especificando minutos.

segundos
Expressão inteira especificando segundos.

frações
Expressão inteira especificando frações.

precisão
Literal inteiro especificando a precisão do tempo valor a ser retornado.

Tipos de devolução

tempo(precisão)

Comentários

TIMEFROMPARTS retorna um valor de tempo totalmente inicializado. Se os argumentos forem inválidos, um erro será gerado. Se qualquer um dos parâmetros for null, null será retornado. No entanto, se a precisão argumento for null, um erro será gerado.

As frações argumento dependem da precisão argumento. Por exemplo, se de precisão for 7, então cada fração representa 100 nanossegundos; Se de precisão for 3, então cada fração representa um milissegundo. Se o valor de precisão for zero, então o valor das frações também deve ser zero; caso contrário, um erro será gerado.

Esta função pode ser remota para servidores SQL Server 2012 (11.x) e superior. Ele não pode ser remoto para servidores que tenham uma versão inferior ao SQL Server 2012 (11.x).

Exemplos

Um. Exemplo simples sem frações de segundo

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

Aqui está o conjunto de resultados.

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

B. Exemplo com frações de segundo

O exemplo a seguir demonstra o uso das frações e precisão parâmetros:

  1. Quando frações tem um valor de 5 e precisão tem um valor de 1, então o valor de frações representa 5/10 de segundo.

  2. Quando frações tem um valor de 50 e precisão tem um valor de 2, então o valor de frações representa 50/100 de segundo.

  3. Quando frações tem um valor de 500 e precisão tem um valor de 3, então o valor de frações representa 500/1000 de segundo.

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

Aqui está o conjunto de resultados.

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