Devuelve un valor de tipo Variant (Integer) que contiene un número entero que representa el día de la semana.
Sintaxis
Weekday(date [, firstdayofweek ] )
La sintaxis de la función DíaSemana consta de los siguientes argumentos:
| Argumento | Descripción |
|---|---|
| fecha | Obligatorio. Variante, expresión numérica, expresión de cadena o cualquier combinación de estas que pueda representar una fecha. Si la fecha contiene Null, se devuelve Null . |
| primer_día_semana | Opcional. Constante que especifica el primer día de la semana. Si no se especifica, se supone que vbSunday . |
Configuración
El argumento firstdayofweek tiene estas opciones de configuración:
| Constante | Valor | Descripción |
|---|---|---|
| vbUseSystem | 0 | Use la configuración de API de NLS. |
| vbSunday | 1 | Domingo (predeterminado) |
| vbMonday | 2 | Lunes |
| vbTuesday | 3 | Martes |
| vbWednesday | 4 | Miércoles |
| vbThursday | 5 | Jueves |
| vbFriday | 6 | Viernes |
| vbSaturday | 7 | Sábado |
Valores devueltos
La función DíaSemana puede devolver cualquiera de estos valores:
| Constante | Valor | Descripción |
|---|---|---|
| vbSunday | 1 | Domingo |
| vbMonday | 2 | Lunes |
| vbTuesday | 3 | Martes |
| vbWednesday | 4 | Miércoles |
| vbThursday | 5 | Jueves |
| vbFriday | 6 | Viernes |
| vbSaturday | 7 | Sábado |
Observaciones
Si el valor de la propiedad Calendar es gregoriano, el entero devuelto representa el día gregoriano de la semana para el argumento fecha. Si el calendario es Hijri, el entero devuelto representa el día Hijri de la semana para el argumento fecha. Para las fechas Hijri, el argumento número es cualquier expresión numérica que puede representar una fecha y/o hora desde el 1/1/100 (2 de agosto de 718 en Gregoriano) hasta el 3/4/9666 (31 de diciembre de 9999 en Gregoriano).
Ejemplos de consulta
| Expresión | Resultados |
|---|---|
| SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales; | Devuelve los valores del campo "Fecha de venta" y el número que representa el "Día de la semana" de estos valores de fecha. (De forma predeterminada, el domingo se considera el primer día de la semana; 1). |
| SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales; | Devuelve los valores del campo "Fecha de venta" y el número que representa el "Día de la semana" de estos valores de fecha. (considerando el lunes como el primer día de la semana). |
Ejemplo VBA:
Nota
Los ejemplos siguientes muestran el uso de esta función en un módulo de Visual Basic para Aplicaciones (VBA). Para obtener más información sobre cómo trabajar con VBA, seleccione referencia para desarrolladores en la lista desplegable situada junto a búsqueda y escriba uno o varios términos en el cuadro de búsqueda.
En este ejemplo se usa la función DíaSemana para obtener el día de la semana a partir de una fecha especificada.
Dim MyDate, MyWeekDay
MyDate = #February 12, 1969# ' Assign a date.
MyWeekDay = Weekday(MyDate)
' MyWeekDay contains 4 because
' MyDate represents a Wednesday.