Renvoie une donnée de type Variante (Entier) contenant un nombre entier représentant le jour de la semaine.
Syntaxe
Weekday(date [, firstdayofweek ] )
La syntaxe de la fonction Weekday contient les arguments suivants :
| Argument | Description |
|---|---|
| Date | Obligatoire. Variant, expression numérique, expression de chaîne ou toute combinaison de ces éléments pouvant représenter une date. Si date contient Null, null est retourné. |
| premierjoursem | Facultatif. Constante qui spécifie le premier jour de la semaine. S’il n’est pas spécifié, vbSunday est supposé. |
Paramètres
L’argument firstdayofweek contient les paramètres suivants :
| Constante | Valeur | Description |
|---|---|---|
| vbUseSystem | 0 | Utilisez le paramètre d’API NLS. |
| vbSunday | 1 | Dimanche (valeur par défaut) |
| vbMonday | 2 | Lundi |
| vbTuesday | 3 | Mardi |
| vbWednesday | 4 | Mercredi |
| vbThursday | 5 | Jeudi |
| vbFriday | 6 | Vendredi |
| vbSaturday | 7 | Samedi |
Valeurs de retour
La fonction Weekday peut retourner l’une des valeurs suivantes :
| Constante | Valeur | Description |
|---|---|---|
| vbSunday | 1 | Dimanche |
| vbMonday | 2 | Lundi |
| vbTuesday | 3 | Mardi |
| vbWednesday | 4 | Mercredi |
| vbThursday | 5 | Jeudi |
| vbFriday | 6 | Vendredi |
| vbSaturday | 7 | Samedi |
Remarques
Si le paramètre de propriété Calendar est grégorien, l’entier retourné représente le jour grégorien de la semaine pour l’argument date. Si le calendrier est Hijri, l’entier retourné représente le jour Hijri de la semaine pour l’argument date. Pour les dates Hijri, le numéro d’argument est toute expression numérique qui peut représenter une date et/ou une heure comprise entre le 1/1/100 (2 août 718) et le 3/4/9666 (31 décembre grégorien, 9999).
Exemples de requêtes
| Expression | Résultats |
|---|---|
| SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales ; | Retourne les valeurs du champ « DateofSale » et le nombre représentant le « Weekday » de ces valeurs de date. (Par défaut, le dimanche est considéré comme le premier jour de la semaine ; 1). |
| SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales ; | Retourne les valeurs du champ « DateofSale » et le nombre représentant le « Weekday » de ces valeurs de date. (en considérant le lundi comme premier jour de la semaine). |
Exemple VBA
Remarque
Les exemples suivants illustrent l’utilisation de cette fonction dans un module Visual Basic pour Applications (VBA). Pour plus d’informations sur l’utilisation de VBA, sélectionnez Référence du développeur dans la liste déroulante en regard de Rechercher et entrez un ou plusieurs termes dans la zone de recherche.
Cet exemple utilise la fonction Weekday pour obtenir le jour de la semaine à partir d’une date spécifiée.
Dim MyDate, MyWeekDay
MyDate = #February 12, 1969# ' Assign a date.
MyWeekDay = Weekday(MyDate)
' MyWeekDay contains 4 because
' MyDate represents a Wednesday.