Partager via


List.MaxN

Syntaxe

List.MaxN(
    list as list,
    countOrCondition as any,
    optional comparisonCriteria as any,
    optional includeNulls as nullable logical
) as list

À propos

Retourne la ou les valeurs maximales dans la liste spécifiée. Une fois les lignes triées, les paramètres facultatifs peuvent être spécifiés pour filtrer davantage le résultat.

  • list : Liste de valeurs.
  • countOrCondition: spécifie le nombre de valeurs à retourner ou une condition de filtre. Si un nombre est spécifié, une liste d’éléments maximum countOrCondition dans l’ordre décroissant est retournée. Si une condition est spécifiée, la liste retournée inclut tous les éléments qui répondent à la condition.
  • comparisonCriteria: (Facultatif) Fonction utilisée pour transformer les valeurs avant qu’elles ne soient comparées. Si ce paramètre est null, les valeurs sont comparées sans transformation.
  • includeNulls: (Facultatif) Indique si null les valeurs de la liste doivent être incluses dans la détermination de l’élément maximal. La valeur par défaut est true.

Exemple 1

Recherchez les 5 premières valeurs dans la liste spécifiée.

Utilisation

List.MaxN({3, 4, 5, -1, 7, 8, 2}, 5)

Output

{8, 7, 5, 4, 3}

Exemple 2

Recherchez les mots avec plus de 3 caractères.

Utilisation

List.MaxN(
        {"boy", "dog", "pony", "cat", "rabbit", "bat"},
        each Text.Length(_) > 3
    )

Output

{"rabbit", "pony"}

Exemple 3

Recherchez les trois dates les plus récentes d’une liste de dates allemandes.

Utilisation

let
    Source = {"12.02.2024", "15.05.2025", "10.10.2021", "16.01.2025", "30.12.2022"},
    MaxDate = List.MaxN(Source, 3, each Date.FromText(_, [Culture = "de-DE"]))
in
    MaxDate

Output

{
    "15.05.2025",
    "16.01.2025",
    "12.02.2024"
}

Critères de comparaison