Méthode WorksheetFunction.Rank (Excel)

  • Article

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 du nombre serait sa position.

Importante

Cette fonction a été remplacée par de nouvelles fonctions qui peuvent fournir 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 méthodes Rank_Eq et Rank_Avg .

Syntaxe

expression. Rang (Arg1, Arg2, Arg3)

Expression Variable qui représente un objet WorksheetFunction .

Parameters

Nom Requis/Facultatif Type de données Description
Arg1 Obligatoire Double Number - nombre dont vous souhaitez trouver le rang.
Arg2 Obligatoire Plage 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 Facultatif Variant Ordre - nombre spécifiant le mode de classement du nombre.

Valeur renvoyée

Double

Remarques

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 est une valeur différente de zéro, Excel classe le nombre comme si ref était une liste triée dans l’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 et a un rang de 5, 11 a un rang de 7 (aucun nombre n’a un rang de 6).

Pour certaines raisons, vous souhaiterez utiliser une définition d’un rang qui prend les liens en compte. Dans l’exemple précédent, vous souhaitez utiliser un rang révisé de 5,5 pour le numéro 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 en compte les liens 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 est 0, car le rang n’a pas besoin d’être ajusté pour une égalité.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.