# Avg - função de gráfico

Avg() retorna a média agregada da expressão ou campo repetida nas dimensões de gráfico.

Sintaxe:

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

Tipo de dados de retorno: numérico

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.

* DISTINCT: Se a palavra DISTINCT aparecer antes dos argumentos de função, as duplicatas resultantes da avaliação dos argumentos de função serão ignoradas.

* 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/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/define-aggregation-scope.htm)

Limitações:

O parâmetro da função de agregação não deve conter outras funções de agregação, a menos que essas agregações internas contenham o qualificador TOTAL. Para agregações aninhadas mais avançadas, use a função avançada Aggr em combinação com uma dimensão especificada.

Exemplos:

Exemplos e resultados

| Exemplo | Resultado |
| --- | --- |
| `Avg(Sales)` | Para uma tabela incluindo a dimensão `Customer` e a medição `Avg([Sales])`, se os Totais forem mostrados, o resultado será 2566. |
| `Avg([TOTAL (Sales))` | 53.458333 para todos os valores de `Customer`, porque o qualificador TOTAL significa que as dimensões são desconsideradas. |
| `Avg(DISTINCT (Sales))` | 51,862069 para o total, porque usar o qualificador Distinct significa que apenas valores únicos em `Sales` para cada `Customer` são avaliados. |

Exemplo de saída em formato de tabela

| Customer | Sum(Sales) | Avg(Sales) | Avg(TOTAL Sales) | Avg(DISTINCT Sales) | Avg({1}DISTINCT Sales) |
| --- | --- | --- | --- | --- | --- |
| - | 2566 | 53.46 | 53.458333 | 51.862069 | 53.458333 |
| Astrida | 587 | 48.92 | 53.458333 | 43.1 | 53.458333 |
| Betacab | 539 | 44.92 | 53.458333 | 43.909091 | 53.458333 |
| Canutility | 683 | 56.92 | 53.458333 | 55.909091 | 53.458333 |
| Divadip | 757 | 63.08 | 53.458333 | 61 | 53.458333 |

**Dados usados nos exemplos:**

`Monthnames:` `LOAD * INLINE [` `Month, Monthnumber` `Jan, 1` `Feb, 2` `Mar, 3` `Apr, 4` `May, 5` `Jun, 6` `Jul, 7` `Aug, 8` `Sep, 9` `Oct, 10` `Nov, 11` `Dec, 12` `];` `Sales2013:
` `crosstable (Month, Sales) LOAD * inline [
` `Customer|Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec` `Astrida|46|60|70|13|78|20|45|65|78|12|78|22` `Betacab|65|56|22|79|12|56|45|24|32|78|55|15` `Canutility|77|68|34|91|24|68|57|36|44|90|67|27` `Divadip|57|36|44|90|67|27|57|68|47|90|80|94` `] (delimiter is '|');`

Para obter os meses para classificar na ordem correta, ao criar seus gráficos, acesse a aba Sort das propriedades do gráfico e marque a caixa de seleção Expression em Sort by. Na caixa de expressões, escreva `Monthnumber`.

Dados de exemplo em formato de tabela

| Customer | Jan | Feb | Mar | Apr | May | Jun | Jul | Aug | Sep | Oct | Nov | Dec |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| Astrida | 46 | 60 | 70 | 13 | 78 | 20 | 45 | 65 | 78 | 12 | 78 | 22 |
| Betacab | 65 | 56 | 22 | 79 | 12 | 56 | 45 | 24 | 32 | 78 | 55 | 15 |
| Canutilidade | 77 | 68 | 34 | 91 | 24 | 68 | 57 | 36 | 44 | 90 | 67 | 27 |
| Divadip | 57 | 36 | 44 | 90 | 67 | 27 | 57 | 68 | 47 | 90 | 80 | 94 |

## Saiba mais

* [Aggr](https://help.qlik.com/pt-BR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/aggr.htm)
* [Análise de conjunto e expressões de conjunto](https://help.qlik.com/pt-BR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/SetAnalysis/set-analysis-expressions.htm)