Compartir a través de


DATEADD

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)

Comportamiento especial

Cuando la selección incluya los últimos dos días del mes, DATEADD usará la semántica de "extensión" y incluirá los días hasta el final del mes. Por ejemplo, cuando se incluyen el 27 y el 28 de febrero de 2013 en la selección y se agrega un mes, DATEADD devolverá el 27 de marzo al 31.

Este comportamiento solo se produce cuando se incluyen los últimos dos días del mes en la selección. Si solo se selecciona el 27 de febrero, irá al 27 de marzo.

= DATEADD(DateTime[DateKey], 1, month)

funciones de inteligencia de tiempofunciones de fecha y hora