# 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/ru-RU/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/StatisticalAggregationFunctionsinCharts/avg.htm)
* [Count](https://help.qlik.com/ru-RU/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/CounterAggregationFunctions/count.htm)
* [NumAvg](https://help.qlik.com/ru-RU/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/RangeFunctions/NumAvg.htm)