Weekday, fonction (Visual Basic)

Mise à jour : novembre 2007

Retourne une valeur de type Integer représentant le jour de la semaine.

Public Function Weekday( _
   ByVal DateValue As DateTime, _
   Optional ByVal DayOfWeek As FirstDayOfWeek = FirstDayOfWeek.Sunday _
) As Integer

Paramètres

  • DateValue
    Requis. Valeur Date pour laquelle vous souhaitez déterminer le jour de la semaine.

  • DayOfWeek
    Facultatif. Valeur choisie dans l'énumération FirstDayOfWeek qui spécifie le premier jour de la semaine. S'il n'est pas spécifié, FirstDayOfWeek.Sunday est utilisé.

Paramètres

L'argument DayOfWeek peut prendre l'une des valeurs suivantes :

Valeur d'énumération

Valeur

Description

FirstDayOfWeek.System

0

Premier jour de la semaine spécifiée dans les paramètres système

FirstDayOfWeek.Sunday

1

Dimanche (valeur par défaut)

FirstDayOfWeek.Monday

2

Lundi (conformément à la norme ISO 8601, section 3.17)

FirstDayOfWeek.Tuesday

3

Mardi

FirstDayOfWeek.Wednesday

4

Mercredi

FirstDayOfWeek.Thursday

5

Jeudi

FirstDayOfWeek.Friday

6

Vendredi

FirstDayOfWeek.Saturday

7

Samedi

Exceptions

Type d'exception

Numéro de l'erreur

Condition

ArgumentException

5

DayOfWeek est inférieur à 0 ou supérieur à 7.

Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion des erreurs non structurée. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreur par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

La valeur retournée par la fonction Weekday est le jour de la semaine auquel DateValue correspond, par rapport au premier jour de la semaine défini par la valeur DayOfWeek. Par exemple, si la date fait référence à un mercredi et que le lundi est défini comme premier jour de la semaine, la fonction retourne la valeur 3.

Remarque :

Weekday utilise le paramètre de calendrier actuel de la propriété CurrentCulture de la classe CultureInfo dans l'espace de noms System.Globalization. Les valeurs par défaut de CurrentCulture dépendent des paramètres du Panneau de configuration.

Exemple

L'exemple suivant utilise la fonction Weekday pour obtenir le jour de la semaine à partir d'une date spécifiée.

Dim oldDate As Date
Dim oldWeekDay As Integer
oldDate = #2/12/1969#
oldWeekDay = Weekday(oldDate)
' oldWeekDay now contains 4 because thisDate represents a Wednesday.

Configuration requise

Espace de noms :Microsoft.VisualBasic

**Module :**DateAndTime

**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)

Voir aussi

Référence

Day, fonction (Visual Basic)

Month, fonction (Visual Basic)

Now, propriété

WeekdayName, fonction (Visual Basic)

Year, fonction (Visual Basic)

DatePart, fonction (Visual Basic)

DateTime