WeekdayName-Funktion (Visual Basic)

Artikel
09/02/2008

Aktualisiert: November 2007

Gibt einen String-Wert zurück, der den Namen des angegebenen Wochentages enthält.

Public Function WeekdayName( _
   ByVal Weekday As Integer, _
   Optional ByVal Abbreviate As Boolean = False, _
   Optional ByVal FirstDayOfWeekValue As FirstDayOfWeek = FirstDayOfWeek.System _
) As String

Parameter

Weekday
Erforderlich. Wert vom Typ Integer. Die numerische Bezeichnung des Wochentages von 1 bis 7, wobei 1 für den ersten und 7 für den letzten Tag der Woche steht. Welcher Tag der erste und letzte Tag der Woche ist, hängt von der Einstellung für FirstDayOfWeekValue ab.
Abbreviate
Optional. Boolean-Wert, der angibt, ob der Name des Wochentages abgekürzt werden soll. Wenn dieses Argument nicht angegeben wird, ist der Standardwert False, d. h. der Name des Wochentages wird nicht abgekürzt.
FirstDayOfWeekValue
Optional. Ein Wert aus der FirstDayOfWeek-Enumeration, der den ersten Tag der Woche angibt. Wird kein bestimmter Wert angegeben, wird FirstDayOfWeek.System verwendet.

Einstellungen

Das FirstDayOfWeekValue-Argument kann eine der folgenden Einstellungen haben.

Enumerationswert	Wert	Beschreibung
FirstDayOfWeek.System	0	Erster Tag der Woche laut Systemeinstellungen (Standardwert)
FirstDayOfWeek.Sunday	1	Sonntag
FirstDayOfWeek.Monday	2	Montag (entspricht ISO-Norm 8601, Abschnitt 3.17)
FirstDayOfWeek.Tuesday	3	Dienstag
FirstDayOfWeek.Wednesday	4	Mittwoch
FirstDayOfWeek.Thursday	5	Donnerstag
FirstDayOfWeek.Friday	6	Freitag
FirstDayOfWeek.Saturday	7	Samstag

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentException	5	Weekday ist kleiner als 1 oder größer als 7, oder FirstDayOfWeekValue ist kleiner als 0 oder größer als 7.

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

Welche Zeichenfolge von WeekdayName zurückgegeben wird, hängt nicht nur von den Eingabeargumenten ab, sondern auch von den Regionalen Einstellungen, die in der Systemsteuerung von Windows festgelegt wurden.

Hinweis:
WeekdayName verwendet die aktuelle Kalendereinstellung für die CurrentCulture-Eigenschaft der CultureInfo-Klasse im System.Globalization-Namespace. Die Standardwerte für CurrentCulture werden durch die Einstellungen in der Systemsteuerung bestimmt.

Beispiel

Im folgenden Beispiel wird die Weekday-Funktion verwendet, um den Wochentag eines angegebenen Datums zu ermitteln. Anschließend wird mit der WeekDayName-Funktion der Name des Wochentages anhand seiner Nummer bestimmt.

Dim oldDate As Date
Dim oldWeekDayName As String
oldDate = #2/12/1969#
oldWeekDayName = WeekdayName(Weekday(oldDate))
' oldWeekDayName now contains "Wednesday".