# Mode - função de gráfico

Mode() encontra o valor mais comum, 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 [&lt;fld {,fld}&gt;]]} expr)

Tipo de dados de retorno: dual

Argumentos:

Argumentos

| Argumento | Descrição |
| --- | --- |
| 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 será 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.<br><br>Usando TOTAL [&lt;fld {.fld}&gt;], em que o qualificador TOTAL é seguido por uma lista de um ou mais nomes de campo como um subconjunto das variáveis de dimensão de gráfico, você cria um subconjunto dos valores possíveis totais.<br><br>[Definindo o escopo de agregação](https://help.qlik.com/pt-BR/sense/May2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/define-aggregation-scope.htm) |

Exemplos e resultados:

Dados

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

Exemplos e resultados

| Exemplos | Resultados |
| --- | --- |
| `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. |
| `Mode(TOTAL UnitPrice)` | 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>`Mode({1} TOTAL UnitPrice)` | 15, independentemente da seleção feita, pois a expressão Set Analysis {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 '|');`

## Saiba mais

* [Avg - função de gráfico](https://help.qlik.com/pt-BR/sense/May2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/StatisticalAggregationFunctionsinCharts/avg.htm)
* [Median - função de gráfico](https://help.qlik.com/pt-BR/sense/May2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/StatisticalAggregationFunctionsinCharts/median.htm)
* [Análise de conjunto](https://help.qlik.com/pt-BR/sense/May2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/SetAnalysis/set-analysis-expressions.htm)
* [Definindo o escopo de agregação](https://help.qlik.com/pt-BR/sense/May2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/define-aggregation-scope.htm)