Partilhar via

DATEADD

  • Artigo

Aplica-se a:Coluna calculadaTabela calculadaMeasureCálculo visual

Observação

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

Retorna uma tabela que contains uma coluna de datas, deslocada para frente or para trás em time pelo número especificado de intervalos das datas no contexto atual.

Sintaxe

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

Parâmetros

Vigência Definição
dates Uma coluna que contains datas.
number_of_intervals Um inteiro que especifica o número de intervalos a serem adicionados a or subtrair das datas.
interval O intervalo pelo qual as datas devem ser alteradas. O value para o intervalo pode ser um dos seguintes: year, quarter, month, day

Regresso value

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

Comentários

O argumento dates pode ser qualquer um dos seguintes:

  • Uma referência a uma coluna date/time,

  • Uma expressão de tabela que retorna uma única coluna de date/timevalues,

  • Uma expressão booleana que define uma tabela de coluna única de date/timevalues.

    Observação

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

  • If o número especificado para number_of_intervals for positivo, as datas em dates são antecipadas em time; if o número for negativo, as datas em dates são alteradas em time.

  • O parâmetro interval é uma enumeração not um conjunto de cadeias de caracteres; por conseguinte, valuesnot deve ser colocado entre aspas. Além disso, o values: year, quarter, month, day deve ser escrito na íntegra ao usá-los.

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

  • If as datas no contexto atual not formam um intervalo contíguo, a função retorna um error.

  • Esta função not é suportada para uso no modo DirectQuery quando usada em colunas calculadas or regras de segurança em nível de linha (RLS).

Exemplo - Alterar um conjunto de datas

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

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

Related conteúdo

Time funções de inteligênciaDateandtime funções