Weekday |
Jour de la semaine |
| VBScript |
Syntaxe
|
Function WEEKDAY(Date)
|
|
Function WEEKDAY(Date,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é : |
| 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 |
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 retourne le jour de la semaine d'une date.
Remarques
- La fonction Weekday est utilisée pour obtenir le jour de la semaine correspondant à une date donnée. Elle retourne un entier compris entre 1 et 7, où chaque
valeur représente un jour, par défaut à partir du dimanche (1) jusqu'au samedi (7). C'est une fonction très pratique lorsqu'on veut effectuer des traitements
spécifiques selon le jour de la semaine.
- L'un des atouts de la fonction Weekday est la possibilité de personnaliser le premier jour de la semaine grâce à un deuxième paramètre facultatif. Par exemple,
si vous définissez FirstDayOfWeek à 2, alors le calcul commencera à partir du lundi au lieu du dimanche, ce qui est utile dans de nombreuses conventions européennes
ou professionnelles.
- La précision dans le choix du paramètre FirstDayOfWeek permet d'adapter Weekday à différents contextes culturels ou métiers. Cela rend la fonction plus souple
et évite des confusions dans les systèmes où la semaine ne commence pas toujours le dimanche. C'est un détail important dans le développement internationalisé.
- Cette fonction peut être utilisée dans des scripts d'automatisation pour déclencher des actions selon le jour. Par exemple, lancer une tâche uniquement les lundis
ou exclure les fins de semaines. Weekday devient alors un outil de contrôle logique utile dans la gestion de calendriers ou de plannings.
- Il faut noter que la valeur de retour de Weekday dépend entièrement du jour de départ choisi. Ainsi, une même date peut retourner une valeur différente selon que
vous définissez le dimanche ou le lundi comme premier jour de la semaine. Cela doit être pris en compte pour éviter des erreurs d'interprétation.
- Le fait que la fonction retourne une valeur numérique rend son utilisation simple dans des structures conditionnelles, telles que If, Select Case, ou des boucles.
Par exemple, un test comme If Weekday(Date) = 1 Then peut servir à détecter si une date tombe un dimanche, ce qui est particulièrement clair et lisible dans le code.
- Lorsque vous utilisez Weekday, il est préférable de documenter clairement vos choix concernant FirstDayOfWeek, surtout si vous travaillez en équipe ou si le script
est amené à être réutilisé. Cela évite les mauvaises surprises et les comportements inattendus dus à un jour de début mal compris ou mal configuré.
- La fonction Weekday peut également être utile pour l'analyse statistique des dates. Par exemple, si vous voulez savoir quels jours de la semaine sont les
plus utilisés dans une série de données, vous pouvez appliquer Weekday à chaque date et faire un décompte. Cela en fait un outil simple mais puissant dans les
traitements de séries temporelles.
Dernière mise à jour : Lundi, le 19 Avril 2021