DATEFROMPARTS (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 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 )

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, 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;

Este é o conjunto de resultados.

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

Confira também

data (Transact-SQL)