YEAR (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)

Retorna um inteiro que representa o ano da data especificada.

Para ter uma visão geral de todas as funções e tipos de dados de data e hora do Transact-SQL, confira Funções e tipos de dados de data e hora (Transact-SQL).

Convenções de sintaxe de Transact-SQL

Sintaxe

YEAR ( date )

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

date
É uma expressão que pode ser resolvida em um valor de time, date, smalldatetime, datetime, datetime2 ou datetimeoffset. O argumento date pode ser uma expressão, uma expressão de coluna, uma variável definida pelo usuário ou um literal de cadeia de caracteres.

Tipos de retorno

int

Valor retornado

YEAR retorna o mesmo valor que DATEPART (year, date).

Se date contiver apenas uma parte de hora, o valor retornado será 1900, o ano base.

Exemplos

A instrução a seguir retorna 2010. Este é o número do ano.

SELECT YEAR('2010-04-30T01:01:01.1234567-07:00');

A instrução a seguir retorna 1900, 1, 1. O argumento para date é o número 0. SQL Server interpreta 0 como janeiro 1, 1900.

SELECT YEAR(0), MONTH(0), DAY(0);

Exemplos: Azure Synapse Analytics e PDW (Analytics Platform System)

A instrução a seguir retorna 1900, 1, 1. O argumento para date é o número 0. SQL Server interpreta 0 como janeiro 1, 1900.

SELECT TOP 1 YEAR(0), MONTH(0), DAY(0);

Consulte Também

CAST e CONVERT (Transact-SQL)