RANGE

Applies to:Calculated columnCalculated tableMeasureVisual calculation

Возвращает интервал строк в заданной оси относительно текущей строки. Этот интервал будет состоять из последних step строк до текущего или первых step строк после текущего.

Syntax

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

Parameters

Term	Definition
step	Число строк до (отрицательное значение) или после (положительное значение) текущей строки, включаемой в диапазон. Должно быть константным значением. — если отрицательно, окно будет содержать последние -step строки до текущей строки. — в противном случае окно будет содержать строки первого шага после текущей строки.
includeCurrent	(Необязательно) Логическое значение, указывающее, следует ли включать текущую строку в диапазон. Значение по умолчанию — True.
axis	(Необязательно) Ссылка на оси, направление, по которому будет создан интервал. Если опущено, используется первая ось определения визуальной фигуры.
orderBy	(Необязательно) Предложение ORDERBY() с выражениями, определяющими порядок сортировки каждой секции axisвдоль . Если orderBy данные не указаны, данные сортируются по столбцам группировки по умолчанию в порядке возрастания по умолчанию axis .
blanks	(Необязательно) Перечисление, определяющее, как обрабатывать пустые значения при сортировке axis. Поддерживаемые значения: DEFAULT (значение по умолчанию), где поведение числовых значений является пустыми значениями, упорядочены от нуля до отрицательных значений. Поведение строк является пустым значением, упорядоченным перед всеми строками, включая пустые строки. FIRST, пустые поля всегда упорядочены в начале независимо от возрастания или убывающего порядка сортировки. LAST, пустые всегда упорядочены в конце независимо от возрастания или убывания сортировки.
reset	(Необязательно) Указывает, сбрасывается ли вычисление и на каком уровне иерархии столбцов визуальной фигуры. Допустимые значения: ссылка на поле столбца в текущей визуальной форме, NONE (по умолчанию), LOWESTPARENT, HIGHESTPARENTили целое число. Поведение зависит от целочисленного знака: — если нулевая или опущенная, вычисление не сбрасывается. Эквивалентно NONE. — если положительный, целое число определяет столбец, начиная с самого высокого, независимо от зерна. HIGHESTPARENT эквивалентно 1. — если отрицательно, целое число определяет столбец, начиная с самого низкого, относительно текущего зерна. LOWESTPARENT эквивалентно -1.

Return value

Интервал строк данных.

Remarks

Эту функцию можно использовать только в визуальных вычислениях.

Параметр includeCurrent, axisorderByblanks и reset параметры могут быть опущены.

Если значение reset является абсолютным (т. е. положительным целым числом HIGHESTPARENT или ссылкой на поле), а вычисление вычисляется на целевом уровне иерархии или выше, вычисление сбрасывается для каждого отдельного элемента. То есть функция оценивается в секции, содержащей только этот конкретный элемент.

Example 1

Учитывая таблицу, которая суммирует общий объем продаж для каждой категории продукта и месяца, следующий запрос DAX добавляет столбец с общим объемом продаж за последние 6 месяцев:

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

Снимок экрана ниже: визуальная матрица и выражение визуального вычисления:

Example 2

Учитывая ту же таблицу, следующий запрос DAX добавляет столбец с общим объемом продаж в течение следующих 12 месяцев, не включая текущий месяц:

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

See also

INDEX ORDERBY PARTITIONBY WINDOW