Método WorksheetFunction.Rank (Excel)

Retorna a posição de um número em uma lista de números. A ordem de um número é seu tamanho em relação a outros valores de uma lista. Se você classificasse a lista, a classificação do número seria sua posição.

Importante

Essa função foi substituída por uma ou mais novas funções que podem fornecer maior precisão e cujos nomes refletem melhor seu uso. Essa função ainda está disponível para compatibilidade com versões anteriores do Excel. No entanto, se a compatibilidade com a reversão não for necessária, você deverá considerar o uso das novas funções a partir de agora, pois elas descrevem com mais precisão sua funcionalidade.

Para obter mais informações sobre as novas funções, consulte os métodos Rank_Eq e Rank_Avg .

Sintaxe

expressão. Classificação (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	Double	Núm - o número cuja posição se deseja encontrar.
Arg2	Obrigatório	Range	Ref - uma matriz ou referência a uma lista de números. Valores não numéricos em ref são ignorados.
Arg3	Opcional	Variantes	Ordem - um número que especifica como posicionar um número em uma ordem.

Valor de retorno

Double

Comentários

Se ordem for 0 ou omitido, o Microsoft Excel ordenará o número como se ref fosse uma lista classificada na ordem descendente.

Se a ordem for qualquer valor não zero, o Excel classificará o número como se ref fosse uma lista classificada em ordem crescente.

Rank fornece números duplicados a mesma classificação. No entanto, a presença de números duplicados afeta a ordem dos números subsequentes. Por exemplo, em uma lista de inteiros classificados em ordem crescente, se o número 10 aparecer duas vezes e tiver uma classificação de 5, 11 teria uma classificação de 7 (nenhum número teria uma classificação de 6).

Para algumas finalidades, talvez seja interessante usar uma definição de classificação que considere vínculos. No exemplo anterior, você precisava de uma ordem revista de 5,5 para o número 10. Para fazer isso, adicione o seguinte fator de correção ao valor retornado por Rank. Esse fator de correção é apropriado tanto para o caso em que a classificação é calculada em ordem decrescente (ordem = 0 ou omitida) ou ordem crescente (ordem = valor não zero).

• Fator de correção para classificações empatadas =[COUNT(ref) + 1 – RANK(number, ref, 0) – RANK(number, ref, 1)]/2.

• No exemplo a seguir, RANK(A2,A1:A5,1) é igual a 3. O fator de correção é (5 + 1 – 2 – 3)/2 = 0,5 e a classificação revisada que leva em conta os laços é 3 + 0,5 = 3,5.

• Se o número ocorrer apenas uma vez no ref, o fator de correção será 0 porque Rank não precisará ser ajustado para um empate.

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.