Compartilhar via


RANGE

Applies to:Calculated columnCalculated tableMeasureVisual calculation

Retorna um intervalo de linhas dentro do eixo especificado, em relação à linha atual. Esse intervalo será composto pelas últimas linhas de step antes da atual ou da primeira step linhas após a atual.

Syntax

RANGE ( <step>[, <includeCurrent>][, <axis>][, <orderBy>][, <blanks>][, <reset>] )

Parameters

Term Definition
step O número de linhas antes (valor negativo) ou depois (valor positivo) da linha atual a ser incluída no intervalo. Deve ser um valor constante.
- Se for negativo, a janela conterá as últimas linhas de -step antes da linha atual.
- Caso contrário, a janela conterá as primeiras linhas de etapa após a linha atual.
includeCurrent (Opcional) Um valor lógico que especifica se a linha atual deve ou não ser incluída no intervalo. O valor padrão é True.
axis (Opcional) Uma referência de eixo, a direção ao longo da qual o intervalo será criado. Se omitido, o primeiro eixo da definição de Forma Visual será usado.
orderBy (Opcional) Uma ORDERBYcláusula () com expressões que determinam como classificar cada partição ao longo da axis. Se orderBy não for fornecido, os dados serão classificados pelas colunas de agrupamento no padrão axis em ordem crescente por padrão.
blanks (Opcional) Uma enumeração que define como lidar com valores em branco ao classificar o axis.
os valores com suporte são:
  • DEFAULT (o valor padrão), em que o comportamento dos valores numéricos é ordenado entre valores zero e negativo. O comportamento das cadeias de caracteres é que os valores em branco são ordenados antes de todas as cadeias de caracteres, incluindo cadeias de caracteres vazias.
  • FIRST, os espaços em branco são sempre ordenados no início, independentemente da ordem de classificação crescente ou decrescente.
  • LAST, os espaços em branco são sempre ordenados no final, independentemente da ordem de classificação crescente ou decrescente.
reset (Opcional) Indica se o cálculo é redefinido e em qual nível da hierarquia de colunas da forma visual. Os valores aceitos são: uma referência de campo a uma coluna na forma visual atual, NONE (padrão), LOWESTPARENT, HIGHESTPARENTou um inteiro. O comportamento depende do sinal inteiro:
– se zero ou omitido, o cálculo não é redefinido. Equivalente a NONE.
- Se positivo, o inteiro identifica a coluna a partir da mais alta, independente da granulação. HIGHESTPARENT é equivalente a 1.
- Se negativo, o inteiro identifica a coluna a partir do menor, em relação ao grão atual. LOWESTPARENT é equivalente a -1.

Return value

Um intervalo de linhas de dados.

Remarks

Essa função só pode ser usada em cálculos visuais.

Os includeCurrentparâmetros , axise resetorderByblanks podem ser omitidos.

Se o valor for reset absoluto (ou seja, um inteiro HIGHESTPARENT positivo ou uma referência de campo) e o cálculo for avaliado em ou acima do nível de destino na hierarquia, o cálculo será redefinido para cada elemento individual. Ou seja, a função é avaliada dentro de uma partição que contém apenas esse elemento específico.

Example 1

Considerando uma tabela que resume o total de vendas para cada categoria de produto e mês, a seguinte consulta DAX adiciona uma coluna com o total de vendas nos últimos 6 meses:

TotalSalesLast6Months = CALCULATE(SUM([SalesAmount]), RANGE(-5, Rows))

A captura de tela abaixo mostra a matriz visual e a expressão de cálculo visual:

DAX cálculo visual

Example 2

Considerando a mesma tabela, a seguinte consulta DAX adiciona uma coluna com o total de vendas nos 12 meses seguintes, sem incluir o mês atual:

TotalSalesFollowingYear = CALCULATE(SUM([SalesAmount]), RANGE(12, FALSE, Rows, KEEP))

See also

INDEX ORDERBY PARTITIONBY WINDOW