La misma medida N períodos antes/después (unidad: d, m o a).
| Campo | Valor |
|---|---|
| Categoría | Fecha y hora |
| Tipo | Agregación (opera sobre un conjunto de filas) |
| Aridad | 3 a 4 argumentos |
| Se compila a SQL (columna calculada) | No |
| Versión | Motor de fórmulas v3, con soporte para calendario fiscal/4-4-5. |
Alias#
Nombre canónico: DESLOCAR_PERIODO. Alias aceptados (sin distinguir mayúsculas/minúsculas): dateadd.
Sintaxis#
DESLOCAR_PERIODO(expr; arg2; arg3; [arg4])Todos los argumentos son expresiones.
Retorno#
El valor de la medida en el período desplazado, o vacío.
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#
Inteligencia de tiempo — detecta la fecha de referencia del grupo y vuelve a evaluar la medida sobre las filas del VISUAL (usa allRows) que caen en la ventana. Pasa a fiscal/4-4-5 cuando el modelo tiene ese calendario.
Diferencias con DAX#
- Equivalente en DAX: DATEADD
- Compatibilidad: DIFIERE de DAX — semántica diferente, atención
- Observación: Unidades d/m/a; opera sobre las filas del visual y no exige fechas contiguas como DATEADD.
Ejemplos#
DESLOCAR_PERIODO(SOMA(receita); dia; -1; "m")Ejemplo con valores#
Entrada: grupo marzo/25 desplazado -1 año.
DESLOCAR_PERIODO(SOMA(receita); dia; -1; "a") → 100Resultado esperado: 100
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.