# RangeSum Função de script e de gráfico

O RangeSum() retorna a soma de um intervalo de valores. Todos os valores não numéricos são tratados como 0.

Sintaxe:

RangeSum(first\_expr[, Expression])

Tipo de dados de retorno: numérico

Argumentos:

Os argumentos dessa função podem conter funções interregistro, que por si só retornam um intervalo de valores.

Argumentos

| Argumento | Descrição |
| --- | --- |
| first\_expr | A expressão ou campo que contém os dados a serem medidos. |
| Expression | Expressões ou campos opcionais que contêm o intervalo de dados a ser medido. |

Limitações:

A função RangeSum trata todos os valores não numéricos como 0.

Exemplos e resultados:

Exemplos

| Exemplos | Resultados |
| --- | --- |
| `RangeSum<br>(1,2,4)` | Retorna 7 |
| `RangeSum<br>(5,'abc')` | Retorna 5 |
| `RangeSum<br>(null( ))` | Retorna 0 |

Exemplo:

Adicione o script de exemplo ao seu aplicativo e execute-o. Para ver o resultado, adicione os campos listados na coluna de resultados a uma pasta no seu aplicativo.

`RangeTab3:` `LOAD recno() as RangeID, Rangesum(Field1,Field2,Field3) as MyRangeSum 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 de MyRangeSum para cada um dos registros na tabela.

Tabela resultante

| RangeID | MyRangeSum |
| --- | --- |
| 1 | 21 |
| 2 | 12 |
| 3 | 18 |
| 4 | 38 |
| 5 | 19 |
| 6 | 15 |

Exemplo com a expressão:

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

Retorna a soma de três valores de MyField): na linha atual e 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 RangeSum().

Dados usados nos exemplos:

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

Dados de amostra

| MyField | RangeSum(Above(MyField,0,3)) |
| --- | --- |
| 10 | 10 |
| 2 | 12 |
| 8 | 20 |
| 18 | 28 |
| 5 | 31 |
| 9 | 32 |

Dados usados nos exemplos:

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

## Saiba mais

* [Sum - função de gráfico](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/BasicAggregationFunctions/sum.htm)
* [Above - função de gráfico](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/InterRecordFunctions/above.htm)