PARALLELPERIOD

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Observação

Essa função não é recomendada para uso em cálculos visuais, pois é provável que ela retorne resultados sem sentido.

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

Sintaxe

PARALLELPERIOD(<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 serão deslocadas. O valor do intervalo pode ser um dos seguintes: year, quarter, month.

Valor retornado

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

Comentários

• Essa função usa o conjunto atual de datas na coluna especificada por dates, desloca a primeira e a última data o número especificado de intervalos e retorna todas as datas contíguas entre as duas datas deslocadas. Se o intervalo for um intervalo parcial de mês, trimestre ou ano, os meses parciais no resultado também serão preenchidos para concluir todo o intervalo.

• O argumento dates pode ser 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.

• 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 avançadas no tempo; se o número for negativo, as datas em dates serão retrocedidas 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 devem ser escritos por extenso ao usá-los.

• A tabela de resultados inclui apenas as datas que aparecem nos valores da coluna da tabela subjacente.

• A função PARALLELPERIOD é semelhante à função DATEADD, mas PARALLELPERIOD sempre retorna períodos completos no nível de granularidade especificado em vez dos períodos parciais que DATEADD retorna. Por exemplo, se você tiver uma seleção de datas que começa em 10 de junho e termina em 21 de junho do mesmo ano e deseja deslocar essa seleção para frente um mês, a função PARALLELPERIOD retornará todas as datas do mês seguinte (1º a 31 de julho). No entanto, se DATEADD for usado, o resultado incluirá apenas datas de 10 a 21 de julho.

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

Exemplo

A fórmula de exemplo a seguir cria uma medida que calcula as vendas do no anterior para Vendas na Internet.

= CALCULATE(SUM(InternetSales_USD[SalesAmount_USD]), PARALLELPERIOD(DateTime[DateKey],-1,year))  

Conteúdo relacionado

Funções de inteligência de dados temporais
Funções de data e hora
função DATEADD