WEEKDAY |
Jour de la semaine |
|---|---|
| Access 2019, Access 2016, Access 2013, Access 2010, Access 2007, Access 2003, Access XP, Access 2000 | Microsoft Access |
Syntaxe
| Weekday(date_value, [firstdayofweek] ) |
Paramètres
| Nom | Description | |||
|---|---|---|---|---|
| Date | Ce paramètre permet d'indiquer la date contenant l'expression à traiter | |||
| 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 | ||
Retour
| Valeur | Description |
|---|---|
| 1 | Cette valeur indique le Dimanche |
| 2 | Cette valeur indique le Lundi |
| 3 | Cette valeur indique le Mardi |
| 4 | Cette valeur indique le Mercredi |
| 5 | Cette valeur indique le Jeudi |
| 6 | Cette valeur indique le Vendredi |
| 7 | Cette valeur indique le Samedi |
Description
Cette fonction permet de retourner le numéro de jour de semaine (1 à 7) correspondant à la date spécifié.
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 numéro du jour de la semaine : La fonction Weekday permet de déterminer à quel jour de la semaine correspond une date donnée. Le résultat est un entier compris entre 1 et 7. Cette fonction est largement utilisée dans les applications de gestion de calendriers, de planification et de suivi d'activités.
- Le résultat dépend du premier jour de la semaine choisi : Le paramètre optionnel FirstDayOfWeek permet de définir quel jour doit être considéré comme le début de la semaine. Selon la valeur utilisée, le numéro associé à une même date peut être différent. Cette souplesse permet d'adapter le comportement de la fonction aux habitudes locales ou aux besoins de l'application.
- Le paramètre peut utiliser les paramètres régionaux du système : Lorsque FirstDayOfWeek vaut vbUseSystem (0), Microsoft Access utilise les paramètres régionaux de Windows pour déterminer le premier jour de la semaine. Ainsi, le résultat peut varier selon la configuration de l'ordinateur. Cette option facilite l'internationalisation des applications.
- Elle retourne uniquement un numéro et non le nom du jour : Weekday fournit une valeur numérique comprise entre 1 et 7, mais ne retourne pas directement un nom comme « Lundi » ou « Mardi ». Pour obtenir le nom du jour, il est généralement nécessaire d'utiliser la fonction WeekdayName ou Format. Cette distinction offre davantage de flexibilité dans les traitements.
- Elle est très utilisée dans les calculs de calendrier : La fonction permet de déterminer si une date correspond à un jour ouvrable, à une fin de semaine ou à un jour particulier. Elle est couramment utilisée pour calculer des échéances, des horaires ou des périodes de travail. Cette fonctionnalité est essentielle dans de nombreuses applications professionnelles.
- Elle est souvent combinée avec d'autres fonctions de date : Weekday est fréquemment utilisée avec Date, Now, DateAdd, DateDiff, Day, Month ou Year. Ensemble, ces fonctions permettent de réaliser des traitements calendaires très complets. Elles constituent la base de nombreux calculs liés au temps dans Microsoft Access.
- Elle est disponible dans les requêtes et dans le code VBA : La fonction Weekday peut être utilisée dans les requêtes SQL, les formulaires, les états, les macros ainsi que dans les modules VBA. Elle permet d'extraire directement le numéro du jour de la semaine dans une expression Access. Son comportement reste identique dans tous les contextes d'utilisation.
- Les constantes VBA ne sont pas disponibles dans les requêtes Access : Les constantes telles que vbMonday, vbSunday ou vbUseSystem peuvent être utilisées dans le code VBA, mais pas directement dans les requêtes Access. Dans une requête, il faut employer leur valeur numérique correspondante. Cette particularité est importante à connaître pour éviter des erreurs lors de la création des requêtes.
- Elle facilite le filtrage et le regroupement des données : Le résultat retourné par Weekday peut être utilisé pour sélectionner tous les enregistrements correspondant à un certain jour de la semaine. Par exemple, il est possible d'afficher uniquement les opérations effectuées le lundi ou durant la fin de semaine. Cette technique est très utilisée dans les rapports statistiques et les tableaux de bord.
- La fonction est compatible avec toutes les versions modernes de Microsoft Access : La fonction Weekday 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 des résultats cohérents lors des migrations vers des versions plus récentes d'Access.
Exemple
Voici un exemple de comment utiliser la fonction Weekday dans Microsoft Access :
Weekday (#22/11/2003#)
Résultat: 7
Weekday (#22/11/2003#, vbThursday)
Résultat: 3
Weekday (#22/11/2003#, 5)
Résultat: 3
Weekday (#01/01/1998#)
Résultat: 5
Exemple de code VBA
La fonction Weekday peut être utilisée dans le code VBA de Microsoft Access.
Par exemple :
Dim LWeekday As Integer
LWeekday = Weekday(#12/03/2001#, vbSunday)
Dans cet exemple, la variable appelée LWeekday contiendrait désormais la valeur 2.
Dernière mise à jour : Mardi, le 28 juillet 2015