WeekdayName (Función, Visual Basic)

Artículo
10/07/2008

Actualización: noviembre 2007

Devuelve un valor String que contiene el nombre del día de la semana especificado.

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

Parámetros

Weekday
Obligatorio. Obligatorio. Integer. Designación numérica del día de la semana, entre 1 y 7; 1 indica el primer día de la semana y 7 indica el último día de la semana. Las identidades del primer y último día dependen de la configuración de FirstDayOfWeekValue.
Abbreviate
Opcional. Valor Boolean que indica si se abrevia el nombre del día de la semana. Si se omite, el valor predeterminado es False, que significa que el nombre del día de la semana no se abrevia.
FirstDayOfWeekValue
Opcional. Un valor elegido de la enumeración FirstDayOfWeek que especifica el primer día de la semana. Si no se especifica, se utiliza FirstDayOfWeek.System.

Valores

El argumento FirstDayOfWeekValue puede tener uno de los siguientes valores:

Valor de enumeración	Valor	Descripción
FirstDayOfWeek.System	0	Primer día de la semana especificado en la configuración del sistema (valor predeterminado)
FirstDayOfWeek.Sunday	1	Domingo
FirstDayOfWeek.Monday	2	Lunes (de acuerdo con la norma ISO 8601, sección 3.17)
FirstDayOfWeek.Tuesday	3	Martes
FirstDayOfWeek.Wednesday	4	Miércoles
FirstDayOfWeek.Thursday	5	Jueves
FirstDayOfWeek.Friday	6	Viernes
FirstDayOfWeek.Saturday	7	Sábado

Excepciones

Tipo de excepción	Número de error	Condición
ArgumentException	5	Weekday es menor que 1 o mayor que 7, o FirstDayOfWeekValue es menor que 0 o mayor que 7.

Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, se debe considerar la sustitución de dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.

Comentarios

La cadena devuelta por WeekdayName no depende únicamente de los argumentos de entrada, sino también de los valores de la Configuración regional especificados en el Panel de control de Windows.

Nota:
WeekdayName utiliza la configuración de calendario actual de la propiedad CurrentCulture de la clase CultureInfo en el espacio de nombres System.Globalization. Los valores de CurrentCulture predeterminados están determinados por la configuración del Panel de control.

Ejemplo

En el ejemplo siguiente se utiliza la función Weekday para obtener el día de la semana a partir de una fecha especificada y la función WeekDayName para obtener el nombre del día de la semana a partir de su número.

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