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ê fosse classificar a lista, a ordem do número seria sua posição.

Importante

Essa função foi substituída por uma ou mais funções novas que podem fornecer maior precisão e cujos nomes refletem melhor seu uso. Esta função ainda está disponível para compatibilidade com versões anteriores do Excel. No entanto, se a compatibilidade com versões anteriores não for necessária, você deve 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

mais simples. 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 ordem for um valor diferente de zero, o Excel classificará o número como se ref fosse uma lista classificada em ordem crescente.

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, 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 terá 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) quanto em ordem crescente (ordem = valor diferente de 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, ORDEM(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 consideração os empates é 3 + 0,5 = 3,5.

  • Se o número ocorrer apenas uma vez na ref, o fator de correção será 0 porque a classificação não precisaria 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.