FUNÇÃO SOMA: SUM

FUNÇÃO BUSCAR MAIOR VALOR DE UM CAMPO: MAX

FUNÇAO BUSCAR MENOR VALOR DE UM CAMPO:MIN

FUNÇÃO DE MÉDIA: AVERAGE

FUNÇÃO QUANTIDADE:COUNT

Função quantidade de clientes: distinctcount

Funções de lista
 Artigo
 25/02/2022
 8 minutos para o fim da leitura


Essas funções criam e manipulam valores de lista.

Informações

Informações
Função Descrição
List.Count Retorna o número de itens em uma lista.
List.NonNullCount Retorna o número de itens em uma lista excluindo valores nulos
List.IsEmpty Retorna uma mensagem informando se uma lista está vazia.

Seleção

Seleção
Função Descrição
Retorna uma lista com os itens alternados da lista original
List.Alternate baseado em uma contagem, repeatInterval opcional e um
deslocamento opcional.
Armazena em buffer a lista na memória. O resultado dessa
List.Buffer chamada é uma lista estável, o que significa que ela terá uma
ordem dos itens e uma contagem determinísticas.
Filtra uma lista removendo duplicatas. Um valor de critérios de
equação opcional pode ser especificado para controlar a
List.Distinct
comparação de igualdade. O primeiro valor de cada grupo de
igualdade é escolhido.
Pesquisa uma lista de valores, incluindo campos de registro, para
List.FindText
um valor de texto.
Retorna o primeiro valor da lista ou o padrão especificado se ela
está vazia. Retorna o primeiro item da lista ou o valor padrão
List.First
opcional se a lista está vazia. Se a lista estiver vazia e um valor
padrão não for especificado, a função retornará.
Retorna o primeiro conjunto de itens da lista especificando
List.FirstN quantos itens devem ser retornados ou uma condição de
qualificação fornecida por countOrCondition.
List.InsertRange Insere itens de valores no índice fornecido na lista de entrada.
List.IsDistinct Retorna uma mensagem informando se uma lista é distinta.
Retorna o último conjunto de itens da lista especificando quantos
List.Last itens devem ser retornados ou uma condição de qualificação
fornecida por countOrCondition.
List.LastN Retorna o último conjunto de itens de uma lista especificando
quantos itens devem ser retornados ou uma condição de
 Seleção
Função Descrição
qualificação.
Retorna verdadeiro se todos os itens de uma lista atendem a uma
List.MatchesAll
condição.
Retorna verdadeiro se qualquer item de uma lista atende a uma
List.MatchesAny
condição.
List.Positions Retorna uma lista de posições de uma lista de entrada.
List.Range Retorna uma contagem de itens começando em um deslocamento.
List.Select Seleciona os itens que correspondem a uma condição.
Retorna o único item da lista ou gera um Expression.Error se a
List.Single
lista tem mais de um item.
List.SingleOrDefault Retorna um único item de uma lista.
Ignora o primeiro item da lista. Considerando uma lista vazia, ele
retorna uma lista vazia. Essa função usa um parâmetro opcional
List.Skip
countOrCondition para dar suporte ao recurso de ignorar vários
valores.

Funções de transformação

Funções de transformação
Função Descrição
Acumula um resultado da lista. Começando na semente de
List.Accumulate valor inicial, essa função aplica a função de acumulador e
retorna o resultado final.
List.Combine Mescla uma lista de listas em uma só lista.
List.ConformToPageReader Esta função destina-se somente a uso interno.
Retorna uma lista que remove itens de contagem
List.RemoveRange
começando no deslocamento. A contagem padrão é 1.
Retorna uma lista com o número especificado de
elementos removidos da lista, começando no primeiro
List.RemoveFirstN
elemento. O número de elementos removidos depende do
parâmetro opcional countOrCondition.
Remove itens de list1 que estão presentes em list2 e
List.RemoveItems
retorna uma nova lista.
Retorna uma lista com o número especificado de
elementos removidos da lista, começando no último
List.RemoveLastN
elemento. O número de elementos removidos depende do
parâmetro opcional countOrCondition.
Retorna uma lista que repete o conteúdo do número de
List.Repeat
contagens de uma lista de entrada.
Retorna uma lista que substitui valores de contagem em
List.ReplaceRange uma lista por uma lista replaceWith começando em um
índice.
Remove todas as ocorrências dos valores especificados na
List.RemoveMatchingItems
lista.
List.RemoveNulls Remove os valores nulos de uma lista.
 Funções de transformação
