YEAR (Transact-SQL)

Retourne 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). Pour obtenir des informations et des exemples communs aux types de données et fonctions de date et d'heure, consultez Utilisation des données de date et d'heure.

Icône Lien de rubriqueConventions de syntaxe Transact-SQL

Syntaxe

YEAR ( date )

Arguments

  • date
    Expression qui peut être résolue en une 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 retourne la même valeur que DATEPART (year, date).

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

Exemples

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

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

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

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

Voir aussi

Référence