Weekday-Funktion

Gibt einen Variant-Wert (Integer) mit einer ganzen Zahl zurück, die den Wochentag angibt.

Syntax

Weekday(date, [ firstdayofweek ])

Die Syntax der Weekday-Funktion umfasst die folgenden benannten Argumente:

Teil Beschreibung
date Erforderlich. Variant, numerischer Ausdruck, Zeichenfolgeausdruck oder eine Kombination daraus, die ein Datum darstellen kann. Wenn date den Wert Null enthält, wird Null zurückgegeben.
firstdayofweek Optional. Eine Konstante, die den ersten Wochentag angibt. Wenn sie nicht angegeben ist, wird vbSunday vorausgesetzt.

Settings

Das Argument firstdayofweek hat die folgenden Einstellungen:

Konstante Wert Beschreibung
vbUseSystem 0 NLS-API-Einstellung wird verwendet.
vbSunday 1 Sonntag (Standardeinstellung)
vbMonday 2 Montag
vbTuesday 3 Dienstag
vbWednesday 4 Mittwoch
vbThursday 5 Donnerstag
vbFriday 6 Freitag
vbSaturday 7 Samstag

Rückgabewerte

Die Weekday-Funktion kann die 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

HinwBemerkungeneise

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 4/3/9666 (Gregorian Dec 31, 9999) darstellen kann.

Beispiel

Im Beispiel wird mit der Weekday-Funktion der Wochentag eines angegebenen Datums abgerufen.

Dim MyDate, MyWeekDay
MyDate = #February 12, 1969#    ' Assign a date.
MyWeekDay = Weekday(MyDate)    ' MyWeekDay contains 4 because 
    ' MyDate represents a Wednesday.

Siehe auch

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.