Função Descrição
Substitui as ocorrências de valores existentes na lista por
novos valores usando o equationCriteria fornecido. Os
valores novos e antigos são fornecidos pelos parâmetros de
substituição. Um valor de critérios de equação opcional
List.ReplaceMatchingItems
pode ser especificado para controlar comparações de
igualdade. Para obter detalhes sobre operações de
substituição e critérios de equação, confira Valores de
parâmetros.
Pesquisa o valor em uma lista de valores e substitui cada
List.ReplaceValue
ocorrência pelo valor de substituição.
List.Reverse Retorna uma lista que reverte os itens em uma lista.
Divide a lista especificada em uma lista de listas usando o
List.Split
tamanho da página especificado.
Executa a função em cada item da lista e retorna a nova
List.Transform
lista.
Retorna uma lista cujos elementos são projetados com
List.TransformMany
base na lista de entrada.

Funções de associação

Como todos os valores podem ser testados quanto à igualdade, essas funções podem
operar em listas heterogêneas.

Funções de associação
Função Descrição
Retorna verdadeiro se todas as expressões de uma lista são
List.AllTrue
verdadeiras
List.AnyTrue Retorna verdadeiro se qualquer expressão de uma lista é verdadeira
List.Contains Retorna verdadeiro se um valor é encontrado em uma lista.
Retorna verdadeiro se todos os itens nos valores são encontrados
List.ContainsAll
em uma lista.
Retorna verdadeiro se qualquer item nos valores é encontrado em
List.ContainsAny
uma lista.
Encontra a primeira ocorrência de um valor em uma lista e retorna
List.PositionOf
a posição dela.
Encontra a primeira ocorrência de qualquer valor nos valores e
List.PositionOfAny
retorna a posição dela.

Set operations

Set operations
Função Descrição
Retorna os itens da lista 1 que não aparecem na lista 2. Há suporte para
List.Difference
valores duplicados.
Retorna uma lista de uma lista de listas e intersecciona itens comuns em
List.Intersect
listas individuais. Há suporte para valores duplicados.
 Set operations
Função Descrição
Retorna uma lista de uma lista de listas e une os itens nas listas
List.Union individuais. A lista retornada contém todos os itens em listas de entrada.
É feita a correspondência dos valores duplicados como parte da união.
List.Zip Retorna uma lista de listas combinando itens na mesma posição.

Ordenando

As funções de ordenação fazem comparações. Todos os valores comparados precisam

ser comparáveis entre si. Isso significa que todos eles precisam ser provenientes do
mesmo tipo de dados (ou incluir nulo, que sempre compara o menor). Caso contrário,
um Expression.Error é gerado.

Tipos de dados comparáveis

 Número
 Duração
 Datetime
 Texto
 Lógico
 Nulo

Ordenando
Função Descrição
Retorna o item máximo em uma lista ou o valor padrão
List.Max
opcional se a lista está vazia.
Retorna os valores máximos na lista. Depois que as linhas
List.MaxN são classificadas, parâmetros opcionais podem ser
especificados para filtrar ainda mais o resultado
List.Median Retorna o item mediano de uma lista.
Retorna o item mínimo em uma lista ou o valor padrão
List.Min
opcional se a lista está vazia.
List.MinN Retorna os valores mínimos em uma lista.
Retorna uma lista classificada usando o critério de
List.Sort
comparação.
Retorna um ou mais percentis de exemplo correspondentes
List.Percentile
às probabilidades fornecidas.
Ao interpolar valores de List.Percentile, use um método
PercentileMode.ExcelExc
compatível com o PERCENTILE.EXC do Excel.
Ao interpolar valores de List.Percentile, use um método
PercentileMode.ExcelInc
compatível com o PERCENTILE.INC do Excel.
Ao interpolar valores de List.Percentile, use um método
PercentileMode.SqlCont
compatível com o PERCENTILE_CONT do SQL Server.
Ao interpolar valores de List.Percentile, use um método
PercentileMode.SqlDisc
compatível com o PERCENTILE_DISC do SQL Server.

