PARALLELPERIOD

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

Para a entrada da coluna de data, retorna uma tabela que contém uma coluna de datas que representa um período paralelo às datas na coluna especificada dates , no contexto atual, com as datas deslocadas para um número de intervalos para frente no tempo ou de volta no tempo.

Para entrada de calendário, retorna uma tabela que representa um período paralelo às datas no contexto atual, com base no calendário, com as datas deslocadas em vários intervalos no tempo ou de volta no tempo. A tabela contém todas as colunas marcadas primárias e colunas relacionadas a todos os tempos.

Sintaxe

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

Parâmetros

Valor de retorno

Para entrada de coluna de data, uma tabela que contém uma única coluna de valores de data.
Para entrada de calendário, uma tabela que contém todas as colunas marcadas primárias e colunas relacionadas a todos os tempos.

Observações

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

• 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.

• 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 devem ser escritos na íntegra ao usá-los.

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

• A função PARALLELPERIOD é semelhante à função DATEADD, exceto que PARALLELPERIOD sempre retorna períodos completos no nível de granularidade determinado, 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 mudar essa seleção para frente em um mês, então a função PARALLELPERIOD retornará todas as datas do próximo mês (1º de julho a 31 de julho); no entanto, se DATEADD for usado, o resultado incluirá apenas datas de 10 de julho a 21 de julho.

• 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

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

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

Exemplo de inteligência de tempo baseada em calendário

A fórmula de exemplo a seguir cria uma medida que calcula as vendas do ano anterior para vendas pela Internet usando o calendário fiscal.

= CALCULATE (
    SUM ( InternetSales_USD[SalesAmount_USD] ),
    PARALLELPERIOD ( FiscalCalendar, -1, YEAR )
)

Conteúdo relacionado

Funções de inteligência de horafunções de data e horaDATEADD função