Partilhar via


DATETIMEFROMPARTS (Transact-SQL)

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. Para obter mais informações sobre intervalos válidos, consulte datetime.

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 gera um erro se pelo menos um argumento necessário tiver um valor inválido. DATETIMEFROMPARTS retorna NULL se pelo menos um argumento necessário tiver um NULL valor.

Essa função pode ser remota para servidores SQL Server 2012 (11.x) e versões posteriores. Ele não é remoto para servidores que executam o SQL Server 2012 (11.x) e versões anteriores.

Exemplos

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

Este é o conjunto de resultados.

2010-12-31 23:59:59.000