List.MaxN

Sintaxe

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

Sobre

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

• list: A 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 que eles sejam comparados. Se este parâmetro for null, então os valores são comparados sem qualquer transformação.
• includeNulls: (Opcional) Indica se null os valores na lista devem ser incluídos na determinação do item máximo. O valor predefinido é true.

Exemplo 1

Encontre os 5 principais valores na lista especificada.

Utilização

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.

Utilização

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 a partir de uma lista de datas alemãs.

Utilização

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údos relacionados

Critérios de comparação