DATEADD

Se aplica a:Columna calculadaTabla calculadaMediciónCálculo visual

Nota:

No se recomienda usar esta función en cálculos visuales, ya que es probable que devuelva resultados sin sentido.

Devuelve una tabla que contiene una columna de fechas que se han desplazado hacia delante o hacia atrás en el tiempo según el número especificado de intervalos desde las fechas del contexto actual.

Sintaxis

DATEADD(<dates>,<number_of_intervals>,<interval>)  

Parámetros

Término Definición
fechas Una columna que contiene fechas.
number_of_intervals Entero que especifica el número de intervalos que se van a sumar o restar a las fechas.
interval Intervalo por el que se van a desplazar las fechas. El valor del intervalo puede ser uno de los siguientes: year, quarter, month o day.

Valor devuelto

Tabla que contiene una única columna de valores de fecha.

Notas

El argumento dates puede ser cualquiera de los siguientes:

  • Una referencia a una columna de fecha y hora.

  • Una expresión de tabla que devuelve una sola columna de valores de fecha y hora.

  • Una expresión booleana que define una tabla de una sola columna de valores de fecha y hora.

    Nota

    Las restricciones de las expresiones booleanas se describen en el tema Función CALCULATE.

  • Si el número de intervalos especificado para number_of_intervals es positivo, las fechas de dates se mueven hacia delante en el tiempo; si el número es negativo, las fechas de dates se desplazan hacia atrás en el tiempo.

  • El parámetro interval es una enumeración, no un conjunto de cadenas, por lo tanto, los valores no deben ir entre comillas. Además, los valores year, quarter, month y day deben escribirse completos cuando se usan.

  • La tabla de resultados solo incluye fechas que existen en la columna dates.

  • Si las fechas del contexto actual no forman un intervalo contiguo, la función devuelve un error.

  • Esta función no se admite para su uso en el modo DirectQuery cuando se utiliza en columnas calculadas o en reglas de seguridad de nivel de fila (RLS).

Ejemplo: Desplazar un conjunto de fechas

La fórmula siguiente calcula las fechas del año anterior equivalentes a las fechas del contexto actual.

= DATEADD(DateTime[DateKey],-1,year)  

Funciones de inteligencia de tiempo
Funciones de fecha y hora