# RangeAvg — функция скриптa и диаграммы

RangeAvg() возвращает среднее значение диапазона. Для ввода в функцию может использоваться диапазон значений или выражение.

Синтаксис:

RangeAvg(first\_expr[, Expression])

Возвращаемые типы данных: числовое значение

Аргументы:

Аргументы этой функции могут содержать межзаписные функции, которые в свою очередь возвращают список значений.

Аргументы

| Аргумент | Описание |
| --- | --- |
| first\_expr | Выражение или поле, содержащее данные для измерения. |
| Expression | Дополнительные выражения или поля, содержащие диапазон значений для измерения. |

Ограничения:

Если числовые значения не найдены, возвращается значение NULL.

Примеры и результаты:

Примеры написания скриптов

| Примеры | Результаты |
| --- | --- |
| `RangeAvg   (1,2,4)` | Возвращает 2,33333333 |
| `RangeAvg   (1,'xyz')` | Возвращает 1 |
| `RangeAvg   (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/ru-RU/sense/November2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/StatisticalAggregationFunctionsinCharts/avg.htm)
* [Count — функция диаграммы](https://help.qlik.com/ru-RU/sense/November2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/CounterAggregationFunctions/count.htm)