Compartilhar 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: 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 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 o valor máximo na lista especificada.

Usage

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

Saída

7

Exemplo 2

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

Usage

List.Max({}, -1)

Saída

-1

Exemplo 3

Localize o item em uma lista de valores de texto que é a última em ordem alfabética. Se a lista estiver vazia, retorne "nenhum".

Usage

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 de uma lista de datas alemãs. Se a lista estiver vazia, retorne 1º de janeiro de 2000.

Usage

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