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 ordenasse a lista, a classificação do número seria a respetiva posição.

Importante

Esta função foi substituída por uma ou mais novas funções que podem fornecer uma maior precisão e cujos nomes refletem melhor a sua utilização. Esta função ainda está disponível para compatibilidade com versões anteriores do Excel. No entanto, se a retrocompatibilidade não for necessária, deve considerar utilizar as novas funções a partir de agora, uma vez que descrevem com maior precisão a respetiva funcionalidade.

Para obter mais informações sobre as novas funções, veja 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	Variant	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 diferente de zero, o Excel classifica o número como se ref fosse uma lista ordenada por ordem ascendente.

A classificação dá aos 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, numa lista de números inteiros ordenados por ordem ascendente, 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 tal, adicione o seguinte fator de correção ao valor devolvido por Ordem. Este fator de correção é adequado para o caso em que a classificação é calculada por ordem descendente (ordem = 0 ou omitido) ou ordem ascendente (ordem = valor diferente de zero).

• Fator de correção para classificações empatadas =[CONTAR(ref) + 1 – ORDEM(número, ref, 0) – ORDEM(número, ref, 1)]/2.

• No exemplo seguinte, ORDEM(A2;A1:A5;1) é igual a 3. O fator de correção é (5 + 1 – 2 – 3)/2 = 0,5 e a classificação revista que tem 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 a Classificação não teria de ser ajustada 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.