Partilhar via


List.Max

Sintaxe

List.Max(
    list as list,
    optional default as any,
    optional comparisonCriteria as any,
    optional includeNulls as nullable logical
) as any

Sobre

Retorna o item máximo na lista ou o valor padrão opcional se a lista estiver vazia.

  • list: A lista de valores.
  • default: (Opcional) O valor a ser retornado se a lista estiver vazia.
  • 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 o valor máximo na lista especificada.

Utilização

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

Saída

7

Exemplo 2

Encontre o valor máximo na lista especificada ou retorne -1 se estiver vazio.

Utilização

List.Max({}, -1)

Saída

-1

Exemplo 3

Encontre o item que está por último numa lista de valores de texto, alfabeticamente. Se a lista estiver vazia, retorne "nenhum".

Utilização

let
    Source = {"boy", "dog", "girl", "zebra", "cat", "mouse", "rabbit"},
    MaxText = List.Max(Source, "none")
in
    MaxText

Saída

"zebra"

Exemplo 4

Encontre a data mais recente a partir de uma lista de datas alemãs. Se a lista estiver vazia, retorne em 1º de janeiro de 2000.

Utilização

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

Saída

"15.05.2025"

Critérios de comparação