YEAR (Transact-SQL)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Renvoie un entier qui représente l’année de la date spécifiée.

Pour obtenir une vue d’ensemble de tous les types de données et fonctions de date et d’heure Transact-SQL, consultez Types de données et fonctions de date et d’heure (Transact-SQL).

Conventions de la syntaxe Transact-SQL

Syntaxe

YEAR ( date )

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Arguments

date
Expression qui peut être résolue en valeur time, date, smalldatetime, datetime, datetime2 ou datetimeoffset. L’argument date peut être une expression, une expression de colonne, une variable définie par l’utilisateur ou un littéral de chaîne.

Types de retour

int

Valeur de retour

YEAR renvoie la même valeur que DATEPART (year, date).

Si date contient uniquement une partie heure, la valeur renvoyée est 1900, l’année de base.

Exemples

L'instruction suivante retourne 2010. Il s'agit du numéro de l'année.

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

L'instruction suivante retourne 1900, 1, 1. L’argument pour date est le chiffre 0. SQL Server interprète 0 comme le 1er janvier 1900.

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

Exemples : Azure Synapse Analytics et Analytics Platform System (PDW)

L'instruction suivante retourne 1900, 1, 1. L’argument pour date est le chiffre 0. SQL Server interprète 0 comme le 1er janvier 1900.

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

Voir aussi

CAST et CONVERT (Transact-SQL)