WorksheetFunction.Rank(Double, Range, Object) Método

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

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 a sua posição).

public double Rank (double Arg1, Microsoft.Office.Interop.Excel.Range Arg2, object Arg3);

Public Function Rank (Arg1 As Double, Arg2 As Range, Optional Arg3 As Object) As Double

Parâmetros

Arg1

Double

Núm - o número cuja posição se deseja encontrar.

Arg2

Range

Ref - uma matriz ou referência a uma lista de números. Valores não numéricos em ref são ignorados.

Arg3

Object

Ordem - um número que especifica como posicionar um número em uma ordem.

Retornos

Double

Comentários

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 Rank_Eq(Double, Range, Object) métodos e Rank_Avg(Double, Range, Object) .

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 qualquer valor diferente de zero, o Microsoft Excel ordenará o número como se ref fosse uma lista classificada na ordem ascendente.

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 números inteiros classificados em ordem crescente, se o número 10 aparecer duas vezes e tiver uma ordem de 5, então 11 teria uma ordem de 7 (nenhum número teria uma ordem de 6).

Para algumas finalidades, é possível usar uma definição de ordem que considere os empates. No exemplo anterior, precisaríamos de uma ordem revista de 5,5 para o número 10. Isso pode ser feito adicionando 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 ranks=[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 ordem revisada que considera o empate é 3 + 0,5 = 3,5. Se o número ocorrer apenas uma vez no ref, o fator de correção será 0, já que Rank não precisará ser ajustado para um empate.