YEAR (Transact-SQL)

Articolo
12/22/2023

Si applica a:SQL Server database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Analytics Platform System (PDW)

Restituisce un valore integer che rappresenta l'anno nel valore date specificato.

Per una panoramica di tutte le funzioni e i tipi di dati di data e ora Transact-SQL, vedere Funzioni e tipi di dati di data e ora (Transact-SQL).

Convenzioni di sintassi Transact-SQL

Sintassi

YEAR ( date )

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.

Argomenti

date
Espressione che può essere risolta in un valore time, date, smalldatetime, datetime, datetime2 o datetimeoffset. L'argomento date può essere costituito da un'espressione, un'espressione di colonna, una variabile definita dall'utente o un valore letterale stringa.

Tipi restituiti

int

Valore restituito

YEAR restituisce lo stesso valore di DATEPART (year, date).

Se date contiene solo la parte dell'ora, il valore restituito è 1900, l'anno di base.

Esempi

L'istruzione seguente restituisce 2010. Si tratta del numero dell'anno.

SELECT YEAR('2010-04-30T01:01:01.1234567-07:00');

L'istruzione seguente restituisce 1900, 1, 1. L'argomento di date è il numero 0. In SQL Server, 0 viene interpretato come 1 gennaio 1900.

SELECT YEAR(0), MONTH(0), DAY(0);

Esempi: Azure Synapse Analytics e Piattaforma di strumenti analitici (PDW)