# RangeAvg- 指令碼與圖表函數

RangeAvg() 會傳回範圍的平均值。函數的輸入可以是一個範圍的值，也可以是運算式。

語法：

RangeAvg(first\_expr[, Expression])

傳回的資料類型： 數值

引數：

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

* first\_expr：包含待平均資料的運算式或欄位。
* Expression：包含待平均額外資料的選用運算式或欄位。 可以使用的多個其他運算式。

限制：

如果找不到數值，則會傳回 NULL。

範例：

範例與結果

| 範例 | 結果 |
| --- | --- |
| `RangeAvg<br>(1,2,4)` | 傳回 2.33333333 |
| `RangeAvg<br>(1,'xyz')` | 傳回 1 |
| `RangeAvg<br>(null( ), 'abc')` | 傳回 NULL |

範例： (使用運算式)

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

傳回 MyField 針對目前列和目前列上方兩列，計算出三個值之範圍結果的滑動平均。若將第三個引數指定為 3，則 Above() 函數會傳回三個值 (上方需有足夠的列)，並做為 RangeAvg() 函數的輸入。

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

運算式輸出範例

| MyField | RangeAvg (Above(MyField,0,3)) | 解釋 |
| --- | --- | --- |
| 10 | 10 | 因為這是頂端列，故範圍只包含一個值。 |
| 2 | 6 | 此列上方只有一列，因此範圍是：10,2。 |
| 8 | 6.6666666667 | 相當於 RangeAvg(10,2,8) |
| 18 | 9.333333333 | - |
| 5 | 10. 333333333 | - |
| 9 | 10.6666666667 | - |

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

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

範例： (表格形式)

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

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

`];`

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

表格形式的輸出範例

| RangeID | MyRangeAvg |
| --- | --- |
| 1 | 7 |
| 2 | 4 |
| 3 | 6 |
| 4 | 12.666 |
| 5 | 6.333 |
| 6 | 5 |

## 瞭解更多資訊

* [Avg - 圖表函數](https://help.qlik.com/zh-TW/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/StatisticalAggregationFunctionsinCharts/avg.htm)
* [Count](https://help.qlik.com/zh-TW/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/CounterAggregationFunctions/count.htm)
* [NumAvg](https://help.qlik.com/zh-TW/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/RangeFunctions/NumAvg.htm)