Gibt einen Wert des Typs Variant (Integer) zurück, der eine ganze Zahl enthält, die den Tag der Woche darstellt.
Syntax
Wochentag ( Datum [, ErsterTagDerWoche ] )
Die Syntax der Funktion Wochentag weist die folgenden Argumente auf:
|
Argument |
Beschreibung |
|
Datum |
Erforderlich. Wert des Typs "Variant", Numerischer Ausdruck, Zeichenfolgenausdruck oder eine beliebige Kombination daraus, die ein Datum darstellen kann. Enthält das Datum den Wert Null, wird Null zurückgegeben. |
|
ErsterTagDerWoche |
Optional. Eine Konstante, die den ersten Tag der Woche bezeichnet. Sofern nicht anders angegeben, wird vbSunday vorausgesetzt. |
Einstellungen
Das ErsterTagDerWoche-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 |
Anmerkungen
Wenn die Einstellung der Calendar-Eigenschaft 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.
