List.MaxN

Sintaxe

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

Sobre

Retorna o valor máximo na lista especificada. Depois que as linhas são classificadas, parâmetros opcionais podem ser especificados para filtrar ainda mais o resultado.

• list: Lista de valores.
• countOrCondition: especifica o número de valores a serem retornados ou uma condição de filtro. Se um número for especificado, uma lista de até countOrCondition itens em ordem decrescente será retornada. Se uma condição for especificada, a lista retornada incluirá todos os itens que atendem à condição.
• comparisonCriteria: (Opcional) Uma função que é usada para transformar os valores antes de serem comparados. Se esse parâmetro for null, os valores serão comparados sem nenhuma transformação.
• includeNulls: (Opcional) Indica se null os valores na lista devem ser incluídos na determinação do item máximo. O valor padrão é true.

Exemplo 1

Localize os cinco principais valores na lista especificada.

Usage

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

Saída

{8, 7, 5, 4, 3}

Exemplo 2

Encontre as palavras com mais de 3 caracteres.

Usage

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

Saída

{"rabbit", "pony"}

Exemplo 3

Encontre as três datas mais recentes de uma lista de datas alemãs.

Usage

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

Saída

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

Conteúdo relacionado

Critérios de comparação