Número de la semana en el año (la semana empieza el domingo).
| 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: SEMANA. Alias aceptados (sin distinguir mayúsculas/minúsculas): weeknum, week.
Sintaxis#
SEMANA(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: WEEKNUM
- Compatibilidad: Compatible con DAX
- Observación: Semana que empieza el domingo (WEEKNUM tipo 1).
Ejemplos#
SEMANA(pedido_em)Ejemplo con valores#
Entrada: fecha 2025-06-15.
SEMANA(DATA(2025;6;15)) → 24Resultado esperado: 24
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.