# RangeAvg – função de script e gráfico

RangeAvg() retorna a média de um intervalo. A entrada para a função pode ser um intervalo de valores ou uma expressão.

RangeAvg(first\_expr[, Expression])

Tipo de dados de retorno: numérico

O argumento dessa função pode conter funções inter-registro, o que por si só retorna uma lista de valores.

* first\_expr: expressão ou campo que contém os dados cuja média será calculada.
* Expression: Expressões ou campos opcionais contendo dados adicionais para o cálculo da média. Várias expressões adicionais podem ser usadas.

Se não for encontrado nenhum valor numérico, será retornado NULL.

Exemplos e resultados

| Exemplo | Resultado |
| --- | --- |
| `RangeAvg<br>(1,2,4)` | Retorna 2,33333333 |
| `RangeAvg<br>(1,'xyz')` | Retorna 1 |
| `RangeAvg<br>(null( ), 'abc')` | Retorna<br>NULL |

Exemplo: (usando a expressão)

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

Retorna uma média variável do resultado do intervalo dos três valores de MyField calculado na linha atual e nas duas linhas acima da atual. Ao especificar o terceiro argumento como 3, a função Above() retorna três valores, em que há linhas suficientes acima, que são tomadas como entrada na função RangeAvg().

Nota de dicaDesative a classificação de MyField para garantir que o exemplo funcione como esperado.

Exemplo de saída de expressão

| MyField | RangeAvg (Above(MyField,0,3)) | Explicação |
| --- | --- | --- |
| 10 | 10 | Com esta é a linha do topo, o intervalo consiste em apenas um valor. |
| 2 | 6 | Há apenas uma linha acima desta linha, portanto, o intervalo é: 10,2. |
| 8 | 6.6666666667 | O equivalente a RangeAvg(10,2,8) |
| 18 | 9.333333333 | - |
| 5 | 10<br>333333333 | - |
| 9 | 10.6666666667 | - |

**Dados usados nos exemplos:**

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

Exemplo: (em forma de tabela)

Adicione o script de exemplo ao seu documento e execute-o. Em seguida, adicione pelo menos os campos listados na coluna de resultados a um documento para ver o resultado.

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

`];`

A tabela resultante mostra os valores retornados deMyRangeAvg para cada registro na tabela.

Exemplo de saída em forma de tabela

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

[Avg - função de gráfico](https://help.qlik.com/pt-BR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/StatisticalAggregationFunctionsinCharts/avg.htm)

[Count](https://help.qlik.com/pt-BR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/CounterAggregationFunctions/count.htm)

[NumAvg](https://help.qlik.com/pt-BR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/RangeFunctions/NumAvg.htm)