Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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
Esta função devolve um valor datetime2 para os argumentos de data e hora especificados. O valor devolvido tem uma precisão especificada pelo argumento da precisão.
Transact-SQL convenções de sintaxe
Sintaxe
DATETIME2FROMPARTS ( year, month, day, hour, minute, seconds, fractions, precision )
Arguments
ano
Uma expressão inteira que especifica um ano.
mês
Uma expressão inteira que especifica um mês.
Dia
Uma expressão inteira que especifica um dia.
hora
Uma expressão inteira que especifica as horas.
minuto
Uma expressão inteira que especifica os minutos.
segundos
Uma expressão inteira que especifica os segundos.
frações
Uma expressão inteira que especifica um valor fracionário de segundos.
precisão
Uma expressão inteira que especifica a precisão do valor datetime2 que DATETIME2FROMPARTS irá devolver.
Tipos de devolução
datetime2(precisão)
Observações
DATETIME2FROMPARTS devolve um valor datetime2 totalmente inicializado.
DATETIME2FROMPARTS gerará um erro se pelo menos um argumento exigido tiver um valor inválido.
DATETIME2FROMPARTS devolve nulo se pelo menos um argumento exigido tiver valor nulo. No entanto, se o argumento de precisão tiver valor nulo, DATETIME2FROMPARTS gerará um erro.
O argumento das frações depende do argumento da precisão . Por exemplo, para um valor de precisão de 7, cada fração representa 100 nanossegundos; para uma precisão de 3, cada fração representa um milissegundo. Para um valor de precisão zero, o valor das frações também deve ser zero; caso contrário, DATETIME2FROMPARTS gerará um erro.
Esta função pode ser transferida remotamente para servidores SQL Server 2012 (11.x) e superiores. Não está remotamente ligado a servidores que tenham uma versão abaixo do SQL Server 2012 (11.x).
Examples
A. Um exemplo sem frações de segundo
SELECT DATETIME2FROMPARTS ( 2010, 12, 31, 23, 59, 59, 0, 0 ) AS Result;
Aqui está o conjunto de resultados.
Result
---------------------------
2010-12-31 23:59:59.0000000
(1 row(s) affected)
B. Exemplo com frações de segundo
Este exemplo mostra a utilização das frações e parâmetros de precisão :
Quando frações têm valor 5 e precisão 1, o valor das frações representa 5/10 de segundo.
Quando frações têm um valor de 50 e a precisão de 2, o valor das frações representa 50/100 de segundo.
Quando frações têm um valor de 500 e a precisão de 3, então o valor de frações representa 500/1000 de 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
Aqui está 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)