# 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 |

範例：

將範例指令碼新增至您的應用程式並予以執行。若要查看結果，將結果資料行中列出的欄位新增至您應用程式中的工作表。

`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 |

運算式範例：

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

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

範例中使用的資料：

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

樣本資料

| MyField | RangeAvg (Above(MyField,0,3)) | Comments |
| --- | --- | --- |
| 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``] ;`

## 瞭解更多資訊

* [Avg - 圖表函數](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/StatisticalAggregationFunctionsinCharts/avg.htm)
* [Count - 圖表函數](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/CounterAggregationFunctions/count.htm)