List.MaxN

Sintaks

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

Tentang

Mengembalikan nilai maksimum dalam daftar yang ditentukan. Setelah baris diurutkan, parameter opsional dapat ditentukan untuk memfilter hasil lebih lanjut.

  • list: Daftar nilai.
  • countOrCondition: Menentukan jumlah nilai yang akan dikembalikan atau kondisi filter. Jika angka ditentukan, daftar hingga countOrCondition item dalam urutan turun akan dikembalikan. Jika kondisi ditentukan, daftar yang dikembalikan menyertakan semua item yang memenuhi kondisi.
  • comparisonCriteria: (Opsional) Fungsi yang digunakan untuk mengubah nilai sebelum dibandingkan. Jika parameter ini adalah null, maka nilai dibandingkan tanpa transformasi apa pun.
  • includeNulls: (Opsional) Menunjukkan apakah null nilai dalam daftar harus disertakan dalam menentukan item maksimum. Nilai defaultnya adalah true.

Contoh 1

Temukan 5 nilai teratas dalam daftar yang ditentukan.

Penggunaan

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

Hasil

{8, 7, 5, 4, 3}

Contoh 2

Temukan kata-kata dengan lebih dari 3 karakter.

Penggunaan

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

Hasil

{"rabbit", "pony"}

Contoh 3

Temukan tiga tanggal terbaru dari daftar tanggal Jerman.

Penggunaan

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

Hasil

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

Kriteria perbandingan