YEAR (Transact-SQL)
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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de