Método WorksheetFunction.AverageIf (Excel)

Retorna a média (aritmética) de todas as células em um intervalo que satisfazem um determinado critério.

Sintaxe

expressão. AverageIf (Arg1, Arg2, Arg3)

expressão Uma variável que representa um objeto WorksheetFunction .

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Arg1	Obrigatório	Range	Uma ou mais células para calcular a média.
Arg2	Obrigatório	Variant	O critério na forma de um número, expressão, referência de célula ou texto que define para quais células será calculada a média. Por exemplo, os critérios podem ser expressos como 32, "32", ">32", "maçãs" ou B4.
Arg3	Opcional	Variant	O conjunto real de células para calcular a média. Se omitido, o intervalo é usado.

Valor de retorno

Double

Comentários

As células num intervalo que contenham Verdadeiro ou Falso são ignoradas.

Se uma célula num intervalo ou average_range for uma célula vazia, AverageIf ignora-a.

Se uma célula nos critérios estiver vazia, AverageIf trata-a como um valor 0.

Se nenhuma célula no intervalo cumprir os critérios, AverageIf gera um valor de erro.

Utilize os carateres universais, o ponto de interrogação (?) e o asterisco (*), nos critérios. Um ponto de interrogação corresponde a qualquer caractere único; um asterisco corresponde a qualquer sequência de caracteres. Se você quiser localizar um ponto de interrogação ou um asterisco, digite um til (~) antes do caractere.

Intervalo_média não precisa ter o mesmo tamanho e a mesma forma do intervalo. As células reais para as quais é calculada a média são determinadas pelo uso da célula superior esquerda em intervalo_média como a célula inicial e, em seguida, pela inclusão das células que correspondem em tamanho e forma ao intervalo. Por exemplo:

Se o intervalo for	E intervalo_média for	As células reais avaliadas são
A1:A5	B1:B5	B1:B5
A1:A5	B1:B3	B1:B5
A1:B4	C1:D4	C1:D4
A1:B4	C1:C2	C1:D4

Observação

O método AverageIf mede a tendência central, que é a localização do centro de um grupo de números numa distribuição estatística. Estas são as três medidas de tendência central mais comuns:

• Média, que é a média aritmética, e é calculada ao adicionar um grupo de números e, em seguida, dividir pela contagem desses números. Por exemplo, a média de 2, 3, 3, 5, 7 e 10 é 30 dividido por 6, que é 5.
• Mediana, que é o número médio de um grupo de números; ou seja, metade dos números tem valores maiores do que a mediana e metade dos números tem valores inferiores à mediana. Por exemplo, a mediana de 2, 3, 3, 5, 7 e 10 é 4.
• Modo, que é o número que ocorre mais frequentemente num grupo de números. Por exemplo, o modo de 2, 3, 3, 5, 7 e 10 é 3.

Para uma distribuição simétrica de um grupo de números, estas três medidas de tendência central são as mesmas. Para uma distribuição enviesada de um grupo de números, elas podem ser diferentes.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.