Funzione WeekdayName (Visual Basic)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Restituisce un valore String contenente il nome del giorno specificato.

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

Parametri

Weekday
Obbligatorio. Valore Integer. Indicazione numerica del giorno della settimana (da 1 a 7), in cui 1 indica il primo giorno e 7 indica l'ultimo giorno della settimana. Il nome associato al primo e all'ultimo giorno dipende dall'impostazione di FirstDayOfWeekValue.
Abbreviate
Facoltativo. Valore Boolean che indica se il nome del giorno della settimana deve essere abbreviato. Se omesso, l'impostazione predefinita è False, a indicare che il nome del giorno non viene abbreviato.
FirstDayOfWeekValue
Facoltativo. Valore scelto dall'enumerazione FirstDayOfWeek che specifica il primo giorno della settimana. Se non è specificato, viene utilizzato FirstDayOfWeek.System.

Impostazioni

Di seguito sono indicate le possibili impostazioni dell'argomento FirstDayOfWeekValue.

Valore di enumerazione	Valore	Descrizione
FirstDayOfWeek.System	0	Primo giorno della settimana specificato nelle impostazioni di sistema (impostazione predefinita)
FirstDayOfWeek.Sunday	1	Domenica
FirstDayOfWeek.Monday	2	Lunedì (conforme allo standard ISO 8601, sezione 3.17)
FirstDayOfWeek.Tuesday	3	Martedì
FirstDayOfWeek.Wednesday	4	Mercoledì
FirstDayOfWeek.Thursday	5	Giovedì
FirstDayOfWeek.Friday	6	Venerdì
FirstDayOfWeek.Saturday	7	Sabato

Eccezioni

Tipo di eccezione	Numero di errore	Condizione
ArgumentException	5	Weekday è mino di 1 o maggiore di 7 oppure FirstDayOfWeekValue è minore di 0 o maggiore di 7.

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

La stringa restituita da WeekdayName dipende non solo dagli argomenti di input, ma anche dalle impostazioni di Opzioni internazionali specificate nel Pannello di controllo di Windows.

Nota:
WeekdayName utilizza l'impostazione del calendario corrente della proprietà CurrentCulture della classe CultureInfo nello spazio dei nomi System.Globalization. I valori predefiniti di CurrentCulture vengono determinati dalle impostazioni del Pannello di controllo.

Esempio

Nell'esempio riportato di seguito vengono utilizzate la funzione Weekday per ottenere il giorno della settimana da una data specificata e quindi la funzione WeekDayName per ottenere il nome di tale giorno dal relativo numero.

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