WEEKDAYNAME |
Nom du jour de semaine |
|---|---|
| Visual Basic | |
Syntaxe
| Function 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 | ||
| 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
- La fonction WeekdayName permet d'obtenir le nom anglais complet d'un jour de la semaine à partir de sa position numérique (de 1 à 7). Elle est particulièrement utile pour convertir les résultats de la fonction Weekday en noms lisibles.
- Le paramètre number détermine le jour de la semaine, où 1 correspond généralement à dimanche (vbSunday), sauf si le paramètre firstdayofweek est modifié. Ce lien avec la constante rend le code plus lisible et compréhensible.
- Le paramètre optionnel abbreviate permet de récupérer une version abrégée du nom du jour, comme "Mon" au lieu de "Monday". Cela est pratique dans des interfaces compactes, ou pour l'affichage dans des calendriers ou des menus déroulants.
- Le paramètre firstdayofweek peut affecter la manière dont les jours sont interprétés. En modifiant ce paramètre, on peut adapter la fonction à des conventions culturelles différentes, comme une semaine débutant le lundi (européen) plutôt que le dimanche (américain).
- Bien que la fonction retourne les noms en anglais, cela peut poser problème dans des applications destinées à un public non anglophone. Il faudra alors prévoir une traduction manuelle ou une cartographie vers des étiquettes localisés.
- L'utilisation de WeekdayName permet d'éviter des structures conditionnelles ou des tableaux personnalisés pour faire correspondre un nombre à un jour. Cela simplifie le code et le rend plus lisible et maintenable.
- Cette fonction est très utile dans les rapports, les interfaces utilisateur, ou les systèmes de planning, où il est plus naturel pour un utilisateur de voir "Wednesday" que "4", par exemple.
- Il est important de valider la valeur passée dans le paramètre number, car un nombre hors plage (inférieur à 1 ou supérieur à 7) provoquera une erreur. Un contrôle préalable ou une gestion des exceptions est donc recommandé.
Exemple
Voici un exemple d'une utilisation typique de cette fonction :
- Sub Main()
- Dim S As String
- Dim I As Integer
- S = ""
- For I = 1 To 7
- S = S & WeekDayName(I) & ","
- Next
- S = s & vbCrLF
- For I = 1 To 7
- S = S & WeekDayName(I,true) & ","
- Next
- S = s & vbCrLF
- For I = 1 To 7
- S = S & WeekDayName(1,true,I) & ","
- Next
- S = s & vbCrLF
- MsgBox S
- End Sub
on obtiendra le résultat suivant :
dimanche,lundi,mardi,mercredi,jeudi,vendredi,samedi,dim.,lun.,mar.,mer.,jeu.,ven.,sam.,
dim.,lun.,mar.,mer.,jeu.,ven.,sam.,
Dernière mise à jour : Lundi, le 19 novembre 2012