Partilhar via


DATETIMEFROMPARTS (Transact-SQL)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)

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 )

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 obrigatório tiver um valor inválido. DATETIMEFROMPARTS retorna NULL se pelo menos um argumento obrigató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;

Veja a seguir o conjunto de resultados.

2010-12-31 23:59:59.000