Função PARALLELPERIOD

Descrição

Retorna uma tabela que contém uma coluna de datas que representa um período paralelo às datas na coluna de datas especificadas, no contexto atual, com as datas deslocadas em vários intervalos para frente ou para trás no tempo.

Sintaxe

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

Parâmetros

Sr. Não. Parâmetro e Descrição
1

dates

Uma coluna que contém datas.

2

number_of_intervals

Um número inteiro que especifica o número de intervalos a serem adicionados ou subtraídos das datas.

3

interval

O intervalo de mudança das 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

A função DAX PARALLELPERIOD pega o conjunto atual de datas na coluna especificada por datas, muda a primeira data e a última data o número especificado de intervalos e retorna todas as datas contíguas entre as duas datas alteradas.

Se o intervalo for um intervalo parcial de mês, trimestre ou ano, quaisquer meses parciais no resultado também serão preenchidos para completar o intervalo inteiro.

O parâmetro de datas 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.

Restrições em expressões booleanas -

  • A expressão não pode fazer referência a um campo calculado.

  • A expressão não pode usar a função CALCULATE.

  • A expressão não pode usar nenhuma função que varre uma tabela ou retorna uma tabela, incluindo funções de agregação.

No entanto, uma expressão booleana pode usar qualquer função que procure um único valor ou que calcule um valor escalar.

Se o número especificado para o parâmetro number_of_intervals for positivo, as datas avançam no tempo. Se o número for negativo, as datas voltarão no tempo.

O parâmetro de intervalo é uma enumeração, não um conjunto de strings. Portanto, os valores para intervalo não devem ser colocados entre aspas. Além disso, os valores: ano, trimestre, mês, dia devem ser escritos por extenso ao usá-los.

A tabela de resultados inclui apenas as datas especificadas no parâmetro de datas.

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

Exemplo

Previous Year Sales:= CALCULATE ( 
   SUM (Sales[Sales Amount]), 
   PARALLELPERIOD (Sales[Date], -1,YEAR)
)