Partilhar via


YEAR (Transact-SQL)

Retorna um inteiro que representa o ano da date especificada.

Para obter uma visão geral de todos os tipos de dados e funções de data e hora do Transact-SQL, consulte Funções Date e Time (Transact-SQL). Para obter informações e exemplos comuns aos tipos de dados e funções de data e hora, consulte Usando dados de data e hora.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

YEAR ( date )

Argumentos

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

Tipos de retorno

int

Valor de retorno

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

Se date contiver só uma parte de hora, o valor de retorno será 1900, o ano base.

Exemplos

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

SELECT YEAR('2007-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);

Consulte também

Referência