Gibt einen Wert des Typs Variant (Integer) zurück, der eine ganze Zahl enthält, die den Tag der Woche darstellt.
Syntax
Weekday(date [, firstdayofweek ] )
Die Syntax der Funktion Wochentag weist die folgenden Argumente auf:
| Argument | Beschreibung |
|---|---|
| Datum | Erforderlich. Variante, numerischer Ausdruck, Zeichenfolgenausdruck oder eine beliebige Kombination davon, die ein Datum darstellen kann. Wenn das Datum Null enthält, wird Null zurückgegeben. |
| ErsterTagDerWoche | Optional. Eine Konstante, die den ersten Tag der Woche angibt. Sofern nicht anders angegeben, wird vbSunday vorausgesetzt. |
Einstellungen
Das Argument "firstdayofweek" weist die folgenden Einstellungen auf:
| Konstante | Wert | Beschreibung |
|---|---|---|
| vbUseSystem | 0 | NLS API-Einstellung verwenden. |
| vbSunday | 1 | Sonntag (Standard) |
| vbMonday | 2 | Montag |
| vbTuesday | 3 | Dienstag |
| vbWednesday | 4 | Mittwoch |
| vbThursday | 5 | Donnerstag |
| vbFriday | 6 | Freitag |
| vbSaturday | 7 | Samstag |
Rückgabewerte
Die Wochentag-Funktion kann einen der folgenden Werte zurückgeben:
| Konstante | Wert | Beschreibung |
|---|---|---|
| vbSunday | 1 | Sonntag |
| vbMonday | 2 | Montag |
| vbTuesday | 3 | Dienstag |
| vbWednesday | 4 | Mittwoch |
| vbThursday | 5 | Donnerstag |
| vbFriday | 6 | Freitag |
| vbSaturday | 7 | Samstag |
Hinweise
Wenn die Einstellung der Calendar-Eigenschaft gregorianisch ist, stellt die zurückgegebene Ganzzahl den gregorianischen Wochentag für das Argument date dar. Wenn der Kalender Hijri ist, stellt die zurückgegebene ganze Zahl den Hijri-Wochentag für das Argument Datum dar. Bei Hijri-Datumsangaben ist die Argumentnummer ein beliebiger numerischer Ausdruck, der ein Datum und/oder eine Uhrzeit zwischen 01.01.100 (2. August 718) bis 03.04.9666 (31. Dezember 9999) darstellen kann.
Abfragebeispiele
| Ausdruck | Ergebnisse |
|---|---|
| SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales; | Gibt die Werte aus dem Feld "Verkaufsdatum" sowie die Zahl zurück, die den Wochentag dieser Datumswerte darstellt. (Standardmäßig gilt der Sonntag als erster Tag der Woche; 1). |
| SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales; | Gibt die Werte aus dem Feld "Verkaufsdatum" sowie die Zahl zurück, die den Wochentag dieser Datumswerte darstellt. (wenn man den Montag als ersten Tag der Woche betrachtet). |
VBA-Beispiel
Hinweis
Die folgenden Beispiele zeigen die Verwendung dieser Funktion in einem VBA-Modul (Visual Basic for Applications). Wenn Sie weitere Informationen zum Arbeiten mit VBA wünschen, wählen Sie Entwicklerreferenz in der Dropdownliste neben Suchen aus, und geben Sie einen oder mehrere Begriffe in das Suchfeld ein.
In diesem Beispiel wird die Wochentag-Funktion verwendet, um den Tag der Woche vom angegebenen Datum zu erhalten.
Dim MyDate, MyWeekDay
MyDate = #February 12, 1969# ' Assign a date.
MyWeekDay = Weekday(MyDate)
' MyWeekDay contains 4 because
' MyDate represents a Wednesday.