RANGE

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Devolve um intervalo de linhas dentro de um determinado eixo, relativo à linha atual. Esse intervalo será composto pelas últimas step linhas antes da atual ou pelas primeiras step linhas após a atual.

Sintaxe

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

Parâmetros

Vigência	Definição
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 negativo, a janela conterá as últimas -step linhas antes da linha atual. - Caso contrário, a janela conterá as linhas do primeiro passo 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.
blanks	(Opcional) Uma enumeração que define como manipular valores em branco ao classificar o axis. Os valores suportados são: DEFAULT (o valor padrão), onde o comportamento para valores numéricos é valores em branco são ordenados entre zero e valores negativos. O comportamento para cadeias de caracteres é valores em branco são ordenados antes de todas as cadeias de caracteres, incluindo cadeias 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 que 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 é reiniciado. Equivalente a NONE. - Se positivo, o inteiro identifica a coluna a partir do mais alto, independente do grão. HIGHESTPARENT equivale a 1. - Se negativo, o inteiro identifica a coluna a partir do mais baixo, em relação ao grão atual. LOWESTPARENT é equivalente a -1.

Valor de retorno

Um intervalo de linhas de dados.

Comentários

Esta função pode ser usada apenas em cálculos visuais.

Os parâmetros includeCurrent, axis, blanks e reset podem ser omitidos.

Exemplo 1

Dada uma tabela que resume as vendas totais 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:

Exemplo 2

Dada a mesma tabela, a seguinte consulta DAX adiciona uma coluna com o total de vendas nos 12 meses seguintes, não incluindo o mês atual:

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

Ver também

INDEX ORDERBY PARTITIONBY WINDOW