Día de la semana (1 = domingo … 7 = sábado).
| Campo | Valor |
|---|---|
| Categoría | Fecha y hora |
| Tipo | Escalar (opera valor por valor) |
| Aridad | 1 argumento (fijo) |
| Se compila a SQL (columna calculada) | Sí |
| Versión | Motor de fórmulas v3. |
Alias#
Nombre canónico: DIASEMANA. Alias aceptados (sin distinguir mayúsculas/minúsculas): weekday, dayofweek.
Sintaxis#
DIASEMANA(expr)Todos los argumentos son expresiones.
Retorno#
Número.
Tratamiento de nulos#
Las fechas inválidas o ausentes se convierten en un error claro o en vacío, según la función.
Contexto de evaluación#
Escalar — se evalúa sobre el resultado de los argumentos (en las columnas calculadas, se ejecuta fila por fila).
Diferencias con DAX#
- Equivalente en DAX: WEEKDAY
- Compatibilidad: Compatible con DAX
- Observación: 1 = domingo … 7 = sábado (WEEKDAY tipo 1).
Ejemplos#
DIASEMANA(pedido_em)Ejemplo con valores#
Entrada: fecha 2025-06-15 (domingo).
DIASEMANA(DATA(2025;6;15)) → 1Resultado esperado: 1
Ejemplo de negocio#
Análisis temporal — antigüedad del pedido, mes/año de devengo, cierre contable.
Errores comunes#
Errores de escritura en el nombre de una columna, un tipo incompatible o un argumento inválido se convierten en un mensaje claro (pt-BR) — el motor nunca devuelve un número incorrecto en silencio.