VBA-Programmierung in Microsoft Excel

Tutorial: Excel-Beispiele

VBA-Begriff: Weekday-Funktion

Gibt einen Wert vom Typ Variant (Integer) zurück, der den Wochentag als ganze Zahl angibt.

Syntax

Weekday(date, [firstdayofweek])

Die Syntax für die Weekday-Funktion besteht aus folgenden benannten Argumenten:

Teil Beschreibung
date Erforderlich. Wert vom Typ Variant, numerischer Ausdruck, Zeichenfolgenausdruck oder eine beliebige Kombination, 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. Wird die Konstante nicht angegeben, so wird vbSunday angenommen.

Einstellungen

Das Argument firstdayofweek hat folgende Einstellungen:

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

Rückgabewerte

Die Weekday-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

Bemerkungen

Wenn die Einstellung der Calendar-Eigenschaft auf Gregorianisch steht, stellt die zurückgegebene Ganzzahl den gregorianischen Wochentag für das Datumargument dar. Wenn die Einstellung auf Hijri steht, stellt die zurückgegebene Ganzzahl den Wochentag des Hijri-Kalenders für das Datumargument dar. Bei Datumsangaben nach dem Hijri-Kalender entspricht die Nummer des Arguments jedem numerischen Ausdruck, der ein Datum und/oder einen Zeitraum vom 1/1/100 (Gregorianischer Kalender 2. Aug 718) bis zum 4/3/9666 (Gregorianischer Kalender 31. Dez 9999) darstellen kann.