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