RANGE

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

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

Sintaxe

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

Parâmetros

Termo	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 for negativo, a janela conterá as linhas da última etapa 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.
em branco	(Opcional) Uma enumeração que define como manipular valores em branco durante a classificação. Os valores com suporte são: DEFAULT (o valor padrão), em que o comportamento de valores numéricos é valores em branco são ordenados entre valores zero e negativos. 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 fim, independentemente da ordem de classificação crescente ou decrescente.
reset	(Opcional) Indica se o cálculo será redefinido e em qual nível da hierarquia de colunas da forma visual. Os valores aceitos são: NONE, LOWESTPARENT, HIGHESTPARENT, ou um inteiro. O comportamento depende do sinal do número inteiro: - Se for zero ou omitido, o cálculo não será redefinido. Equivalente a NONE. - Se positivo, o inteiro identificará a coluna começando pela mais alta, independentemente da granularidade. HIGHESTPARENT é equivalente a 1. - Se negativo, o inteiro identificará a coluna a partir da mais baixa, em relação à granularidade atual. LOWESTPARENT é equivalente a -1.

Valor retornado

Um intervalo de linhas de dados.

Comentários

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

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

Exemplo 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:

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

Confira também

INDEX
ORDERBY
PARTITIONBY
WINDOW