Partilhar via

PARALLELPERIOD

  • Artigo

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Observação

Esta 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 que representa um período paralelo às datas na coluna dates especificada, no contexto atual, com as datas deslocadas vários intervalos para frente no tempo ou para trás no tempo.

Sintaxe

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

Parâmetros

Vigência 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 as datas devem ser alteradas. O valor para intervalo pode ser um dos seguintes: year, quarter, month.

Valor de retorno

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

Comentários

  • Esta função usa o conjunto atual de datas na coluna especificada por dates, desloca a primeira data e a última data o número especificado de intervalos e, em seguida, retorna todas as datas contíguas entre as duas datas deslocadas. Se o intervalo for um intervalo parcial de mês, trimestre ou ano, todos os meses parciais no resultado também serão preenchidos para completar 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 booleana que define uma tabela de coluna única de valores de data/hora.

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

  • Se o número especificado para number_of_intervals for positivo, as datas em dates são antecipadas no tempo; Se o número for negativo, as datas em dates são deslocadas no tempo.

  • O parâmetro interval é uma enumeração, não um conjunto de cadeias de caracteres; por conseguinte, 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 dado 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 antecipar essa seleção em um mês, a função PARALLELPERIOD retornará todas as datas do mês seguinte (1º de julho a 31 de julho); no entanto, se DATEADD for usado em vez disso, o resultado incluirá apenas datas de 10 a 21 de julho.

  • Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).

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))

Conteúdo relacionado

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