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

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