Compartilhar via


Função DATEADD (DAX)

Retorna uma tabela que contém uma coluna de datas, adiantadas ou atrasadas no tempo conforme o número especificado de intervalos das datas no contexto atual.

Sintaxe

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

Parâmetros

Termo

Definição

dates

Uma coluna que contém datas.

number_of_intervals

Um inteiro que especifica o número de intervalos a ser adicionado ou subtraído das datas.

interval

O intervalo pelo qual deslocar as datas. O valor do intervalo pode ser um dos seguintes: year, quarter, month, day

Valor de retorno

Uma tabela com uma única coluna de valores de datas.

Comentários

ObservaçãoObservação

Para entender melhor como o contexto afeta os resultados das fórmulas, consulte Contexto em fórmulas DAX.

O argumento dates pode ser qualquer um destes:

  • 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 com uma única coluna de valores de data/hora.

ObservaçãoObservação

As restrições em expressões boolianas são descritas no tópico Função CALCULATE (DAX).

Se o número especificado para number_of_intervals for positivo, as datas em dates serão adiantadas no tempo; se o número for negativo, as datas em dates serão atrasadas.

O parâmetro interval é uma enumeração, não um conjunto de cadeias de caracteres; portanto não deverão ser incluídos entre aspas. Além disso, os valores year, quarter, month, day deverão ser grafados por extenso quando usados.

A tabela de resultados inclui apenas as datas existentes na coluna dates.

Exemplo: deslocando um conjunto de datas

Descrição

A fórmula a seguir calcula datas que são um ano anteriores às datas no contexto atual.

Código

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