ANO (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsEndpoint de análise SQL no Microsoft FabricArmazém no Microsoft FabricBanco de dados SQL no Microsoft Fabric

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 )  

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

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