WEEKDAYNAME |
Nom du jour de la semaine |
|---|---|
| Access 2019, Access 2016, Access 2013, Access 2010, Access 2007, Access 2003, Access XP, Access 2000 | Microsoft Access |
Syntaxe
| WeekdayName(number, [abbreviate], [firstdayofweek] ) |
Paramètres
| Nom | Description | |||
|---|---|---|---|---|
| number | Ce paramètre permet d'indiquer le numéro du jour de la semaine : | |||
| Valeur | Constante | Description | ||
| 1 | vbSunday | Cette valeur indique le Dimanche | ||
| 2 | vbMonday | Cette valeur indique le Lundi | ||
| 3 | vbTuesday | Cette valeur indique le Mardi | ||
| 4 | vbWednesday | Cette valeur indique le Mercredi | ||
| 5 | vbThursday | Cette valeur indique le Jeudi | ||
| 6 | vbFriday | Cette valeur indique le Vendredi | ||
| 7 | vbSaturday | Cette valeur indique le Samedi | ||
| abbreviate | Ce paramètre permet d'indiquer qu'il faut retourner l'abréviation du nom. | |||
| firstdayofweek | Ce paramètre permet d'indiquer le premier jour de la semaine devant être calculé pour la semaine retourné : | |||
| Valeur | Constante | Description | ||
| 0 | vbUseSystem | Cette valeur permet d'indiquer qu'il faut utiliser le NLS (National Language Support) | ||
| 1 | vbSunday | Cette valeur indique le Dimanche | ||
| 2 | vbMonday | Cette valeur indique le Lundi | ||
| 3 | vbTuesday | Cette valeur indique le Mardi | ||
| 4 | vbWednesday | Cette valeur indique le Mercredi | ||
| 5 | vbThursday | Cette valeur indique le Jeudi | ||
| 6 | vbFriday | Cette valeur indique le Vendredi | ||
| 7 | vbSaturday | Cette valeur indique le Samedi | ||
Description
Cette fonction permet de retourner le nom anglais d'un jour de semaine.
Remarques
- Les constantes du VisualBasic (vb*) peuvent seulement être référencé dans un code VBA et ne sont donc pas accessible dans une requête Access.
- La fonction retourne le nom d'un jour de la semaine : La fonction WeekdayName convertit un numéro de jour compris entre 1 et 7 en son nom correspondant. Elle retourne une chaîne de caractères représentant le jour de la semaine. Cette fonction est particulièrement utile pour produire des affichages plus lisibles dans les formulaires et les rapports.
- Le résultat est une chaîne de caractères : Contrairement à Weekday, retournant un nombre, WeekdayName produit directement un texte. Par exemple, elle peut retourner "Sunday", "Monday" ou un autre nom de jour selon les paramètres utilisés. Cette représentation est mieux adaptée aux interfaces destinées aux utilisateurs.
- Le nom retourné dépend des paramètres régionaux : La documentation indique que la fonction retourne le nom anglais du jour, mais dans les versions modernes de Microsoft Access, le résultat dépend généralement de la langue et des paramètres régionaux du système d'exploitation. Ainsi, sur un système configuré en français, les noms peuvent être affichés en français. Ce comportement facilite l'internationalisation des applications.
- Le paramètre abbreviate permet d'obtenir une forme abrégée : Lorsque le paramètre abbreviate est positionné à True, la fonction retourne une version abrégée du nom du jour. Par exemple, elle peut retourner "Mon" au lieu de "Monday" ou "Lun" au lieu de "Lundi", selon la langue du système. Cette option est pratique lorsque l'espace d'affichage est limité.
- Le premier jour de la semaine est configurable : Le paramètre firstdayofweek permet de définir quel jour doit être considéré comme le premier de la semaine. Cette option influence l'interprétation du numéro fourni dans certains contextes. Elle permet d'adapter le comportement de la fonction aux conventions locales ou professionnelles.
- Elle est souvent utilisée avec Weekday : Une utilisation très courante consiste à appeler Weekday afin d'obtenir le numéro du jour correspondant à une date, puis à transmettre ce résultat à WeekdayName pour obtenir le nom du jour. Cette combinaison permet de convertir facilement une date en un libellé compréhensible. Elle est très utilisée dans les calendriers et les rapports.
- Elle est disponible dans les requêtes et dans le code VBA : La fonction WeekdayName peut être utilisée dans les modules VBA, les formulaires, les états et certaines expressions Access. Elle permet de produire directement un nom de jour sans devoir créer une table de correspondance. Son comportement est cohérent dans les différents contextes d'utilisation.
- Les constantes VBA ne sont pas utilisables dans les requêtes Access : Les constantes comme vbMonday, vbSunday ou vbUseSystem peuvent être utilisées dans les modules VBA, mais elles ne sont pas reconnues directement dans les requêtes SQL Access. Dans ces dernières, il faut utiliser leurs valeurs numériques correspondantes. Cette particularité est importante pour éviter des erreurs dans les expressions.
- Elle améliore la lisibilité des rapports et des formulaires : Afficher un nom de jour est généralement plus compréhensible qu'afficher un simple numéro compris entre 1 et 7. WeekdayName permet donc de rendre les rapports, les calendriers et les interfaces utilisateur plus conviviaux. Elle est particulièrement utile dans les applications de planification et de gestion des horaires.
- La fonction est compatible avec toutes les versions modernes de Microsoft Access : La fonction WeekdayName 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 WeekdayName dans Microsoft Access :
WeekdayName (3)
Résultat: 'Tuesday'
WeekdayName (3, TRUE)
Résultat: 'Tue'
WeekdayName (3, TRUE, vbMonday)
Résultat: 'Wed'
WeekdayName (3, TRUE, 2)
Résultat: 'Wed'
Exemple de code VBA
La fonction WeekdayName peut être utilisée dans le code VBA de Microsoft Access.
Par exemple :
Dim LValue As String
LValue = WeekdayName (3, TRUE, vbMonday)
Dans cet exemple, la variable appelée LValue contiendrait désormais la valeur «Wed».
Dernière mise à jour : Mardi, le 28 juillet 2015