YEAR |
Année |
|---|---|
| Visual Basic | |
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 extrait uniquement la composante "année" d'une date fournie en paramètre. Cela permet de traiter ou de comparer facilement des années, sans avoir à manipuler manuellement la structure complète de la date.
- Elle retourne une valeur de type Long, ce qui garantit que même les années éloignées dans le futur ou dans le passé sont correctement gérées. Cela inclut les dates historiques ou projetées.
- L'un des usages typiques de cette fonction est la classification chronologique : regrouper des événements par année, effectuer des statistiques annuelles, ou générer des rapports par exercice fiscal.
- YEAR est souvent utilisée avec d'autres fonctions comme MONTH ou DAY lorsqu'on souhaite décomposer une date en ses éléments constitutifs pour un affichage ou une logique conditionnelle spécifique.
- Cette fonction est insensible à l'heure contenue dans la variable Date. Elle se concentre uniquement sur la partie calendaire, ce qui évite toute confusion avec les fonctions de manipulation d'heure comme HOUR ou TIMEVALUE.
- Il est important que la valeur passée à YEAR soit bien une date valide ; si une chaîne non convertible ou une variable vide est fournie, une erreur d'exécution peut survenir.
- YEAR(Date) est un appel courant pour obtenir l'année courante, car la fonction Date retourne la date système du jour. Cela permet par exemple de vérifier dynamiquement si un événement a lieu cette année.
- Dans les bases de données Access ou les scripts VBA, YEAR permet aussi de filtrer les enregistrements d'une table sur une période précise, en extrayant l'année directement depuis un champ DateTime.
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
Dernière mise à jour : Lundi, le 19 novembre 2012