DATETIMEFROMPARTS (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 datetime para os argumentos de data e hora especificados.

Convenções de sintaxe de Transact-SQL

Sintaxe

DATETIMEFROMPARTS ( year, month, day, hour, minute, seconds, milliseconds )

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 horas.

minute
Uma expressão de inteiro que especifica minutos.

segundos
Uma expressão de inteiro que especifica segundos.

milliseconds
Uma expressão de inteiro que especifica milissegundos.

Tipos de retorno

datetime

Comentários

DATETIMEFROMPARTS retorna um valor datetime completamente inicializado. DATETIMEFROMPARTS gerará um erro se pelo menos um argumento necessário tiver um valor inválido. DATETIMEFROMPARTS retornará nulo se pelo menos um argumento necessário tiver um valor nulo.

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

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

Este é o conjunto de resultados.

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

Confira também

datetime (Transact-SQL)