YEAR

Syntaxe

Paramètres

Description

Cette fonction retourne l'année de la date spécifié.

Remarques

• La fonction extrait l'année d'une date : La fonction Year permet de récupérer uniquement la composante correspondant à l'année d'une valeur de type Date/Heure. Elle retourne un entier représentant l'année civile. Cette fonction est très utilisée pour les analyses chronologiques et les traitements statistiques.
• Le résultat est un nombre entier : Contrairement à la valeur d'origine, qui est de type Date/Heure, Year retourne un entier tel que 2024, 2025 ou 2026. Cette valeur peut être utilisée directement dans des calculs, des comparaisons ou des regroupements. Elle facilite le traitement des données calendaires.
• Le paramètre doit contenir une date valide : La fonction attend une valeur de type Date/Heure ou une expression pouvant être convertie en date. Si la conversion est impossible, Microsoft Access génère une erreur. Lorsque les données proviennent d'une saisie utilisateur, il est conseillé de vérifier leur validité avec IsDate.
• La partie heure est totalement ignorée : Si la valeur contient également une heure, celle-ci n'a aucune influence sur le résultat. Par exemple, Year(#15/08/2026 18:45:30#) retourne simplement 2026. La fonction s'intéresse uniquement à la composante correspondant à l'année.
• Elle est très utilisée pour regrouper les données : Dans les requêtes Access, Year permet de regrouper facilement les enregistrements par année. Il devient ainsi possible d'obtenir le nombre de ventes, de commandes ou de factures pour chaque année civile. Cette technique est largement employée dans les rapports statistiques.
• Elle est souvent combinée avec d'autres fonctions de date : Year est fréquemment utilisée avec Month, Day, DateDiff, DateAdd, DateSerial ou Format. Ensemble, ces fonctions permettent de réaliser des traitements calendaires très complets. Elles constituent la base de nombreux calculs liés aux dates dans Microsoft Access.
• Elle est disponible dans les requêtes et dans le code VBA : La fonction Year peut être utilisée dans les requêtes SQL, les formulaires, les états, les macros ainsi que dans les modules VBA. Elle permet d'extraire directement l'année dans une expression Access sans programmation supplémentaire. Son comportement reste identique dans tous les environnements d'utilisation.
• Elle est utile pour les comparaisons chronologiques : En extrayant uniquement l'année, il devient facile de comparer des enregistrements appartenant à différentes périodes. Par exemple, une application peut sélectionner toutes les données correspondant à une année donnée ou comparer les résultats entre plusieurs années. Cette approche simplifie les traitements temporels.
• Elle facilite la création de rapports annuels : Les applications de comptabilité, de gestion commerciale ou de ressources humaines produisent fréquemment des rapports regroupés par année. Year permet de générer rapidement cette information sans manipulation complexe des dates. Elle contribue ainsi à produire des analyses claires et pertinentes.
• La fonction est compatible avec toutes les versions modernes de Microsoft Access : La fonction Year est disponible depuis les premières versions de Microsoft Access intégrant VBA et son fonctionnement est demeuré stable au fil des années. Elle est compatible avec Access 2000, Access XP, Access 2003, Access 2007, Access 2010, Access 2013, Access 2016 ainsi qu'avec Microsoft 365. Cette stabilité garantit que les applications utilisant cette fonction continueront de produire les mêmes résultats lors des migrations vers des versions plus récentes d'Access.

Exemple

Voici un exemple de comment utiliser la fonction Year dans Microsoft Access :

Exemple de code VBA

La fonction Year peut être utilisée dans le code VBA de Microsoft Access.

Par exemple :

Dans cet exemple, la variable appelée LYear contiendrait désormais la valeur 2002.