DATEADD

Retorna uma tabela que contém uma coluna de datas, deslocada para frente ou para trás no tempo pelo número especificado de intervalos começando nas datas do contexto atual.

Sintaxe

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

Parâmetros

Termo Definição
datas Uma coluna que contém datas.
number_of_intervals Um inteiro que especifica o número de intervalos a serem adicionados ou subtraídos das datas.
interval O intervalo pelo qual as datas serão deslocadas. O valor do intervalo pode ser um dos seguintes: year, quarter, month ou day

Valor retornado

Uma tabela que contém uma única coluna de valores de data.

Comentários

O argumento dates pode ser um dos seguintes:

  • Uma referência a uma coluna de data/hora,

  • Uma expressão de tabela que retorna uma única coluna de valores de data/hora,

  • Uma expressão booliana que define uma tabela de coluna única de valores de data/hora.

    Observação

    As restrições em expressões boolianas são descritas no tópico função CALCULATE.

  • Se o número especificado para number_of_intervals for positivo, as datas em dates serão avançadas no tempo; se o número for negativo, as datas em dates serão retrocedidas no tempo.

  • O parâmetro interval é uma enumeração, não um conjunto de cadeias de caracteres; portanto, os valores não devem ser colocados entre aspas. Além disso, os valores year, quarter, month e day devem ser escritos por extenso ao usá-los.

  • A tabela de resultados inclui apenas as datas que existem na coluna dates.

  • Se as datas do contexto atual não formarem um intervalo contíguo, a função retornará um erro.

  • Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.

Exemplo – Como deslocar um conjunto de datas

A fórmula a seguir calcula as datas que ocorrem um ano antes das datas do contexto atual.

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

Confira também

Funções de inteligência de dados temporais
Funções de data e hora