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	（選擇性）座標軸參考，用來建立間隔的方向。 如果省略，則會使用 Visual Shape 定義的第一個座標軸。
orderBy	（選擇性）具有 ORDERBY表達式的 （） 子句，決定如何沿著 排序每個分割區 axis。 如果未 orderBy 提供 ，則數據會依預設 axis 的群組數據行依預設的遞增順序排序。
blanks	（選擇性）列舉，定義排序 axis時如何處理空白值。 支援的值為： DEFAULT （預設值），其中數值的行為是空白值，會在零和負值之間排序。 字串的行為是空白值，會在所有字串之前排序，包括空字串。 FIRST，不論遞增或遞減排序順序為何，一律會在開頭排序空白。 LAST，不論遞增或遞減排序順序為何，一律會在結尾排序空白。
reset	（選擇性）指出計算是否重設，以及視覺圖形數據行階層的哪個層級。 接受的值包括：目前視覺圖形中數據行的欄位參考、NONE（預設值）、LOWESTPARENT、HIGHESTPARENT或整數。 行為取決於整數符號： - 如果零或省略，則計算不會重設。 相當於 NONE。 - 如果為正數，整數會識別從最高、與粒紋無關的數據行。 HIGHESTPARENT 相當於1。 - 如果為負數，整數會識別從最低開始的數據行，相對於目前的粒紋。 LOWESTPARENT 相當於 -1。

Return value

數據列的間隔。

Remarks

此函式只能在視覺計算中使用。

includeCurrent可以省略、 axisorderBy和 resetblanks 參數。

如果的值 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