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

Définition

Espace de noms:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Renvoie le rang d’un nombre dans une liste de nombres. Le rang d’un nombre est donné par sa taille comparée aux autres valeurs de la liste. (Si vous deviez trier la liste, le rang d’un nombre serait sa position).

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

Paramètres

Arg1

Double

Number - nombre dont vous souhaitez trouver le rang.

Arg2

Range

Ref - tableau contenant une liste de nombres, ou référence à cette liste. Les valeurs non numériques de l'argument ref ne sont pas prises en compte.

Arg3

Object

Order - nombre spécifiant le mode de classement du nombre.

Retours

Double

Remarques

Important : cette fonction a été remplacée par une ou plusieurs nouvelles fonctions qui peuvent offrir une meilleure précision et dont les noms reflètent mieux leur utilisation. Cette fonction est toujours disponible pour assurer la compatibilité avec les versions antérieures d'Excel. Toutefois, si la compatibilité descendante n'est pas requise, vous devriez envisager d'utiliser les nouvelles fonctions à partir de maintenant, car elles décrivent plus précisément leur usage. Pour plus d’informations sur les nouvelles fonctions, consultez les Rank_Eq(Double, Range, Object) méthodes et Rank_Avg(Double, Range, Object) .

Si l'ordre prend la valeur 0 (zéro) ou est omis, Microsoft Excel classe le nombre comme si l'argument ref était une liste triée par ordre décroissant.

Si l'ordre prend une autre valeur, Microsoft Excel classe le nombre comme si l'argument ref était une liste triée par ordre croissant.

Le classement donne le même rang aux nombres en double. Cependant, la présence de nombres en double affecte les rangs des nombres suivants. Par exemple, dans une liste d'entiers triés par ordre croissant, si le nombre 10 apparaît deux fois avec le rang 5, le nombre 11 est situé au rang 7 (aucun numéro n'a le rang 6).

Vous pouvez décider d’utiliser une définition de rang qui tienne compte des attaches. Dans l’exemple précédent, un utilisateur souhaite utiliser un rang révisé de 5,5 pour le nombre 10. Pour ce faire, ajoutez le facteur de correction suivant à la valeur retournée par Rank. Ce facteur de correction est approprié dans les deux cas où le rang est calculé dans l’ordre décroissant (ordre = 0 ou omis) ou l’ordre croissant (ordre = valeur différente de zéro).

Facteur de correction pour les rangs liés=[COUNT(ref) + 1 – RANK(nombre, ref, 0) – RANK(nombre, ref, 1)]/2.

Dans l’exemple suivant, RANK(A2,A1:A5,1) est égal à 3. Le facteur de correction est (5 + 1 – 2 – 3)/2 = 0,5 et le rang révisé qui prend les liens en compte est 3 + 0,5 = 3,5. Si le nombre ne se produit qu’une seule fois dans la référence, le facteur de correction sera 0, car le rang n’a pas besoin d’être ajusté pour une égalité.