# Mode - função de gráfico

Mode() encontra o valor mais geralmente ocorrido, o valor do modo, nos dados agregados. A função Mode() pode processar valores de texto, além de valores numéricos.

Sintaxe:

Mode([{SetExpression}] [TOTAL [<fld {,fld}>]] expr)

Tipo de dados de retorno: dual

Argumentos:

* expr: A expressão ou campo que contém os dados a serem medidos.

* SetExpression: Por padrão, a função de agregação agregará um conjunto de registros possíveis definidos pela seleção. Um conjunto de registros alternativos pode ser definido por uma expressão de análise.

* TOTAL: Se a palavra TOTAL ocorrer antes dos argumentos da função, o cálculo é feito sobre todos os valores possíveis, dadas as seleções atuais, e não apenas sobre os pertinentes ao valor dimensional atual, isto é, desconsiderando as dimensões do gráfico. O qualificador TOTAL pode vir seguido de uma lista de um ou mais nomes de campos dentro de sinais de maior e menor que <fld>. Esses nomes de campos devem ser um subconjunto das variáveis de dimensões do gráfico.

  [Definindo o escopo de agregação](https://help.qlik.com/pt-BR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/define-aggregation-scope.htm)

Exemplos:

Exemplos e resultados

| Exemplo | Resultado |
| --- | --- |
| `Mode(UnitPrice)`<br><br>Faça a seleção `Customer A`. | 15, porque esse é o valor que ocorre mais comumente em `UnitSales`.<br><br>Retorna NULL (-). Nenhum valor único ocorre mais frequentemente que o outro. |
| `Mode(Product)`<br><br>Faça a seleção `Customer A`. | AA, porque esse é o valor que ocorre mais comumente em `Product`.<br><br>Retorna NULL (-). Nenhum valor único ocorre mais frequentemente que o outro. |
| `<br>Mode(TOTAL UnitPrice)<br>` | 15, porque o qualificador TOTAL significa que o valor que ocorre mais comumente ainda é 15, desconsiderando as dimensões do gráfico. |
| Faça a seleção`  Customer B `.<br><br>`<br>Mode)({1} TOTAL UnitPrice)<br>` | 15, independentemente da seleção feita, porque a Set Analysis expressão {1} define o conjunto de registros a ser avaliado como ALL, independente da seleção feita. |

**Dados usados nos exemplos:**

`ProductData:` `LOAD * inline [` `Customer|Product|UnitSales|UnitPrice` `Astrida|AA|4|16` `Astrida|AA|10|15` `Astrida|BB|9|9` `Betacab|BB|5|10` `Betacab|CC|2|20` `Betacab|DD||25` `Canutility|AA|8|15` `Canutility|CC||19` `] (delimiter is '|');`

Dados de exemplo em formato de tabela

| Customer | Product | UnitSales | UnitPrice |
| --- | --- | --- | --- |
| Astrida | AA | 4 | 16 |
| Astrida | AA | 10 | 15 |
| Astrida | BB | 9 | 9 |
| Betacab | BB | 5 | 10 |
| Betacab | CC | 2 | 20 |
| Betacab | DD | - | 25 |
| Canutility | AA | 8 | 15 |
| Canutility | CC | - | 19 |

## Saiba mais

* [Avg - função de gráfico](https://help.qlik.com/pt-BR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/StatisticalAggregationFunctionsinCharts/avg.htm)
* [Median - função de gráfico](https://help.qlik.com/pt-BR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/StatisticalAggregationFunctionsinCharts/median.htm)
* [Análise de conjunto e expressões de conjunto](https://help.qlik.com/pt-BR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/SetAnalysis/set-analysis-expressions.htm)
* [Definindo o escopo de agregação](https://help.qlik.com/pt-BR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/define-aggregation-scope.htm)