DATEADD

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

Nota

Essa 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, deslocada 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

Prazo	Definição
dates	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 deslocar as datas. O valor do intervalo pode ser um dos seguintes: year, quarter, month, day

Valor de retorno

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 booliana que define uma tabela de coluna única de valores de data/hora.

  Nota

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

• Se o número especificado para number_of_intervals for positivo, as datas em dates serão movidas para frente a tempo; se o número for negativo, as datas em dates serão deslocadas novamente 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, day devem 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.

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

Exemplo – Deslocando um conjunto de datas

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

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

Comportamento especial

Quando a seleção incluir os últimos dois dias do mês, DATEADD usará semântica de "extensão" e incluirá os dias até o final do mês. Por exemplo, quando 27 e 28 de fevereiro de 2013 estiverem incluídos na seleção e um mês for adicionado, DATEADD retornará de 27 a 31 de março.

Esse comportamento só acontece quando os últimos dois dias do mês são incluídos na seleção. Se apenas 27 de fevereiro estiver selecionado, ele irá para 27 de março.

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

Conteúdo relacionado

funções de inteligência de horafunções de data e hora