Weekday (Función, Visual Basic)

Actualización: noviembre 2007

Devuelve un valor Integer que contiene un número que representa el día de la semana.

Public Function Weekday( _
   ByVal DateValue As DateTime, _
   Optional ByVal DayOfWeek As FirstDayOfWeek = FirstDayOfWeek.Sunday _
) As Integer

Parámetros

  • DateValue
    Requerido. Valor Date del cual se desea determinar el día de la semana.

  • DayOfWeek
    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.Sunday.

Valores

El argumento DayOfWeek 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

FirstDayOfWeek.Sunday

1

Domingo (predeterminado)

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

DayOfWeek 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

El valor devuelto por la función Weekday es el día de la semana al que corresponde DateValue, relativo al primer día de la semana definido por el valor DayOfWeek. Por ejemplo, si la fecha hace referencia a un miércoles y el primer día de la semana se especifica como lunes, la acción devuelve 3.

Nota:

Weekday 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 de una fecha especificada.

Dim oldDate As Date
Dim oldWeekDay As Integer
oldDate = #2/12/1969#
oldWeekDay = Weekday(oldDate)
' oldWeekDay now contains 4 because thisDate represents a 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)

WeekdayName (Función, Visual Basic)

Year (Función, Visual Basic)

DatePart (Función, Visual Basic)

DateTime