MONTHNAME |
Nom de mois |
|---|---|
| Access 2019, Access 2016, Access 2013, Access 2010, Access 2007, Access 2003, Access XP, Access 2000 | Microsoft Access |
Syntaxe
| MonthName(number, [abbreviate]) |
Paramètres
| Nom | Description | |
|---|---|---|
| number | Ce paramètre permet d'indiquer le mois : | |
| Valeur | Description | |
| 1 | Cette valeur permet d'indiquer le mois de Janvier | |
| 2 | Cette valeur permet d'indiquer le mois de Février | |
| 3 | Cette valeur permet d'indiquer le mois de Mars | |
| 4 | Cette valeur permet d'indiquer le mois d'Avril | |
| 5 | Cette valeur permet d'indiquer le mois de Mai | |
| 6 | Cette valeur permet d'indiquer le mois de Juin | |
| 7 | Cette valeur permet d'indiquer le mois de Juillet | |
| 8 | Cette valeur permet d'indiquer le mois d'Août | |
| 9 | Cette valeur permet d'indiquer le mois de Septembre | |
| 10 | Cette valeur permet d'indiquer le mois d'Octobre | |
| 11 | Cette valeur permet d'indiquer le mois de Novembre | |
| 12 | Cette valeur permet d'indiquer le mois de Décembre | |
| abbreviate | Ce paramètre permet d'indiquer s'il faut retourner une abréviation (true) plutôt que le nom complet (false). | |
Description
Cette fonction retourne le nom anglais du mois de la date spécifié.
Remarques
- La fonction retourne le nom d'un mois à partir de son numéro : La fonction MonthName convertit un numéro de mois compris entre 1 et 12 en son nom correspondant. Par exemple, la valeur 1 retourne January dans un environnement anglais ou Janvier selon la langue du système. Cette fonction facilite l'affichage de dates sous une forme plus lisible.
- Le premier paramètre doit correspondre à un mois valide : Le paramètre number représente le numéro du mois et doit normalement être compris entre 1 et 12. Une valeur en dehors de cette plage peut provoquer une erreur ou produire un résultat inattendu. Il est donc recommandé de valider cette valeur avant d'appeler la fonction.
- Le deuxième paramètre permet d'obtenir une abréviation : Le paramètre optionnel abbreviate est un booléen indiquant si le résultat doit être abrégé. Lorsqu'il vaut True, la fonction retourne généralement une forme courte comme Jan, Feb ou Mar. Si ce paramètre est omis ou vaut False, le nom complet du mois est renvoyé.
- Le résultat dépend de la langue de l'environnement d'exécution : Bien que certaines documentations présentent les noms anglais des mois, MonthName utilise généralement les paramètres régionaux du système d'exploitation. Ainsi, sur un Windows configuré en français, la fonction retourne Janvier, Février, Mars,... Cette caractéristique facilite l'internationalisation des applications.
- La fonction retourne une chaîne de caractères : Le résultat de MonthName est toujours une valeur de type String. Il peut être affiché dans un formulaire, un état ou une requête, ou encore concaténé avec d'autres textes. Comme il s'agit d'une chaîne, il ne peut pas être utilisé directement dans des calculs calendaires.
- Elle est souvent utilisée avec la fonction Month : Il est très courant de combiner Month et MonthName. La fonction Month extrait le numéro du mois d'une date, tandis que MonthName transforme ce numéro en un nom lisible par l'utilisateur. Cette combinaison est particulièrement utile dans les rapports et les tableaux statistiques.
- Elle améliore la lisibilité des rapports et des interfaces : Afficher le nom d'un mois est généralement plus compréhensible que présenter uniquement son numéro. Par exemple, Mars est souvent plus parlant que la valeur 3 dans un rapport ou un graphique. Cette fonction contribue ainsi à améliorer la présentation des données.
- Elle est disponible dans les requêtes et dans le code VBA : La fonction MonthName peut être utilisée dans les requêtes SQL, les formulaires, les états, les macros ainsi que dans les modules VBA. Elle permet de produire directement un affichage textuel des mois sans avoir recours à des tables de correspondance. Son comportement reste identique quel que soit le contexte d'utilisation.
- Elle est utile pour générer des calendriers et des statistiques : Les applications de gestion utilisent fréquemment MonthName pour construire des calendriers, des rapports mensuels ou des tableaux de bord. Elle permet également de présenter les résultats d'une analyse par mois de manière plus conviviale. Cette fonction est donc très appréciée dans les outils de reporting.
- La fonction est compatible avec toutes les versions modernes de Microsoft Access : La fonction MonthName 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 fonctionner correctement lors des migrations vers des versions plus récentes d'Access.
Exemple
Voici un exemple de comment utiliser la fonction MonthName dans Microsoft Access :
MonthName (3)
Résultat: 'March'
MonthName (3, TRUE)
Résultat: 'Mar'
MonthName (7, FALSE)
Résultat: 'July'
Exemple de code VBA
La fonction MonthName peut être utilisée dans le code VBA de Microsoft Access.
Par exemple :
Dim LValue As String
LValue = MonthName (3, TRUE)
Dans cet exemple, la variable appelée LValue contiendrait désormais la valeur de 'Mar'.
Dernière mise à jour : Mardi, le 28 juillet 2015