Averages
Essas funções operam em listas homogêneas de Numbers, DateTimes e Durations.

Averages
Função Descrição
Retorna um valor médio de uma lista no tipo de dados dos
List.Average
valores na lista.
List.Mode Retorna um item que aparece mais comumente em uma lista.
Retorna todos os itens que aparecem com a mesma frequência
List.Modes
máxima.
Retorna o desvio padrão de uma lista de valores.
List.StandardDeviation faz uma estimativa baseada em amostra.
List.StandardDeviation
O resultado é um número de números e uma duração de
DateTimes e Durations.

Adição

Essas funções operam em listas homogêneas de Numbers ou Durations.

Adição
Função Descrição
List.Sum Retorna a soma de uma lista.

Numerics

Essas funções só operam em números.

Numerics
Função Descrição
List.Covariance Retorna a covariância de duas listas como um número.
List.Product Retorna o produto de uma lista de números.

Geradores

Essas funções geram uma lista de valores.

Geradores
Função Descrição
Retorna uma lista de valores de data da contagem de tamanho,
List.Dates
começando no início, e adiciona um incremento a cada valor.
Retorna uma lista de valores de datetime da contagem de tamanho,
List.DateTimes
começando no início, e adiciona um incremento a cada valor.
Retorna uma lista de valores de datetimezone da contagem de
List.DateTimeZones tamanho, começando no início, e adiciona um incremento a cada
valor.
Retorna uma lista de valores de durações da contagem de
List.Durations tamanho, começando no início, e adiciona um incremento a cada
valor.
List.Generate Gera uma lista com base em uma função de valor, uma função de
 Geradores
Função Descrição
condição, uma função next e uma função de transformação
opcional nos valores.
Retorna uma lista de números da contagem de tamanho,
List.Numbers começando no início, e adiciona um incremento. O incremento usa
1 como padrão.
Retorna uma lista de números aleatórios de contagem, com um
List.Random
parâmetro de semente opcional.
Retorna uma lista de valores de tempo da contagem de tamanho,
List.Times
começando no início.

Valores de parâmetro
Especificação de ocorrência

 Occurrence.First = 0;
 Occurrence.Last = 1;
 Occurrence.All = 2;

Ordem de classificação

 Order.Ascending = 0;
 Order.Descending = 1;

Critérios de equação

Os critérios de equação para valores de lista podem ser especificados como

 Um valor de função que é

o Um seletor de chave que determina o valor na lista para aplicar os
critérios de igualdade ou
o Uma função de comparador que é usada para especificar o tipo de
comparação a ser aplicado. As funções de comparador internas podem
ser especificadas; confira a seção Funções de comparação.
 Um valor de lista que tenha
o Exatamente dois itens
o O primeiro elemento é o seletor de chave, conforme especificado acima
o O segundo elemento é um comparador, conforme especificado acima.

Para obter mais informações e exemplos, confira List.Distinct.

Critérios de comparação

O critério de comparação pode ser fornecido como um dos seguintes valores:

 Um valor numérico para especificar uma ordem de classificação. Para obter mais
informações, confira a ordem de classificação em Valores de parâmetros.
  Para calcular uma chave a ser usada para classificação, uma função de um
argumento pode ser usada.
 Para selecionar uma ordem de chave e de controle, o critério de comparação
pode ser uma lista que contém a chave e a ordem.
 Para controlar por completo a comparação, é possível usar uma função de dois
argumentos que retorna -1, 0 ou 1, considerando a relação entre as entradas
esquerda e direita. Value.Compare é um método que pode ser usado para delegar
essa lógica.

Para obter mais informações e exemplos, confira List.Sort.

Operações de substituição

As operações de substituição são especificadas por um valor de lista. Cada item dessa
lista precisa ser

 Um valor de lista com exatamente dois itens

 O primeiro item é o valor antigo na lista, a ser substituído
 O segundo item é o novo, que deve substituir todas as ocorrências do valor
antigo na lista