List.MaxN

Syntax

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

Info

Gibt den Maximalwert(n) in der angegebenen Liste zurück. Nachdem die Zeilen sortiert wurden, können optionale Parameter angegeben werden, um das Ergebnis weiter zu filtern.

• list: Die Werteliste.
• countOrCondition: Gibt die Anzahl der zurückzugebenden Werte oder eine Filterbedingung an. Wenn eine Zahl angegeben wird, wird eine Liste mit bis zu countOrCondition Elementen in absteigender Reihenfolge zurückgegeben. Wenn eine Bedingung angegeben ist, enthält die zurückgegebene Liste alle Elemente, die die Bedingung erfüllen.
• comparisonCriteria: (Optional) Eine Funktion, die zum Transformieren der Werte verwendet wird, bevor sie verglichen werden. Wenn dieser Parameter lautet null, werden die Werte ohne Transformation verglichen.
• includeNulls: (Optional) Gibt an, ob null Werte in die Liste einbezogen werden sollen, um das maximale Element zu bestimmen. Der Standardwert ist true.

Beispiel 1

Suchen Sie die 5 obersten Werte in der angegebenen Liste.

Verwendung

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

Ausgabe

{8, 7, 5, 4, 3}

Beispiel 2

Suchen Sie die Wörter mit mehr als 3 Zeichen.

Verwendung

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

Ausgabe

{"rabbit", "pony"}

Beispiel 3

Suchen Sie die drei aktuellsten Datumsangaben aus einer Liste der deutschen Datumsangaben.

Verwendung

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

Ausgabe

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

Zugehöriger Inhalt

Vergleichskriterien