Função PARALLELPERIOD
Retorna uma tabela que contenha uma coluna de datas que representa um período paralelo às datas na coluna dates especificada, no contexto atual, com as datas deslocadas em vários intervalos no presente ou no passado.
Sintaxe
PARALLELPERIOD(<dates>,<number_of_intervals>,<interval>)
Parâmetros
Termo |
Definição |
dates |
Uma coluna que contém datas. |
número_de_intervalos |
Um inteiro que especifica o número de intervalos a ser adicionado ou subtraído das datas. |
interval |
O intervalo pelo qual deslocar as datas. O valor do intervalo pode ser um dos seguintes: year, quarter, month. |
Valor de retorno
Uma tabela com uma única coluna de valores de datas.
Comentários
Essa função usa o conjunto atual de datas na coluna especificada por datas, desloca a primeira e a última datas no número especificado de intervalos e, em seguida, retorna todas as datas contíguas entre as duas datas deslocadas. Se o intervalo for parcial de mês, trimestre ou ano, qualquer mês parcial no resultado também será preenchido para concluir o intervalo inteiro.
.gif "Observação") Observação |
|---|
Para entender melhor como o contexto afeta os resultados das fórmulas, consulte Contexto em fórmulas DAX. |
O argumento dates pode ser qualquer um destes:
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 com uma única coluna de valores de data/hora.
| Observação |
|---|
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 adiantadas no tempo; se o número for negativo, as datas em dates serão atrasadas.
O parâmetro intervalo é uma enumeração, e não um conjunto de cadeias de caracteres; portanto, os valores não devem ser incluídos entre aspas. Além disso, os valores year, quarter, month devem ser escritos por extenso quando usados.
A tabela de resultados inclui apenas as datas exibidas nos valores da coluna da tabela subjacente.
A função PARALLELPERIOD é semelhante à função DATEADD, exceto por PARALLELPERIOD sempre retornar períodos completos no determinado nível de granularidade, em vez dos períodos parciais retornados por DATEADD. Por exemplo, se você tiver uma seleção de datas começando em 10 de junho e terminando em 21 de junho do mesmo ano e quiser deslocar essa seleção um mês à frente, a função PARALLELPERIOD retornará todas as datas do próximo mês (de 1º de julho a 31 de julho); no entanto, se DATEADD for usada, o resultado só incluirá datas de 10 a 21 de julho.
Se as datas no contexto atual não formarem um intervalo contíguo, a função retornará um erro.
Esta função DAX não tem suporte para uso no modo DirectQuery. Para obter mais informações sobre limitações nos modelos DirectQuery, consulte https://go.microsoft.com/fwlink/?LinkId=219172.
Exemplo
A fórmula de exemplo a seguir cria uma medida que calcula as vendas do ano anterior para as vendas pela Internet.
Para ver como isso funciona, crie uma Tabela Dinâmica e adicione os campos CalendarYear e CalendarQuarter à área Rótulos de Linha da Tabela Dinâmica. Em seguida, adicione uma medida denominada Previous Year Sales, usando a fórmula definida na seção de código, à área Valores da Tabela Dinâmica.
| Observação |
|---|
O exemplo anterior usa a tabela DateTime da pasta de trabalho de exemplo DAX. Para obter mais informações sobre exemplos, consulte o artigo sobre como obter dados de exemplo. |
=CALCULATE(SUM(InternetSales_USD[SalesAmount_USD]), PARALLELPERIOD(DateTime[DateKey],-1,year))