# RangeSum - 指令碼與圖表函數

RangeSum() 會傳回一個範圍值的加總。與 + 運算子不同，會將所有非數值視為 0。

語法：

RangeSum(first\_expr[, Expression])

傳回的資料類型： 數值

引數：

此函數的引數可包含其本身就會傳回值清單的記錄間函數。

* first\_expr：包含待加總資料的運算式或欄位。
* Expression：包含待加總資料範圍的選用運算式或欄位。 可以使用的多個其他運算式。

限制：

RangeSum 函數會將所有非數值視為 0，和 + 運算子不同。

範例：

範例與結果

| 範例 | 結果 |
| --- | --- |
| `RangeSum<br>(1,2,4)` | 傳回 7 |
| `RangeSum<br>(5,'abc')` | 傳回 5 |
| `RangeSum<br>(null( ))` | 傳回 0 |

範例： (使用運算式)

`RangeSum (Above(MyField,0,3))`

傳回 MyField) 三個值的加總：從目前列和目前列上方兩列。若將第三個引數指定為 3，則 Above() 函數會傳回三個值 (上方需有足夠的列)，並做為 RangeSum() 函數的輸入。

提示備註停用 MyField 的排序可確保範例按預期運作。

運算式輸出範例

| MyField | RangeSum(Above(MyField,0,3)) |
| --- | --- |
| 10 | 10 |
| 2 | 12 |
| 8 | 20 |
| 18 | 28 |
| 5 | 31 |
| 9 | 32 |

**範例中使用的資料：**

`RangeTab:` `LOAD * INLINE [` `MyField` `10` `2` `8` `18` `5` `9` `] ;`

範例： (表格形式)

新增範例指令碼到您的文件中並加以執行。然後至少將結果資料行中所列的欄位新增至您文件中的工作表，以查看結果。

`RangeTab3:` `LOAD recno() as RangeID, Rangesum(Field1,Field2,Field3) as MyRangeSum INLINE [` `Field1, Field2, Field3` `10,5,6` `2,3,7` `8,2,8` `18,11,9` `5,5,9` `9,4,2`

`];`

產生的表格顯示表格中各記錄的 MyRangeSum 傳回值。

表格形式的輸出範例

| RangeID | MyRangeSum |
| --- | --- |
| 1 | 21 |
| 2 | 12 |
| 3 | 18 |
| 4 | 38 |
| 5 | 19 |
| 6 | 15 |

## 瞭解更多資訊

* [Sum- 圖表函數](https://help.qlik.com/zh-TW/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/BasicAggregationFunctions/sum.htm)
* [Above](https://help.qlik.com/zh-TW/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/InterRecordFunctions/above.htm)
* [NumSum - 指令碼與圖表函數](https://help.qlik.com/zh-TW/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/RangeFunctions/NumSum.htm)