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. Variant, numerischer Ausdruck, Zeichenfolgenausdruck oder eine beliebige Kombination dieser Ausdrücke, die ein Datum darstellen können. Wenn date 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 firstdayofweek-Argument 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 Calendar-Eigenschaftseinstellung gregorianisch ist, stellt die zurückgegebene ganze Zahl den gregorianischen Wochentag für das Date-Argument dar. Wenn der Kalender Hijri ist, stellt die zurückgegebene ganze Zahl den Hijri-Wochentag für das Date-Argument dar. Bei Hijri-Datumsangaben ist die Argumentnummer ein beliebiger numerischer Ausdruck, der ein Datum und/oder eine Uhrzeit vom 01.01.100 (Gregorian Aug 2, 718) bis zum 4/3/9666 (Gregorian Dec 31, 9999) darstellen kann.
Abfragebeispiele
| Ausdruck | Ergebnisse |
|---|---|
| SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales; | Gibt die Werte aus dem Feld "DateofSale" und die Zahl zurück, die den Wochentag dieser Datumswerte darstellt. (Standardmäßig gilt Sonntag als erster Tag der Woche; 1). |
| SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales; | Gibt die Werte aus dem Feld "DateofSale" und die Zahl zurück, die den Wochentag dieser Datumswerte darstellt. (unter Berücksichtigung von Montag als erster Tag der Woche). |
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.