Função DATEADD
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. |
número_de_intervalos |
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
.gif "Observação") Observaçã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çã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 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.
Esta função DAX não tem suporte para uso no modo DirectQuery. Para obter mais informações sobre limitações nos modelos DirectQuery, consulte https://go.microsoft.com/fwlink/?LinkId=219172.
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)