Year

Syntaxe

Paramètres

Description

Cette fonction permet de retourner l'année d'une date.

Remarques

• La fonction YEAR permet d'extraire l'année à partir d'une date complète. Elle retourne un entier représentant l'année de la date passée en paramètre, par exemple 2025 pour une date comme "22/04/2025". Cela facilite les traitements temporels dans les scripts sans avoir à manipuler la date sous forme de chaîne de caractères.
• Le paramètre n doit impérativement être une expression de type date. Si vous passez une chaîne de caractères qui ne représente pas correctement une date, VBScript générera une erreur. Il est donc conseillé d'utiliser des fonctions comme IsDate en amont pour valider l'entrée.
• Cette fonction est particulièrement utile pour filtrer ou regrouper des données par année. Par exemple, dans un script analysant des ventes, vous pouvez extraire l'année de chaque opération pour ensuite faire un total annuel ou générer un rapport chronologique.
• Vous pouvez combiner YEAR avec d'autres fonctions comme MONTH ou DAY pour obtenir une décomposition complète d'une date. Cela permet de réaliser des opérations complexes comme vérifier si deux dates appartiennent à la même année, même si elles diffèrent par le jour ou le mois.
• Dans des applications comme les bilans comptables ou les statistiques, YEAR permet d'identifier rapidement l'année fiscale ou civile d'un enregistrement. Cela permet aussi de générer dynamiquement des titres ou des résumés, comme "Rapport annuel 2023".
• L'usage de YEAR est aussi courant dans les fonctions de contrôle ou de validation. Par exemple, si vous souhaitez vérifier que la date saisie par l'utilisateur ne remonte pas à plus de 5 ans, vous pouvez comparer l'année actuelle (via YEAR(Date)) avec l'année de la date fournie.
• La fonction YEAR retourne une valeur entière, ce qui la rend directement exploitable pour des calculs. Par exemple, il est facile de soustraire deux années pour calculer une durée ou un écart en années entre deux événements.
• Cette fonction s'insère naturellement dans des boucles ou conditions. Par exemple, dans un traitement automatisé de fichiers datés, vous pouvez utiliser YEAR pour ne garder que ceux concernant l'année en cours. Cela rend le code VBScript plus lisible et plus simple à maintenir.