Compartir a través de

DATEADD

  • Artículo

Se aplica a:columna Calculadatabla calculadaMedidacálculo visual

Nota

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

Devuelve una tabla que contiene una columna de fechas, desplazada hacia delante o hacia atrás en el tiempo por el número especificado de intervalos de las fechas en el contexto actual.

Sintaxis

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

Parámetros

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

Valor devuelto

Tabla que contiene una sola columna de valores de fecha.

Observaciones

El argumento dates puede ser cualquiera de los siguientes:

  • Referencia a una columna de fecha y hora,

  • Expresión de tabla que devuelve una sola columna de valores de fecha y hora,

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

    Nota

    Las restricciones en las expresiones booleanas se describen en el tema, CALCULATE función.

  • Si el número 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 vuelven a cambiar en el tiempo.

  • El parámetro interval es una enumeración, no un conjunto de cadenas; por lo tanto, los valores no deben incluirse entre comillas. Además, los valores: year, quarter, month, day deben escribirse en su totalidad al usarlos.

  • 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 usa en columnas calculadas o reglas de seguridad de nivel de fila (RLS).

Ejemplo: Cambio de un conjunto de fechas

La fórmula siguiente calcula las fechas que son un año antes de las fechas en el contexto actual.

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

Contenido relacionado

funciones de inteligencia de tiempofunciones de fecha y hora