DATEADD

  • Artigo

Aplica-se a:Colunacalculada Tabelacalculada MedidaCálculo visual

Nota

Esta função é desencorajada para uso em cálculos visuais, pois provavelmente retorna resultados sem sentido.

Retorna uma tabela que contém uma coluna de datas, deslocadas para frente ou para trás no tempo pelo número especificado de intervalos das datas no 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 devem ser alteradas. O valor do intervalo pode ser um dos seguintes: year, quarter, month, day

Valor devolvido

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

Observações

O argumento dates pode ser qualquer 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 booleana que define uma tabela de coluna única de valores de data/hora.

    Nota

    Restrições em expressões booleanas são descritas no tópico, função CALCULATE.

  • Se o número especificado para number_of_intervals for positivo, as datas em datas são adiantadas no tempo, se o número for negativo, as datas em datas são deslocadas de volta no tempo.

  • O parâmetro interval é uma enumeração, não um conjunto de strings, portanto, os valores não devem ser colocados entre aspas. Além disso, os valores: year, quarter, month, devem day ser escritos na íntegra ao usá-los.

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

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

  • Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).

Exemplo - Alterar um conjunto de datas

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

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

Conteúdos relacionados

Funções de inteligência de tempo
Funções de data e hora