WeekdayName (Función, Visual Basic)

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".

Requisitos

Espacio de nombres:Microsoft.VisualBasic

Módulo:DateAndTime

Ensamblado:Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)

Vea también

Referencia

Day (Función, Visual Basic)

Month (Función, Visual Basic)

Now (Propiedad)

Weekday (Función, Visual Basic)

MonthName (Función, Visual Basic)

Year (Función, Visual Basic)

DatePart (Función, Visual Basic)

DateTime