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 Weekday tiene estos argumentos:
| Argumento | Descripción |
|---|---|
| fecha | Obligatorio. Variant, expresión numérica, expresión de cadena o cualquier combinación de estas que pueda representar una fecha. Si fecha contiene Null, se devolverá Null . |
| primer_día_semana | Opcional. Constante que especifica el primer día de la semana. Si no se especifica, se supone que es vbSunday . |
Configuración
El argumento primer_día_semana tiene esta configuración:
| Constante | Valor | Descripción |
|---|---|---|
| vbUseSystem | 0 | Use la configuración de la API 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 Diasem 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 de fecha. Si el calendario es Hijri, el entero devuelto representa el día Hijri de la semana para el argumento de fecha. Para fechas Hijri, el número de argumento es cualquier expresión numérica que puede representar una fecha y/o una hora entre el 1/1/100 (2 de agosto gregoriano de 718) y el 3/4/9666 (31 de dic gregoriano de 9999).
Ejemplos de consulta
| Expresión | Resultados |
|---|---|
| SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales; | Devuelve los valores del campo "DateofSale" y el número que representa el "Weekday" 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 "DateofSale" y el número que representa el "Weekday" de estos valores de fecha. (considerando el lunes como 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 Weekday 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.