Partilhar via


DATEFROMPARTS (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 date que é mapeado para os valores de dia, mês e ano especificados.

Convenções de sintaxe de Transact-SQL

Sintaxe

DATEFROMPARTS ( year, month, day )  

Argumentos

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

month
Uma expressão de inteiro que especifica um mês, de 1 a 12.

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

Tipos de retorno

date

Comentários

DATEFROMPARTS retorna um valor date com a parte de data definida como o ano, mês e dia especificados e a parte de hora definida como o padrão. Para argumentos inválidos, DATEFROMPARTS gerará um erro. DATEFROMPARTS retornará nulo se pelo menos um argumento necessário tiver um valor nulo.

Essa função pode operar comunicação remota para servidores SQL Server 2012 (11.x) e posteriores. Ela não pode operar comunicação remota para servidores com uma versão inferior a SQL Server 2012 (11.x).

Exemplos

Este exemplo mostra a função DATEFROMPARTS em ação.

SELECT DATEFROMPARTS ( 2010, 12, 31 ) AS Result;  

Veja a seguir o conjunto de resultados.

Result  
----------------------------------  
2010-12-31  
  
(1 row(s) affected)  

Confira também

data (Transact-SQL)