DATETIME2FROMPARTS (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)

Essa função retorna um valor datetime2 para os argumentos de data e hora especificados. O valor retornado tem uma precisão especificada pelo argumento precision.

Convenções de sintaxe de Transact-SQL

Sintaxe

DATETIME2FROMPARTS ( year, month, day, hour, minute, seconds, fractions, precision )

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

year
Uma expressão de inteiro que especifica um ano.

month
Uma expressão de inteiro que especifica um mês.

day
Uma expressão de inteiro que especifica um dia.

hour
Uma expressão de inteiro que especifica as horas.

minute
Uma expressão de inteiro que especifica os minutos.

segundos
Uma expressão de inteiro que especifica os segundos.

fractions
Uma expressão de inteiro que especifica um valor de segundos fracionário.

precisão
Uma expressão de inteiro que especifica a precisão do valor datetime2 que será retornado por DATETIME2FROMPARTS.

Tipos de retorno

datetime2(precision)

Comentários

DATETIME2FROMPARTS retorna um valor datetime2 completamente inicializado. DATETIME2FROMPARTS gerará um erro se pelo menos um argumento necessário tiver um valor inválido. DATETIME2FROMPARTS retornará nulo se pelo menos um argumento necessário tiver um valor nulo. No entanto, se o argumento precision tiver um valor nulo, DATETIME2FROMPARTS gerará um erro.

O argumento fractions depende do argumento precision. Por exemplo, para um valor de precision igual a 7, cada fração representará 100 nanossegundos; se precision for igual a 3, cada fração representará um milissegundo. Se o valor de precision for zero, o valor de fractions também deverá ser zero; caso contrário, DATETIME2FROMPARTS gerará um erro.

Essa função é capaz de ser remota para servidores do SQL Server 2012 (11.x) e acima. Ela não é remota para servidores que têm uma versão anterior ao SQL Server 2012 (11.x).

Exemplos

a. Um exemplo sem frações de um segundo

SELECT DATETIME2FROMPARTS ( 2010, 12, 31, 23, 59, 59, 0, 0 ) AS Result;

Este é o conjunto de resultados.

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

B. Exemplo simples com frações de um segundo

Este exemplo demonstra o uso dos parâmetros fractions e precision:

  1. Quando fractions tem um valor igual a 5 e precision tem um valor igual a 1, o valor de fractions representa 5/10 de um segundo.

  2. Quando fractions tem um valor igual a 50 e precision tem um valor igual a 2, o valor de fractions representa 50/100 de um segundo.

  3. Quando fractions tem um valor igual a 500 e precision tem um valor igual a 3, o valor de fractions representa 500/1.000 de um segundo.

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

Este é o conjunto de resultados.

----------------------  
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)

Confira também

datetime2 (Transact-SQL)