YEAR |
Année |
|---|---|
| ASP 3.0 | |
Syntaxe
| Function YEAR(n As Date) As Long |
Paramètres
| Nom | Description |
|---|---|
| n | Ce paramètre permet d'indiquer la date contenant l'expression à traiter |
Description
Cette fonction retourne l'année d'une date.
Remarques
- La fonction YEAR permet d'extraire rapidement l'année d'une date complète : YEAR est une fonction très pratique pour obtenir la composante "année" d'une date fournie. Elle évite d'avoir à manipuler manuellement des chaînes ou à effectuer des calculs sur le format de date, rendant les traitements temporels plus directs et lisibles.
- Elle retourne toujours une valeur numérique de type Long : Le résultat de YEAR(n) est un entier long représentant l'année (par exemple, 2025). Cela facilite les comparaisons ou les tris chronologiques, et permet aussi d'intégrer directement la valeur dans des calculs ou des conditions logiques, sans conversion supplémentaire.
- Utile dans des contextes de regroupement ou de filtrage annuel : Lorsqu'on travaille avec des enregistrements datés (commandes, événements,...), la fonction YEAR permet de filtrer les données par année, ou de créer des regroupements statistiques comme le total des ventes par année. Elle est ainsi très utilisée dans les rapports ou les graphiques temporels.
- Fonctionne avec tout type de valeur de date, qu'elle soit littérale ou dynamique : Que la date soit fournie sous forme littérale (#01/01/2023#), via une variable, ou récupérée dynamiquement (comme avec Now ou Date()), la fonction YEAR est capable de l'interpréter et d'en extraire l'année sans difficulté. Cela la rend très souple à l'usage.
- Particulièrement utile pour détecter les changements d'année : Dans un système où l'on veut lancer certaines opérations au passage à une nouvelle année (archivage, réinitialisation de compteurs, notifications.), l'usage de YEAR sur la date actuelle permet de comparer facilement l'année courante à la précédente, et ainsi déclencher des actions programmées.
- Fonction complémentaire d'autres fonctions temporelles comme MONTH et DAY : YEAR fait partie d'un trio classique avec MONTH et DAY, permettant de décomposer n'importe quelle date en ses éléments constitutifs. Ensemble, ces fonctions permettent une manipulation fine des dates, ce qui est fondamental dans le traitement de données chronologiques.
- Facile à intégrer dans des chaînes de texte explicatives ou des interfaces utilisateur : Grâce à sa simplicité, YEAR peut être utilisé pour insérer l'année actuelle dans des textes comme "Rapport annuel 2024" ou "Historique des ventes de 2023". Cela améliore l'interaction utilisateur en rendant les contenus temporellement pertinents et à jour.
- Ne gère pas directement les formats, mais uniquement la valeur numérique de l'année : Il est important de noter que YEAR ne modifie pas le format de la date ni ne retourne un texte - elle extrait uniquement la partie "année" sous forme numérique. Pour un affichage formaté complet, il faut donc combiner cette fonction avec d'autres ou formater la date autrement.
Exemple
Voici un exemple d'une utilisation typique de cette fonction :
on obtiendra le résultat suivant :
2000-01-01 = 200008-01-01 = 2001
74-01-01 = 1974
02-02-2001 = 2001
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Vendredi, le 10 octobre 2014