0% acharam este documento útil (0 voto)
117 visualizações842 páginas

Funções do Power Query M: Referência Completa

Este documento fornece uma referência de funções do Power Query M, incluindo mais de 700 funções organizadas por categoria. A primeira seção descreve como entender as funções no Power Query M, como parâmetros, tipos e como definir e invocar funções. A segunda seção lista e descreve as funções de acesso a dados, que acessam e retornam valores de tabela para navegação em conjuntos de dados.

Enviado por

ALVARO
Direitos autorais
© All Rights Reserved
Levamos muito a sério os direitos de conteúdo. Se você suspeita que este conteúdo é seu, reivindique-o aqui.
Formatos disponíveis
Baixe no formato PDF, TXT ou leia on-line no Scribd
0% acharam este documento útil (0 voto)
117 visualizações842 páginas

Funções do Power Query M: Referência Completa

Este documento fornece uma referência de funções do Power Query M, incluindo mais de 700 funções organizadas por categoria. A primeira seção descreve como entender as funções no Power Query M, como parâmetros, tipos e como definir e invocar funções. A segunda seção lista e descreve as funções de acesso a dados, que acessam e retornam valores de tabela para navegação em conjuntos de dados.

Enviado por

ALVARO
Direitos autorais
© All Rights Reserved
Levamos muito a sério os direitos de conteúdo. Se você suspeita que este conteúdo é seu, reivindique-o aqui.
Formatos disponíveis
Baixe no formato PDF, TXT ou leia on-line no Scribd

Referência de função do Power Query M

09/05/2020 • 2 minutes to read

A referência de função do Power Query M inclui artigos para cada uma das mais de 700 funções. Os artigos de
referência que você vê aqui em [Link] são gerados automaticamente na ajuda no produto. Para saber
mais sobre as funções e como elas funcionam em uma expressão, confira Entender as funções do Power Query M.

Funções por categoria


Como acessar funções de dados
Funções binárias
Funções de combinação
Funções de comparação
Funções de data
Funções de DateTime
Funções de DateTimeZone
Funções de duração
Tratamento de erro
Funções de expressão
Valores de função
Funções de lista
Funções de linhas
Funções lógicas
Funções numéricas
Funções de registro
Funções de substituto
Funções de divisor
Funções de tabela
Funções de texto
Funções de hora
Funções de tipo
Funções de URI
Funções de valor
Como entender as funções do Power Query M
12/05/2020 • 3 minutes to read

Na linguagem de fórmula Power Query M, uma função é um mapeamento de um conjunto de valores de entrada
para um único valor de saída. Uma função é gravada primeiro nomeando os parâmetros de função e, em seguida,
fornecendo uma expressão para calcular o resultado da função. O corpo da função segue o símbolo de ir para
(=>). Opcionalmente, as informações de tipo podem ser incluídas em parâmetros e o valor retornado da função.
Uma função é definida e invocada no corpo de uma instrução let . Os parâmetros e/ou o valor retornado podem
ser implícitos ou explícitos. Os parâmetros e/ou o valor retornado implícitos são do tipo qualquer . O tipo
qualquer é semelhante a um tipo de objeto em outras linguagens. Todos os tipos em M derivam do tipo
qualquer .
Uma função é um valor como um número ou um valor de texto e pode ser incluída em linha, assim como
qualquer outra expressão. O exemplo a seguir mostra uma função que é o valor de uma variável Add, que é
invocada ou executada de várias outras variáveis. Quando uma função é chamada, um conjunto de valores é
especificado, que são substituídos logicamente pelo conjunto necessário de valores de entrada dentro da
expressão do corpo da função.
Exemplo – parâmetros explícitos e valor retornado

let
AddOne = (x as number) as number => x + 1,
//additional expression steps
CalcAddOne = AddOne(5)
in
CalcAddOne

Exemplo – parâmetros implícitos e valor retornado

let
Add = (x, y) => x + y,
AddResults =
[
OnePlusOne = Add(1, 1), // equals 2
OnePlusTwo = Add(1, 2) // equals 3
]
in
AddResults

Localizar o primeiro elemento de uma lista maior que 5 ou nulo, caso contrário
let
FirstGreaterThan5 = (list) =>
let
GreaterThan5 = [Link](list, (n) => n> 5),
First = [Link](GreaterThan5)
in
First,
Results =
[
Found = FirstGreaterThan5({3,7,9}), // equals 7
NotFound = FirstGreaterThan5({1,3,4}) // equals null
]
in
Results

As funções podem ser usadas recursivamente. Para referenciar recursivamente a função, prefixe o identificador
com @.

let
fact = (num) => if num = 0 then 1 else num * @fact (num-1)
in
fact(5) // equals 120

Palavra-chave each
A palavra-chave each é usada para criar facilmente funções simples. "each…" é uma simplificação sintática para
uma assinatura de função que usa o _ parâmetro "(_) => ..."
Each é útil quando combinada ao operador lookup, que é aplicado por padrão a _
Por exemplo, each [CustomerID] é o mesmo que each _[CustomerID], que é o mesmo que (_) => _[CustomerID]
Exemplo – usando each um no filtro de linha de tabela

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"] ,
[CustomerID = 3, Name = "Paul", Phone = "543-7890"] ,
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
each [CustomerID] = 2
)[Name]

// equals "Jim"
Como acessar funções de dados
08/05/2020 • 17 minutes to read

Como acessar dados


Estas funções acessam dados e retornam valores de tabela. A maioria dessas funções retorna um valor de tabela
chamado tabela de navegação . As tabelas de navegação são usadas principalmente pela interface do usuário do
Power Query para proporcionar uma experiência de navegação sobre os conjuntos de dados hierárquicos
potencialmente grandes retornados.

F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna uma lista de identidades que a condição aceitará.

[Link] O acesso é permitido.

[Link] O acesso é negado.

[Link] Retorna uma representação estrutural de um banco de dados


do Microsoft Access.

[Link] Retorna uma lista de domínios do Active Directory na mesma


floresta do domínio especificado ou do domínio do
computador atual, caso nenhuma tenha sido especificada.

[Link] Retorna os conjuntos de relatórios ao Adobe Analytics.

[Link] Retorna a coleção de esquema para uma fonte de dados do


[Link].

[Link] Retorna a coleção de esquema para uma fonte de dados do


[Link].

[Link] Retorna uma tabela de cubos multidimensionais ou modelos


de tabela do banco de dados do Analysis Services.

[Link] Retorna os bancos de dados do Analysis Services em um host


especificado.

[Link] Retorna o conteúdo do blob especificado de um cofre de


armazenamento do Azure.

[Link] Retorna uma tabela de navegação contendo todos os


contêineres encontrados na conta de Armazenamento do
Azure. Cada linha tem o nome do contêiner e um link para os
blobs de contêiner.

[Link] Retorna uma tabela navegacional contendo os documentos


localizados no contêiner especificado e nas suas subpastas do
Azure Data Lake Storage.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna o conteúdo do arquivo especificado de um sistema de


arquivos do Azure Data Lake Storage.

[Link] Retorna uma tabela de navegação que contém uma linha para
cada tabela encontrado na URL da conta de um cofre de
armazenamento do Azure. Cada linha contém um link para a
tabela do Azure.

[Link] Esta função não está disponível porque requer o .NET 4.5.

[Link] Retorna o conteúdo de um documento CSV como uma tabela


usando a codificação especificada.

[Link] As aspas em um campo são significativas apenas


imediatamente depois do delimitador.

[Link] As aspas em um campo são sempre significativas,


independentemente do local em que aparecerem.

[Link] Mescla a tabela de dimensão especificada, dimensionSelector,


no contexto de filtro do cubo e altera a granularidade
dimensional expandindo o conjunto especificado,
attributeNames, de atributos de dimensão.

[Link] Adiciona uma coluna com o nome de coluna ao cubo que


contém os resultados da medida measureSelector aplicada ao
contexto de cada linha.

[Link] Retorna um cubo depois de aplicar o parâmetro com


argumentos ao cubo.

[Link] Retorna o identificador de membro exclusivo de um valor da


propriedade do membro.

[Link] Retorna a propriedade propertyName do atributo de


dimensão attribute .

[Link] Altera a granularidade dimensional do contexto de filtro do


cubo, recolhendo os atributos mapeados para as colunas
especificadas, columnNames.

[Link] Retorna a tabela que contém o conjunto de dimensões


disponíveis dentro do cubo.

[Link] Retorna uma árvore de tabelas aninhada que representa a


hierarquia da pasta de exibição dos objetos (por exemplo,
dimensões e medidas) disponíveis para uso no cubo.

[Link] Retorna uma tabela contendo o conjunto de propriedades


disponíveis para medidas que são expandidas no cubo.

[Link] Retorna a propriedade de uma medida.


F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna a tabela que contém o conjunto de medidas


disponíveis no cubo.

[Link] Retorna uma tabela contendo o conjunto de parâmetros que


pode ser aplicado ao cubo.

[Link] Retorna uma tabela contendo o conjunto de propriedades


disponíveis para dimensões expandidas no cubo.

[Link] Retorna a chave da propriedade property .

[Link]

[Link] Aplica as funções de cubo da lista, transformações, no cubo.

[Link] Retorna uma tabela de tabelas e exibições SQL disponíveis em


um banco de dados Db2.

[Link] Retorna os cubos em uma instância do Essbase agrupados por


servidor Essbase.

[Link] Retorna as tabelas na pasta de trabalho do Excel atual.

[Link] Retorna uma tabela representando planilhas na pasta de


trabalho específica do Excel.

[Link] Retorna um sumário de uma conta do Microsoft Exchange.

[Link] Retorna um registro com o conteúdo do grafo do Facebook.

[Link] Retorna o conteúdo binário do arquivo localizado em um


caminho.

[Link] Retorna uma tabela que contém as propriedades e o conteúdo


dos arquivos e das pastas encontrados no caminho.

[Link] Retorna uma tabela que contém uma linha para cada arquivo
encontrado em um caminho de pasta e subpastas. Cada linha
contém as propriedades da pasta ou do arquivo e um link
para seu conteúdo.

[Link] Retorna as contas do Google Analytics para a credencial atual.

[Link] Retorna uma tabela que contém uma linha para cada pasta e
arquivo encontrado na URL da pasta, {0}, de um sistema de
arquivos do Hadoop. Cada linha contém as propriedades da
pasta ou do arquivo e um link para seu conteúdo.

[Link] Retorna uma tabela que contém uma linha para cada arquivo
encontrado na URL da pasta, {0}, e subpastas de um sistema
de arquivos do Hadoop. Cada linha contém propriedades do
arquivo e um link para o conteúdo.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna uma tabela de navegação contendo todos os


contêineres encontrados na conta do HDInsight. Cada linha
tem o nome do contêiner e a tabela contendo seus arquivos.

[Link] Retorna uma tabela de navegação contendo todos os


contêineres encontrados na conta do HDInsight. Cada linha
tem o nome do contêiner e a tabela contendo seus arquivos.

[Link] Retorna uma tabela que contém uma linha para cada pasta e
arquivo encontrado na URL do contêiner e as subpastas de
uma conta do HDInsight. Cada linha contém propriedades do
arquivo/pasta e um link para o conteúdo.

[Link] Retorna uma tabela que contém os resultados da execução


dos seletores de CSS especificados em relação ao html
fornecido

[Link] Cria uma identidade.

[Link] Determina se uma identidade é um membro de uma coleção


de identidades.

[Link] O provedor de identidade padrão do host atual.

[Link] Retorna uma tabela de tabelas e exibições SQL disponíveis em


um banco de dados do Informix no servidor server na
instância de banco de dados chamada database .

[Link] Retorna o conteúdo de um documento JSON. O conteúdo


pode ser passado diretamente para a função como texto ou
pode ser o valor binário retornado por uma função como
[Link].

[Link] Produz uma representação JSON de um valor especificado


com uma codificação de texto especificada por codificação.

[Link] Retorna uma tabela contendo dados relacionados às tabelas


no banco de dados MySQL especificado.

[Link] Retorna uma tabela de feeds OData oferecidos por um OData


serviceUri.

[Link] Permite que o serviço OData omita valores nulos.

[Link] Retorna uma tabela de exibições e tabelas SQL da fonte de


dados ODBC especificada pela cadeia de conexão
connectionString .

[Link] Retorna o resultado de uma tentativa de inferir as


funcionalidades do SQL de um driver ODBC.

[Link] Conecta-se a um provedor genérico com a cadeia de conexão


fornecida e retorna o resultado da avaliação da consulta.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna uma tabela de exibições e tabelas SQL da fonte de


dados OLE DB especificada pela cadeia de conexão.

[Link] Retorna o resultado da execução de uma consulta nativa em


uma fonte de dados do OLE DB.

[Link] Retorna uma tabela contendo dados relacionados às tabelas


no Oracle Database especificado.

[Link] Retorna o conteúdo do documento Parquet como uma tabela.

[Link] Retorna todas as tabelas encontradas em pdf.

[Link] Retorna uma tabela contendo dados relacionados às tabelas


no banco de dados PostgreSQL especificado.

[Link] Retorna um registro de quadros de dados do arquivo RData.

[Link] Conecta-se à API de Objetos do Salesforce e retorna o


conjunto de objetos disponíveis (ou seja, Contas).

[Link] Conecta-se à API de Relatórios do Salesforce e retorna o


conjunto de relatórios disponíveis.

[Link] Retorna InfoCubes e consultas em um sistema SAP Business


Warehouse agrupado por InfoArea.

[Link] Opção 'Modo de mesclagem de DataStream' para execução de


MDX no SAP Business Warehouse.

[Link] Opção 'Modo de mesclagem de bXML' para execução de MDX


no SAP Business Warehouse.

[Link] Opção 'Modo de mesclagem de bXML compactado em Gzip'


para execução de MDX no SAP Business Warehouse.
Recomendado para consultas de alto volume ou baixa latência.

[Link] Retorna os pacotes em um banco de dados SAP HANA.

[Link] Retorna os pacotes em um banco de dados SAP HANA.

[Link] Opção de distribuição 'Connection' para SAP HANA.

[Link] Opção de distribuição 'Off' para SAP HANA.

[Link] Opção de distribuição 'Statement' para SAP HANA.

[Link] Operador de intervalo 'equals' para parâmetros de entrada do


SAP HANA.

[Link] Operador de intervalo 'greater than' para parâmetros de


entrada do SAP HANA.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Operador de intervalo 'greater than or equals' para


parâmetros de entrada do SAP HANA.

[Link] Operador de intervalo 'less than' para parâmetros de entrada


do SAP HANA.

[Link] Operador de intervalo 'less than or equals' para parâmetros


de entrada do SAP HANA.

[Link] Operador de intervalo 'not equals' para parâmetros de


entrada do SAP HANA.

[Link] Retorna uma tabela que contém uma linha para cada pasta e
documento encontrados na URL site do SharePoint
especificada. Cada linha contém as propriedades da pasta ou
do arquivo e um link para seu conteúdo.

[Link] Retorna uma tabela que contém uma linha para cada
documento encontrado na URL do SharePoint e subpastas.
Cada linha contém as propriedades da pasta ou do arquivo e
um link para seu conteúdo.

[Link] Retorna uma tabela que contém o resultado de uma lista do


SharePoint como um feed OData.

[Link] Retorna a tabela resultante de um arquivo CSV que pode ser


acessado usando a API SODA 2.0. A URL deve apontar para
uma fonte em conformidade com SODA válida que termina
em uma extensão .csv.

[Link] Retorna uma tabela que contém tabelas SQL localizadas em


um banco de dados de instância do SQL Server.

[Link] Retorna uma tabela com referências a bancos de dados


localizados em uma instância do SQL Server. Retorna uma
tabela de navegação.

[Link] Retorna uma tabela contendo dados relacionados às tabelas


no Sybase Database especificado.

[Link] Retorna uma tabela contendo dados relacionados às tabelas


no Teradata Database especificado.

[Link] Cria uma ação que, quando executada, retornará os resultados


de realizar uma solicitação de método com relação à URL
usando HTTP como um valor binário.

[Link] Retorna o HTML da URL especificada, conforme exibido por


um navegador da Web.

[Link] Retorna o conteúdo baixado de uma URL da Web como um


valor binário.

[Link] Retorna o conteúdo de uma página da Web HTML como uma


tabela.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Especifica o método DELETE para HTTP.

[Link] Especifica o método GET para HTTP.

[Link] Especifica o método HEAD para HTTP.

[Link] Especifica o método PATCH para HTTP.

[Link] Especifica o método POST para HTTP.

[Link] Especifica o método PUT para HTTP.

[Link] Retorna o conteúdo de um documento XML como uma tabela


hierárquica (lista de registros).

[Link] Retorna o conteúdo de um documento XML como uma


coleção aninhada de tabelas niveladas.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](identityProvider as function, condition as function) as
list

Sobre
Usando o identityProvider especificado, converte o condition na lista de identidades para a qual condition
retornaria true em todos os contextos de autorização com identityProvider como o provedor de identidade. Um
erro será gerado se não for possível converter condition em uma lista de identidades; por exemplo, se condition
consultar atributos diferentes de identidades de usuário ou de grupo para tomar uma decisão.
Observe que a lista de identidades representa as identidades conforme elas aparecem na condition e nenhuma
normalização (como a expansão do grupo) é executada nelas.
[Link]
09/05/2020 • 2 minutes to read

Sobre
O acesso é permitido.
[Link]
09/05/2020 • 2 minutes to read

Sobre
O acesso é negado.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](database as binary, optional options as nullable record) as table

Sobre
Retorna uma representação estrutural de um banco de dados do Access, database . Um parâmetro de registro
opcional, options , pode ser especificado para controlar as seguintes opções:
CreateNavigationProperties : Uma lógica (true/false) que define se as propriedades de navegação nos valores
retornados serão geradas (o padrão é false).
NavigationPropertyNameGenerator : uma função usada para a criação de nomes de propriedades de navegação.

O parâmetro de registro é especificado como [option1 = value1, option2 = value2...], por exemplo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](optional forestRootDomainName as nullable text) as table

Sobre
Retorna uma lista de domínios do Active Directory na mesma floresta do domínio especificado ou do domínio do
computador atual, caso nenhuma tenha sido especificada.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](optional options as nullable record) as table

Sobre
Retorna uma tabela de pacotes multidimensionais do Adobe Analytics. Um parâmetro de registro opcional,
options , pode ser especificado para controlar as seguintes opções:

HierarchicalNavigation : uma lógica (true/false) que define se as tabelas agrupadas por seus nomes de
esquema serão exibidas (o padrão é false).
MaxRetryCount : O número de tentativas a serem executadas ao sondar o resultado da consulta. O valor padrão é
120.
RetryInterval : A duração do tempo entre as tentativas de repetição. O valor padrão é de 1 segundo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](providerName as text, connectionString as any, optional options as nullable
record) as table

Sobre
Retorna a coleção de esquemas para a fonte de dados [Link] com o nome do provedor providerName e a cadeia
de conexão connectionString . connectionString pode ser um texto ou um registro de pares de valor da
propriedade. Os valores de propriedade podem ser texto ou número. Um parâmetro de registro opcional, options ,
pode ser fornecido para especificar propriedades adicionais. O registro pode conter os seguintes campos:
CommandTimeout : uma duração que controla quanto tempo a consulta do servidor tem permissão para ser
executada até ser cancelada. O valor padrão é dez minutos.
SqlCompatibleWindowsAuth : um valor lógico (true/false) que determina se as opções de cadeia de conexão
compatíveis com o SQL Server devem ser produzidas para a autenticação do Windows. O valor padrão é true.
TypeMap
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](providerName as text, connectionString as any, query as text, optional options as
nullable record) as table

Sobre
Retorna o resultado da execução de query com a cadeia de conexão connectionString usando o provedor
[Link] providerName . connectionString pode ser um texto ou um registro de pares de valor da propriedade. Os
valores de propriedade podem ser texto ou número. Um parâmetro de registro opcional, options , pode ser
fornecido para especificar propriedades adicionais. O registro pode conter os seguintes campos:
CommandTimeout : uma duração que controla quanto tempo a consulta do servidor tem permissão para ser
executada até ser cancelada. O valor padrão é dez minutos.
SqlCompatibleWindowsAuth : um valor lógico (true/false) que determina se as opções de cadeia de conexão
compatíveis com o SQL Server devem ser produzidas para a autenticação do Windows. O valor padrão é true.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](server as text, database as text, optional options as nullable record)
as table

Sobre
Retorna uma tabela de cubos multidimensionais ou modelos de tabela do banco de dados do Analysis Services
database no servidor server . Um parâmetro de registro opcional, options , pode ser especificado para controlar
as seguintes opções:
Query : Uma consulta MDX nativa usada para recuperar dados.
TypedMeasureColumns : Um valor lógico indicando se os tipos especificados no modelo multidimensional ou de
tabela serão usados para os tipos das colunas de medida adicionadas. Quando definido como false, o tipo
"número" será usado para todas as colunas de medida. O valor padrão dessa opção é false.
Culture : Um nome de cultura especificando a cultura dos dados. Isso corresponde à propriedade da cadeia de
conexão 'Identificador de Localidade'.
CommandTimeout : uma duração que controla quanto tempo a consulta do servidor tem permissão para ser
executada até ser cancelada. O valor padrão é dependente do driver.
ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de
fazer conexão com o servidor. O valor padrão é dependente do driver.
SubQueries : Um número (0, 1 ou 2) que define o valor da propriedade "SubQueries" na cadeia de conexão. Isso
controla o comportamento de membros calculados em subseleções ou subcubos. (O valor padrão é 2.)
Implementation
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](server as text, optional options as nullable record) as table

Sobre
Retornará bancos de dados em uma instância do Analysis Services, server . Um parâmetro de registro opcional,
options , pode ser fornecido para especificar propriedades adicionais. O registro pode conter os seguintes campos:

TypedMeasureColumns : Um valor lógico indicando se os tipos especificados no modelo multidimensional ou de


tabela serão usados para os tipos das colunas de medida adicionadas. Quando definido como false, o tipo
"número" será usado para todas as colunas de medida. O valor padrão dessa opção é false.
Culture : Um nome de cultura especificando a cultura dos dados. Isso corresponde à propriedade da cadeia de
conexão 'Identificador de Localidade'.
CommandTimeout : uma duração que controla quanto tempo a consulta do servidor tem permissão para ser
executada até ser cancelada. O valor padrão é dependente do driver.
ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de
fazer conexão com o servidor. O valor padrão é dependente do driver.
SubQueries : Um número (0, 1 ou 2) que define o valor da propriedade "SubQueries" na cadeia de conexão. Isso
controla o comportamento de membros calculados em subseleções ou subcubos. (O valor padrão é 2.)
Implementation
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](url as text, optional options as nullable record) as binary

Sobre
Retorna o conteúdo do blob na URL, url , de um cofre de armazenamento do Azure. options pode ser
especificado para controlar as seguintes opções:
BlockSize : O número de bytes a serem lidos antes de aguardar o consumidor de dados. O valor padrão é de 4
MB.
RequestSize : O número de bytes cuja leitura será tentada em uma única solicitação HTTP para o servidor. O
valor padrão é de 4 MB.
ConcurrentRequests : A opção ConcurrentRequests dá suporte ao download mais rápido de dados, especificando
o número de solicitações a serem feitas em paralelo, ao custo da utilização da memória. A memória necessária é
(ConcurrentRequest * RequestSize). O valor padrão é 16.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](account as text, optional options as nullable record) as table

Sobre
Retorna uma tabela de navegação que contém uma linha para cada contêiner encontrado na URL da conta,
account , de um cofre de armazenamento do Azure. Cada linha contém um link para os blobs de contêiner.
options pode ser especificado para controlar as seguintes opções:

BlockSize : O número de bytes a serem lidos antes de aguardar o consumidor de dados. O valor padrão é de 4
MB.
RequestSize : O número de bytes cuja leitura será tentada em uma única solicitação HTTP para o servidor. O
valor padrão é de 4 MB.
ConcurrentRequests : A opção ConcurrentRequests dá suporte ao download mais rápido de dados, especificando
o número de solicitações a serem feitas em paralelo, ao custo da utilização da memória. A memória necessária é
(ConcurrentRequest * RequestSize). O valor padrão é 16.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](endpoint as text, optional options as nullable record) as table

Sobre
Retorna uma tabela navegacional contendo os documentos localizados no contêiner especificado e nas suas
subpastas na URL da conta, endpoint , de um sistema de arquivos do Azure Data Lake Storage. options pode ser
especificado para controlar as seguintes opções:
BlockSize : O número de bytes a serem lidos antes de aguardar o consumidor de dados. O valor padrão é de 4
MB.
RequestSize : O número de bytes cuja leitura será tentada em uma única solicitação HTTP para o servidor. O
valor padrão é de 4 MB.
ConcurrentRequests : A opção ConcurrentRequests dá suporte ao download mais rápido de dados, especificando
o número de solicitações a serem feitas em paralelo, ao custo da utilização da memória. A memória necessária é
(ConcurrentRequest * RequestSize). O valor padrão é 16.
HierarchicalNavigation : Uma lógica (true/false) que controla se os arquivos são retornados em um modo de
exibição de diretório semelhante ao de árvore ou em uma lista plana. O valor padrão é false.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](url as text, optional options as nullable record) as binary

Sobre
Retorna o conteúdo do arquivo na URL, url , de um sistema de arquivos do Azure Data Lake Storage. options
pode ser especificado para controlar as seguintes opções:
BlockSize : O número de bytes a serem lidos antes de aguardar o consumidor de dados. O valor padrão é de 4
MB.
RequestSize : O número de bytes cuja leitura será tentada em uma única solicitação HTTP para o servidor. O
valor padrão é de 4 MB.
ConcurrentRequests : A opção ConcurrentRequests dá suporte ao download mais rápido de dados, especificando
o número de solicitações a serem feitas em paralelo, ao custo da utilização da memória. A memória necessária é
(ConcurrentRequest * RequestSize). O valor padrão é 16.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](account as text) as table

Sobre
Retorna uma tabela de navegação que contém uma linha para cada tabela encontrado na URL da conta, account ,
de um cofre de armazenamento do Azure. Cada linha contém um link para a tabela do Azure.
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table) as table

Sobre
Esta função não está disponível porque requer o .NET 4.5.
[Link]
08/05/2020 • 3 minutes to read

Sintaxe
[Link](source as any, optional columns as any, optional delimiter as any, optional
extraValues as nullable number, optional encoding as nullable number) as table

Sobre
Retorna o conteúdo do documento CSV como uma tabela.
columns pode ser nulo, o número de colunas, uma lista de nomes de colunas, um tipo de tabela ou um registro
de opções. (Confira abaixo mais detalhes sobre o registro de opções.)
delimiter pode ser um único caractere ou uma lista de caracteres. Padrão: "," .
Veja [Link] para obter os valores de extraValues com suporte.
encoding especifica o tipo de codificação de texto.

Se um registro for especificado para columns (e delimiter , extraValues e encoding forem nulos), os seguintes
campos de registro poderão ser fornecidos:
Delimiter : o delimitador de coluna. Padrão: "," .
Columns : pode ser nulo, o número de colunas, uma lista de nomes de colunas ou um tipo de tabela. Se o
número de colunas for menor do que o número encontrado na entrada, as colunas adicionais serão ignoradas.
Se o número de colunas for maior do que o número encontrado na entrada, as colunas adicionais serão nulas.
Quando não for especificado, o número de colunas será determinado pelo que é encontrado na entrada.
Encoding : a codificação de texto do arquivo. Padrão: 65001 (UTF-8).
CsvStyle : especifica como as aspas são manipuladas. [Link] (padrão): As aspas em um
campo são significativas apenas imediatamente depois do delimitador. [Link] : as aspas em um
campo são sempre significativas, independentemente do local em que aparecerem.
QuoteStyle : especifica como as quebras de linha entre aspas são manipuladas. [Link] (padrão):
Todas as quebras de linha são tratadas como o final da linha atual, mesmo quando elas ocorrem dentro de um
valor entre aspas. [Link] : as quebras de linha entre aspas são tratadas como parte dos dados, e não
como o fim da linha atual.

Exemplo 1
Processa texto CSV com cabeçalhos de coluna.

let
csv = [Link]({"OrderID,Item", "1,Fishing rod", "2,1 lb. worms"}, "#(cr)#(lf)")
in
[Link]([Link](csv))

O RDERID IT EM

1 Vara de pescar
O RDERID IT EM

2 1 lb de minhocas
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link]

Sobre
As aspas em um campo são significativas apenas imediatamente depois do delimitador.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link]

Sobre
As aspas em um campo são sempre significativas, independentemente do local em que aparecerem.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](**cube** as table, **dimensionSelector** as any,
**attributeNames** as list, optional **newColumnNames** as any) as table

Sobre
Mescla a tabela de dimensão especificada, dimensionSelector , no contexto de filtro do cubo, cube , e altera a
granularidade dimensional expandindo o conjunto especificado, attributeNames , de atributos de dimensão. Os
atributos de dimensão são adicionados à exibição tabular com colunas nomeadas newColumnNames , ou
attributeNames , se não for especificado.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](**cube** as table, **column** as text, **measureSelector** as any) as table

Sobre
Adiciona uma coluna com o nome column ao cube que contém os resultados da medida measureSelector
aplicada ao contexto de cada linha. O aplicativo de medida é afetado por alterações na granularidade e na divisão
da dimensão. Os valores da medida serão ajustados depois que determinadas operações de cubo forem
executadas.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](cube as table, parameter as any, optional arguments as nullable list) as table

Sobre
Retorna um cubo após a aplicação de parameter com arguments a cube .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](attribute as any) as any

Sobre
Retorna o identificador de membro exclusivo de um valor da propriedade do membro. attribute . Retorna nulo
para qualquer outro valor.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](attribute as any, propertyName as text) as any

Sobre
Retorna a propriedade propertyName do atributo de dimensão attribute .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](**cube** as table, **columnNames** as list) as table

Sobre
Altera a granularidade dimensional do contexto de filtro do cube , recolhendo os atributos mapeados para as
colunas especificadas columnNames . As colunas também são removidas da exibição de tabela do cubo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](**cube** as table) as table

Sobre
Retorna a tabela que contém o conjunto de dimensões disponíveis dentro do cube . Cada dimensão é uma tabela
que contém um conjunto de atributos de dimensão e cada atributo de dimensão é representado como uma coluna
na tabela de dimensões. As dimensões podem ser expandidas no cubo usando
[Link].
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](**cube** as table) as table

Sobre
Retorna uma árvore de tabelas aninhada que representa a hierarquia da pasta de exibição dos objetos (por
exemplo, dimensões e medidas) disponíveis para uso no cube .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](cube as table) as table

Sobre
Retorna uma tabela contendo o conjunto de propriedades disponíveis para medidas que são expandidas no cubo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](measure as any, propertyName as text) as any

Sobre
Retorna a propriedade propertyName da medida measure .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](**cube** as any) as table

Sobre
Retorna a tabela que contém o conjunto de medidas disponíveis no cube . Cada medida é representada como uma
função. As medidas podem ser aplicadas ao cubo usando [Link].
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](cube as table) as table

Sobre
Retorna uma tabela contendo o conjunto de parâmetros que pode ser aplicado a cube . Cada parâmetro é uma
função que pode ser invocada para obter cube com o parâmetro e seus argumentos aplicados.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](cube as table) as table

Sobre
Retorna uma tabela contendo o conjunto de propriedades disponíveis para dimensões expandidas no cubo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](property as any) as any

Sobre
Retorna a chave da propriedade property .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](cube as table, dimensions as table) as table

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](cube as table, transforms as list) as table

Sobre
Aplica as funções de cubo da lista, transforms , ao cube .
[Link]
09/05/2020 • 3 minutes to read

Sintaxe
[Link](server as text, database as text, optional options as nullable record) as table

Sobre
Retorna uma tabela de tabelas e exibições SQL disponíveis em um banco de dados do Db2 no servidor server na
instância de banco de dados chamada database . A porta pode ser especificada com o servidor, separada por dois-
pontos. Um parâmetro de registro opcional, options , pode ser especificado para controlar as seguintes opções:
CreateNavigationProperties : uma lógica (true/false) que define se as propriedades de navegação nos valores
retornados serão geradas (o padrão é true).
NavigationPropertyNameGenerator : uma função usada para a criação de nomes de propriedades de navegação.
Query : uma consulta SQL nativa usada para recuperar dados. Se a consulta produzir vários conjuntos de
resultados, somente o primeiro será retornado.
CommandTimeout : uma duração que controla quanto tempo a consulta do servidor tem permissão para ser
executada até ser cancelada. O valor padrão é dez minutos.
ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de
fazer conexão com o servidor. O valor padrão é dependente do driver.
HierarchicalNavigation : uma lógica (true/false) que define se as tabelas agrupadas por seus nomes de
esquema serão exibidas (o padrão é false).
Implementation : Especifica a implementação do provedor de banco de dados interno a ser usado. Os valores
válidos são: "IBM" e "Microsoft".
BinaryCodePage : Um número para o CCSID (Identificador do conjunto de caracteres codificados) para
decodificar dados binários Db2 FOR BIT em cadeias de caracteres. Aplica-se à Implementação = "Microsoft".
Defina 0 para desabilitar a conversão (padrão). Defina 1 para converter com base na codificação do banco de
dados. Defina outro número de CCSID para converter em codificação de aplicativo.
PackageCollection : Especifica um valor de cadeia de caracteres para a coleção de pacotes (o padrão é
"NULLID") para habilitar o uso de pacotes compartilhados necessários para processar instruções SQL. Aplica-se
à Implementação = "Microsoft".
UseDb2ConnectGateway : Especifica se a conexão está sendo estabelecida por meio de um gateway do Db2
Connect. Aplica-se à Implementação = "Microsoft".
O parâmetro de registro é especificado como [option1 = value1, option2 = value2...] ou [Query = "select ..."], por
exemplo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](url as text, optional options as nullable record) as table

Sobre
Retorna uma tabela de cubos agrupados pelo servidor Essbase de uma instância do Essbase no servidor APS url .
Um parâmetro de registro opcional, options , pode ser especificado para controlar as seguintes opções:
CommandTimeout : uma duração que controla quanto tempo a consulta do servidor tem permissão para ser
executada até ser cancelada. O valor padrão é dez minutos.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link]() as table

Sobre
Retorna as tabelas na pasta de trabalho do Excel atual
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](workbook as binary, optional useHeaders as nullable logical, optional delayTypes as
nullable logical) as table

Sobre
Retorna um registro de planilhas da pasta de trabalho do Excel.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link] (optional mailboxAddress as nullable text) as table

Sobre
Retorna um sumário de uma conta do Microsoft Exchange mailboxAddress . Se mailboxAddress não for
especificado, a conta padrão da credencial será usada.
[Link]
08/05/2020 • 2 minutes to read

IMPORTANT
Aviso de obsolescência do conector de dados do Facebook
A importação e atualização de dados do Facebook no Excel deixarão de funcionar a partir de abril de 2020. Você ainda
poderá usar o conector Get & Transform do Facebook (Power Query) até lá, porém, a partir de abril de 2020, não será
possível se conectar ao Facebook, e você receberá uma mensagem de erro. Nós recomendamos revisar ou remover qualquer
consulta Get & Transform (Power Query) existente que use o conector do Facebook assim que possível para evitar resultados
inesperados.

Sintaxe
[Link](url as text) as any

Sobre
Retorna um registro contendo um conjunto de tabelas encontrado no grafo do Facebook na URL especificada, url
.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](path as text, optional options as nullable record) as binary

Sobre
Retorna o conteúdo do arquivo, path , como binário.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](path as text, optional options as nullable record) as table

Sobre
Retorna uma tabela que contém uma linha para cada pasta e arquivo encontrado no caminho de pasta, path . Cada
linha contém as propriedades da pasta ou do arquivo e um link para seu conteúdo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](path as text, optional options as nullable record) as table

Sobre
Retorna uma tabela que contém uma linha para cada arquivo encontrado no caminho de pasta, path , e subpastas.
Cada linha contém propriedades do arquivo e um link para o conteúdo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link]() as table

Sobre
Retorna as contas do Google Analytics que são acessíveis pela credencial atual.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](url as text) as table

Sobre
Retorna uma tabela que contém uma linha para cada pasta e arquivo encontrado na URL da pasta, url , de um
sistema de arquivos do Hadoop. Cada linha contém as propriedades da pasta ou do arquivo e um link para seu
conteúdo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](url as text) as table

Sobre
Retorna uma tabela que contém uma linha para cada arquivo encontrado na URL da pasta, url , e subpastas de
um sistema de arquivos do Hadoop. Cada linha contém propriedades do arquivo e um link para o conteúdo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](account as text) as table

Sobre
Retorna uma tabela de navegação que contém uma linha para cada contêiner encontrado na URL da conta,
account , de um cofre de armazenamento do Azure. Cada linha contém um link para os blobs de contêiner.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](account as text) as table

Sobre
Retorna uma tabela de navegação que contém uma linha para cada contêiner encontrado na URL da conta,
account , de um cofre de armazenamento do Azure. Cada linha contém um link para os blobs de contêiner.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](account as text, containerName as text) as table

Sobre
Retorna uma tabela que contém uma linha para cada arquivo de blob encontrado na URL do contêiner, account ,
de um cofre de armazenamento do Azure. Cada linha contém propriedades do arquivo e um link para o conteúdo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](html as any, columnNameSelectorPairs as list, optional options as nullable record) as
table

Sobre
Esta função não está disponível porque requer o .NET 4.5.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](identityProvider as function, value as any) as record

Sobre
Cria uma identidade.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](identity as record, collection as record) as logical

Sobre
Determina se uma identidade é um membro de uma coleção de identidades.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link]() as any

Sobre
O provedor de identidade padrão do host atual.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](server as text, database as text, optional options as nullable record) as table

Sobre
Retorna uma tabela de tabelas e exibições SQL disponíveis em um banco de dados do Informix no servidor server
na instância de banco de dados chamada database . A porta pode ser especificada com o servidor, separada por
dois-pontos. Um parâmetro de registro opcional, options , pode ser especificado para controlar as seguintes
opções:
CreateNavigationProperties : uma lógica (true/false) que define se as propriedades de navegação nos valores
retornados serão geradas (o padrão é true).
NavigationPropertyNameGenerator : uma função usada para a criação de nomes de propriedades de navegação.
Query : uma consulta SQL nativa usada para recuperar dados. Se a consulta produzir vários conjuntos de
resultados, somente o primeiro será retornado.
CommandTimeout : uma duração que controla quanto tempo a consulta do servidor tem permissão para ser
executada até ser cancelada. O valor padrão é dez minutos.
ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de
fazer conexão com o servidor. O valor padrão é dependente do driver.
HierarchicalNavigation : uma lógica (true/false) que define se as tabelas agrupadas por seus nomes de
esquema serão exibidas (o padrão é false).
O parâmetro de registro é especificado como [option1 = value1, option2 = value2...] ou [Query = "select ..."], por
exemplo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](jsonText as any, optional encoding as nullable number) as any

Sobre
Retorna o conteúdo do documento JSON.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional encoding as nullable number) as binary

Sobre
Produz uma representação JSON de um valor especificado value com uma codificação de texto especificada por
encoding . Se encoding for omitido, UTF8 será usado. Os valores são representados da seguinte maneira:

Valores nulos, lógicos e de texto são representados como os tipos JSON correspondentes
Os números são representados como números em JSON, exceto que #infinity , -#infinity e #nan são
convertidos em NULL
As listas são representadas como matrizes JSON
Os registros são representados como objetos JSON
As tabelas são representadas como uma matriz de objetos
Datas, horas, data e hora, fusos horários e durações são representados como texto ISO-8601
Os valores binários são representados como texto codificado em base64
Tipos e funções produzem um erro

Exemplo 1
Converter um valor complexo em JSON.

[Link]([Link]([A = {1, true, "3"}, B = #date(2012, 3, 25)]))

"{""A"":[1,true,""3""],""B"":""2012-03-25""}"
[Link]
09/05/2020 • 3 minutes to read

Sintaxe
[Link](server as text, database as text, optional options as nullable record) as table

Sobre
Retorna uma tabela de tabelas SQL, exibições e funções escalares armazenadas disponíveis em um banco de dados
MySQL no servidor server na instância do banco de dados chamada database . A porta pode ser especificada
com o servidor, separada por dois-pontos. Um parâmetro de registro opcional, options , pode ser especificado
para controlar as seguintes opções:
Encoding : Um valor de TextEncoding que especifica o conjunto de caracteres usado para codificar todas as
consultas enviadas ao servidor (o padrão é nulo).
CreateNavigationProperties : uma lógica (true/false) que define se as propriedades de navegação nos valores
retornados serão geradas (o padrão é true).
NavigationPropertyNameGenerator : uma função usada para a criação de nomes de propriedades de navegação.
Query : uma consulta SQL nativa usada para recuperar dados. Se a consulta produzir vários conjuntos de
resultados, somente o primeiro será retornado.
CommandTimeout : uma duração que controla quanto tempo a consulta do servidor tem permissão para ser
executada até ser cancelada. O valor padrão é dez minutos.
ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de
fazer conexão com o servidor. O valor padrão é dependente do driver.
TreatTinyAsBoolean : uma lógica (true/false) que determina se será necessário forçar as colunas tinyint no
servidor como valores lógicos. O valor padrão é true.
OldGuids : uma lógica (true/false) que define se as colunas char(36) (em caso de false) ou binary(16) (em caso
de true) serão tratadas como GUIDs. O valor padrão é false.
ReturnSingleDatabase : uma lógica (true/false) que define se todas as tabelas de todos os banco de dados serão
retornadas (em caso de false) ou se as tabelas e visualizações do banco de dados especificado serão retornadas
(em caso de true). O valor padrão é false.
HierarchicalNavigation : uma lógica (true/false) que define se as tabelas agrupadas por seus nomes de
esquema serão exibidas (o padrão é false).
O parâmetro de registro é especificado como [option1 = value1, option2 = value2...] ou [Query = "select ..."], por
exemplo.
[Link]
09/05/2020 • 5 minutes to read

Sintaxe
[Link](serviceUri as text, optional headers as nullable record, optional options as any) as
any

Sobre
Retorna uma tabela de feeds OData oferecidos por um serviço OData de um URI serviceUri , cabeçalhos headers .
Um valor booliano que especifica se é necessário usar conexões simultâneas ou um parâmetro de registro
opcional, options , pode ser especificado para controlar as seguintes opções:
Query : adicione programaticamente parâmetros de consulta à URL sem precisar se preocupar com a saída.
Headers : especificar esse valor como um registro fornecerá cabeçalhos adicionais a uma solicitação HTTP.
ExcludedFromCacheKey : especificar esse valor como uma lista excluirá essas chaves de cabeçalho HTTP de
fazerem parte do cálculo para armazenar dados em cache.
ApiKeyName : se o site de destino tiver uma noção de uma chave de API, esse parâmetro poderá ser usado para
especificar o nome (não o valor) do parâmetro de chave que deve ser usado na URL. O valor real da chave é
fornecido na credencial.
Timeout : especificar esse valor como uma duração alterará o tempo limite de uma solicitação HTTP. O valor
padrão é de 600 segundos.
EnableBatch : uma lógica (true/false) que define se a geração de uma solicitação de $batch OData deverá ser
permitida se o MaxUriLength for excedido (o padrão é false).
MaxUriLength : um número que indica o comprimento máximo de um URI permitido enviado a um serviço
OData. Se excedido e EnableBatch for true, a solicitação será feita a um ponto de extremidade de $batch OData,
caso contrário, falhará (o padrão é 2048).
Concurrent : em uma lógica (true/false), quando definida como true, as solicitações ao serviço serão feitas
simultaneamente. Quando definida como false, as solicitações serão feitas em sequência. Quando não
especificado, o valor será determinado pela anotação AsynchronousRequestsSupported do serviço. Se o serviço
não especificar se há suporte para AsynchronousRequestsSupported, as solicitações serão feitas em sequência.
ODataVersion : Um número (3 ou 4) que especifica a versão do protocolo OData a ser usada para esse serviço
de OData. Quando não especificadas, todas as versões com suporte serão solicitadas. A versão do serviço será
determinada pelo cabeçalho OData-Version retornado pelo serviço.
FunctionOverloads : Uma lógica (true/false) quando definida como true: as sobrecargas de importação de
função estarão listadas no navegador como entradas separadas; quando definida como false: as sobrecargas de
importação de função estarão listadas como uma função de união no navegador. Valor padrão para V3: false.
Valor padrão para V4: true.
MoreColumns : uma lógica (true/false) quando definida como true, adiciona uma coluna "Mais colunas" a cada
feed de entidade que contém tipos abertos e polimórficos. Conterá os campos não declarados no tipo base.
Quando for false, este campo não estará presente. O padrão é false.
IncludeAnnotations : uma lista separada por vírgulas de padrões ou nomes de termos qualificados de
namespace a ser incluída com "*" como um caractere curinga. Por padrão, nenhuma das anotações estão
incluídas.
IncludeMetadataAnnotations : uma lista separada por vírgulas de padrões ou nomes de termos qualificados de
namespace a ser incluída em solicitações de documento de metadados, com "*" como um caractere curinga. Por
padrão, inclui as mesmas anotações que IncludeAnnotations.
OmitValues : permite que o serviço OData evite gravar determinados valores em respostas. Se for confirmado,
vamos inferir esses valores dos campos omitidos. As opções incluem:
[Link] : permite que o serviço OData omita valores nulos.
Implementation : Especifica a implementação do conector OData a ser usada. Os valores válidos são "2.0" ou
nulo.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Permite que o serviço OData omita valores nulos.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](connectionString as any, optional options as nullable record) as table

Sobre
Retorna uma tabela de exibições e tabelas SQL da fonte de dados ODBC especificada pela cadeia de conexão
connectionString . connectionString pode ser um texto ou um registro de pares de valor da propriedade. Os
valores de propriedade podem ser texto ou número. Um parâmetro de registro opcional, options , pode ser
fornecido para especificar propriedades adicionais. O registro pode conter os seguintes campos:
CreateNavigationProperties : uma lógica (true/false) que define se as propriedades de navegação nos valores
retornados serão geradas (o padrão é true).
HierarchicalNavigation : uma lógica (true/false) que define se as tabelas agrupadas por seus nomes de
esquema serão exibidas (o padrão é false).
ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de
fazer conexão com o servidor. O valor padrão é de 15 segundos.
CommandTimeout : uma duração que controla quanto tempo a consulta do servidor tem permissão para ser
executada até ser cancelada. O valor padrão é dez minutos.
SqlCompatibleWindowsAuth : um valor lógico (true/false) que determina se as opções de cadeia de conexão
compatíveis com o SQL Server devem ser produzidas para a autenticação do Windows. O valor padrão é true.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](connectionString as any) as record

Sobre
Retorna o resultado da tentativa de inferir as funcionalidades SQL com a cadeia de conexão connectionString
usando o ODBC. connectionString pode ser um texto ou um registro de pares de valor da propriedade. Os valores
de propriedade podem ser texto ou número.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](connectionString as any, query as text, optional options as nullable record) as table

Sobre
Retorna o resultado da execução de query com a cadeia de conexão connectionString usando ODBC.
connectionString pode ser um texto ou um registro de pares de valor da propriedade. Os valores de propriedade
podem ser texto ou número. Um parâmetro de registro opcional, options , pode ser fornecido para especificar
propriedades adicionais. O registro pode conter os seguintes campos:
ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de
fazer conexão com o servidor. O valor padrão é de 15 segundos.
CommandTimeout : uma duração que controla quanto tempo a consulta do servidor tem permissão para ser
executada até ser cancelada. O valor padrão é dez minutos.
SqlCompatibleWindowsAuth : um valor lógico (true/false) que determina se as opções de cadeia de conexão
compatíveis com o SQL Server devem ser produzidas para a autenticação do Windows. O valor padrão é true.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](connectionString as any, optional options as nullable record) as table

Sobre
Retorna uma tabela de exibições e tabelas SQL da fonte de dados OLE DB especificada pela cadeia de conexão
connectionString . connectionString pode ser um texto ou um registro de pares de valor da propriedade. Os
valores de propriedade podem ser texto ou número. Um parâmetro de registro opcional, options , pode ser
fornecido para especificar propriedades adicionais. O registro pode conter os seguintes campos:
CreateNavigationProperties : uma lógica (true/false) que define se as propriedades de navegação nos valores
retornados serão geradas (o padrão é true).
NavigationPropertyNameGenerator : uma função usada para a criação de nomes de propriedades de navegação.
Query : uma consulta SQL nativa usada para recuperar dados. Se a consulta produzir vários conjuntos de
resultados, somente o primeiro será retornado.
HierarchicalNavigation : uma lógica (true/false) que define se as tabelas agrupadas pelos respectivos nomes de
esquema serão exibidas (o padrão é true).
ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de
fazer conexão com o servidor. O valor padrão é dependente do driver.
CommandTimeout : uma duração que controla quanto tempo a consulta do servidor tem permissão para ser
executada até ser cancelada. O valor padrão é dez minutos.
SqlCompatibleWindowsAuth : um valor lógico (true/false) que determina se as opções de cadeia de conexão
compatíveis com o SQL Server devem ser produzidas para a autenticação do Windows. O valor padrão é true.
O parâmetro de registro é especificado como [option1 = value1, option2 = value2...] ou [Query = "select ..."], por
exemplo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](connectionString as any, query as text, optional options as nullable record) as table

Sobre
Retorna o resultado da execução de query com a cadeia de conexão connectionString usando OLE DB.
connectionString pode ser um texto ou um registro de pares de valor da propriedade. Os valores de propriedade
podem ser texto ou número. Um parâmetro de registro opcional, options , pode ser fornecido para especificar
propriedades adicionais. O registro pode conter os seguintes campos:
ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de
fazer conexão com o servidor. O valor padrão é dependente do driver.
CommandTimeout : uma duração que controla quanto tempo a consulta do servidor tem permissão para ser
executada até ser cancelada. O valor padrão é dez minutos.
SqlCompatibleWindowsAuth : um valor lógico (true/false) que determina se as opções de cadeia de conexão
compatíveis com o SQL Server devem ser produzidas para a autenticação do Windows. O valor padrão é true.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](server as text, optional options as nullable record) as table

Sobre
Retorna uma tabela de tabelas e exibições SQL do Oracle Database no servidor server . A porta pode ser
especificada com o servidor, separada por dois-pontos. Um parâmetro de registro opcional, options , pode ser
especificado para controlar as seguintes opções:
CreateNavigationProperties : uma lógica (true/false) que define se as propriedades de navegação nos valores
retornados serão geradas (o padrão é true).
NavigationPropertyNameGenerator : uma função usada para a criação de nomes de propriedades de navegação.
Query : uma consulta SQL nativa usada para recuperar dados. Se a consulta produzir vários conjuntos de
resultados, somente o primeiro será retornado.
CommandTimeout : uma duração que controla quanto tempo a consulta do servidor tem permissão para ser
executada até ser cancelada. O valor padrão é dez minutos.
ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de
fazer conexão com o servidor. O valor padrão é dependente do driver.
HierarchicalNavigation : uma lógica (true/false) que define se as tabelas agrupadas por seus nomes de
esquema serão exibidas (o padrão é false).
O parâmetro de registro é especificado como [option1 = value1, option2 = value2...] ou [Query = "select ..."], por
exemplo.
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](binary as binary) as any

Sobre
Esta função não está disponível porque requer o .NET 4.5.
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](pdf as binary, optional options as nullable record) as table

Sobre
Esta função não está disponível porque requer o .NET 4.5.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](server as text, database as text, optional options as nullable record) as
table

Sobre
Retorna uma tabela de tabelas e exibições SQL disponíveis em um banco de dados do PostgreSQL no servidor
server na instância de banco de dados chamada database . A porta pode ser especificada com o servidor,
separada por dois-pontos. Um parâmetro de registro opcional, options , pode ser especificado para controlar as
seguintes opções:
CreateNavigationProperties : uma lógica (true/false) que define se as propriedades de navegação nos valores
retornados serão geradas (o padrão é true).
NavigationPropertyNameGenerator : uma função usada para a criação de nomes de propriedades de navegação.
Query : uma consulta SQL nativa usada para recuperar dados. Se a consulta produzir vários conjuntos de
resultados, somente o primeiro será retornado.
CommandTimeout : uma duração que controla quanto tempo a consulta do servidor tem permissão para ser
executada até ser cancelada. O valor padrão é dez minutos.
ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de
fazer conexão com o servidor. O valor padrão é dependente do driver.
HierarchicalNavigation : uma lógica (true/false) que define se as tabelas agrupadas por seus nomes de
esquema serão exibidas (o padrão é false).
O parâmetro de registro é especificado como [option1 = value1, option2 = value2...] ou [Query = "select ..."], por
exemplo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](stream as binary) as any

Sobre
Retorna um registro de quadros de dados do arquivo RData.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](optional loginUrl as any, optional options as nullable record) as table

Sobre
Retorna os objetos na conta do Salesforce fornecida nas credenciais. A conta será conectada por meio da loginUrl
do ambiente fornecido. Se nenhum ambiente for fornecido, a conta será conectada à produção
([Link] Um parâmetro de registro opcional, options , pode ser fornecido para especificar
propriedades adicionais. O registro pode conter os seguintes campos:
CreateNavigationProperties : Uma lógica (true/false) que define se as propriedades de navegação nos
valores retornados serão geradas (o padrão é false).
ApiVersion : A versão da API do Salesforce a ser usada para esta consulta. Quando não especificado, a
versão 29.0 da API é usada.
Timeout : Uma duração que controla por quanto tempo esperar antes de abandonar a solicitação para o
servidor. O valor padrão é específico da fonte.
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](optional loginUrl as nullable text, optional options as nullable record) as
table

Sobre
Retorna os relatórios na conta do Salesforce fornecida nas credenciais. A conta será conectada por meio da
loginUrl do ambiente fornecido. Se nenhum ambiente for fornecido, a conta será conectada à produção
([Link] Um parâmetro de registro opcional, options , pode ser fornecido para especificar
propriedades adicionais. O registro pode conter os seguintes campos:
ApiVersion : A versão da API do Salesforce a ser usada para esta consulta. Quando não especificado, a
versão 29.0 da API é usada.
Timeout : Uma duração que controla por quanto tempo esperar antes de abandonar a solicitação para o
servidor. O valor padrão é específico da fonte.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](server as text, systemNumberOrSystemId as text, clientId as text,
optional optionsOrLogonGroup as any, optional options as nullable record) as table

Sobre
Retorna uma tabela de InfoCubes e consultas agrupadas por InfoArea de uma instância do SAP Business
Warehouse no servidor server com o número do sistema systemNumberOrSystemId e a ID do cliente clientId . Um
parâmetro de registro opcional, optionsOrLogonGroup , pode ser especificado para controlar as opções.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Opção 'Modo de mesclagem de DataStream' para execução de MDX no SAP Business Warehouse.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Opção 'Modo de mesclagem de bXML' para execução de MDX no SAP Business Warehouse.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Opção 'Modo de mesclagem de bXML compactado em Gzip' para execução de MDX no SAP Business Warehouse.
Recomendado para consultas de alto volume ou baixa latência.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](**server** as text, optional **options** as nullable record) as table

Sobre
Retorna uma tabela de pacotes multidimensionais do banco de dados SAP HANA server . Um parâmetro de
registro opcional, options , pode ser especificado para controlar as seguintes opções:
Query : uma consulta SQL nativa usada para recuperar dados. Se a consulta produzir vários conjuntos de
resultados, somente o primeiro será retornado.
Distribution : Uma SapHanaDistribution que define o valor da propriedade "Distribuição" na cadeia de
conexão. Os roteiros de instruções são o método para avaliar o nó de servidor correto de um sistema
distribuído antes da execução da instrução. O valor padrão é [Link].
[Link]
09/05/2020 • 2 minutes to read

Sobre
Opção de distribuição 'All' para SAP HANA.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Opção de distribuição 'Connection' para SAP HANA.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Opção de distribuição 'Off' para SAP HANA.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Opção de distribuição 'Statement' para SAP HANA.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Operador de intervalo 'equals' para parâmetros de entrada do SAP HANA.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Operador de intervalo 'greater than' para parâmetros de entrada do SAP HANA.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Operador de intervalo 'greater than or equals' para parâmetros de entrada do SAP HANA.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Operador de intervalo 'less than' para parâmetros de entrada do SAP HANA.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Operador de intervalo 'less than or equals' para parâmetros de entrada do SAP HANA.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Operador de intervalo 'not equals' para parâmetros de entrada do SAP HANA.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](url as text, optional options as nullable record) as table

Sobre
Retorna uma tabela que contém uma linha para cada pasta e documento encontrados no site do SharePoint
especificado, url . Cada linha contém as propriedades da pasta ou do arquivo e um link para seu conteúdo.
options pode ser especificado para controlar as seguintes opções:

ApiVersion : Um número (14 ou 15) ou o texto "Automático" que especifica a versão da API do SharePoint a ser
usada para este site. Quando não especificado, a versão 14 da API é usada. Quando Auto é especificado, a
versão do servidor será descoberta automaticamente, se possível; caso contrário, a versão usará 14 como
padrão. Sites do SharePoint que não estejam em inglês exigem pelo menos a versão 15.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](url as text, optional options as nullable record) as table

Sobre
Retorna uma tabela que contém uma linha para cada documento encontrado no site do SharePoint especificado,
url , e subpastas. Cada linha contém as propriedades da pasta ou do arquivo e um link para seu conteúdo.
options pode ser especificado para controlar as seguintes opções:

ApiVersion : Um número (14 ou 15) ou o texto "Automático" que especifica a versão da API do SharePoint a ser
usada para este site. Quando não especificado, a versão 14 da API é usada. Quando Auto é especificado, a
versão do servidor será descoberta automaticamente, se possível; caso contrário, a versão usará 14 como
padrão. Sites do SharePoint que não estejam em inglês exigem pelo menos a versão 15.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](url as text, optional options as nullable record) as table

Sobre
Retorna uma tabela que contém uma linha para cada item de Lista encontrado na lista do SharePoint especificada,
url . Cada linha contém propriedades da Lista. options pode ser especificado para controlar as seguintes opções:

ApiVersion : Um número (14 ou 15) ou o texto "Automático" que especifica a versão da API do SharePoint a ser
usada para este site. Quando não especificado, a versão 14 da API é usada. Quando Auto é especificado, a
versão do servidor será descoberta automaticamente, se possível; caso contrário, a versão usará 14 como
padrão. Sites do SharePoint que não estejam em inglês exigem pelo menos a versão 15.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](url as text) as table

Sobre
Retorna uma tabela do conteúdo na URL url especificada formatada de acordo com a API SODA 2.0. A URL deve
apontar para uma fonte em conformidade com SODA válida que termina em uma extensão .csv.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](server as text, database as text, optional options as nullable record) as table

Sobre
Retorna uma tabela de tabelas SQL, exibições e funções armazenadas do banco de dados do SQL Server database
no servidor server . A porta pode ser especificada com o servidor, separada por dois-pontos ou vírgula. Um
parâmetro de registro opcional, options , pode ser especificado para controlar as seguintes opções:
Query : uma consulta SQL nativa usada para recuperar dados. Se a consulta produzir vários conjuntos de
resultados, somente o primeiro será retornado.
CreateNavigationProperties : uma lógica (true/false) que define se as propriedades de navegação nos valores
retornados serão geradas (o padrão é true).
NavigationPropertyNameGenerator : uma função usada para a criação de nomes de propriedades de navegação.
MaxDegreeOfParallelism : um número que define o valor da cláusula de consulta "maxdop" na consulta SQL
gerada.
CommandTimeout : uma duração que controla quanto tempo a consulta do servidor tem permissão para ser
executada até ser cancelada. O valor padrão é dez minutos.
ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de
fazer conexão com o servidor. O valor padrão é dependente do driver.
HierarchicalNavigation : uma lógica (true/false) que define se as tabelas agrupadas por seus nomes de
esquema serão exibidas (o padrão é false).
MultiSubnetFailover : uma lógica (true/false) que define o valor da propriedade "MultiSubnetFailover" na cadeia
de conexão (o padrão é false).
UnsafeTypeConversions
ContextInfo : Um valor binário que é usado para definir o CONTEXT_INFO antes de executar cada comando.
O parâmetro de registro é especificado como [option1 = value1, option2 = value2...] ou [Query = "select ..."], por
exemplo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](server as text, optional options as nullable record) as table

Sobre
Retorna uma tabela de bancos de dados no SQL Server especificado, server . Um parâmetro de registro opcional,
options , pode ser especificado para controlar as seguintes opções:

CreateNavigationProperties : uma lógica (true/false) que define se as propriedades de navegação nos valores
retornados serão geradas (o padrão é true).
NavigationPropertyNameGenerator : uma função usada para a criação de nomes de propriedades de navegação.
MaxDegreeOfParallelism : um número que define o valor da cláusula de consulta "maxdop" na consulta SQL
gerada.
CommandTimeout : uma duração que controla quanto tempo a consulta do servidor tem permissão para ser
executada até ser cancelada. O valor padrão é dez minutos.
ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de
fazer conexão com o servidor. O valor padrão é dependente do driver.
HierarchicalNavigation : uma lógica (true/false) que define se as tabelas agrupadas por seus nomes de
esquema serão exibidas (o padrão é false).
MultiSubnetFailover : uma lógica (true/false) que define o valor da propriedade "MultiSubnetFailover" na cadeia
de conexão (o padrão é false).
UnsafeTypeConversions
ContextInfo : Um valor binário que é usado para definir o CONTEXT_INFO antes de executar cada comando.
O parâmetro de registro é especificado como [option1 = value1, option2 = value2...], por exemplo.
Não oferece suporte à definição de uma consulta SQL a ser executada no servidor. [Link] deve ser usado
em vez de executar uma consulta SQL.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](server as text, database as text, optional options as nullable record) as table

Sobre
Retorna uma tabela de tabelas e exibições SQL disponíveis em um banco de dados Sybase no servidor server na
instância de banco de dados chamada database . A porta pode ser especificada com o servidor, separada por dois-
pontos. Um parâmetro de registro opcional, options , pode ser especificado para controlar as seguintes opções:
CreateNavigationProperties : uma lógica (true/false) que define se as propriedades de navegação nos valores
retornados serão geradas (o padrão é true).
NavigationPropertyNameGenerator : uma função usada para a criação de nomes de propriedades de navegação.
Query : uma consulta SQL nativa usada para recuperar dados. Se a consulta produzir vários conjuntos de
resultados, somente o primeiro será retornado.
CommandTimeout : uma duração que controla quanto tempo a consulta do servidor tem permissão para ser
executada até ser cancelada. O valor padrão é dez minutos.
ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de
fazer conexão com o servidor. O valor padrão é dependente do driver.
HierarchicalNavigation : uma lógica (true/false) que define se as tabelas agrupadas por seus nomes de
esquema serão exibidas (o padrão é false).
O parâmetro de registro é especificado como [option1 = value1, option2 = value2...] ou [Query = "select ..."], por
exemplo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](server as text, optional options as nullable record) as table

Sobre
Retorna uma tabela de tabelas e exibições SQL do banco de dados Teradata no servidor server . A porta pode ser
especificada com o servidor, separada por dois-pontos. Um parâmetro de registro opcional, options , pode ser
especificado para controlar as seguintes opções:
CreateNavigationProperties: uma lógica (true/false) que define se as propriedades de navegação nos
valores retornados serão geradas (o padrão é true).
NavigationPropertyNameGenerator : uma função usada para a criação de nomes de propriedades de
navegação.
Query : uma consulta SQL nativa usada para recuperar dados. Se a consulta produzir vários conjuntos de
resultados, somente o primeiro será retornado.
CommandTimeout : uma duração que controla quanto tempo a consulta do servidor tem permissão para ser
executada até ser cancelada. O valor padrão é dez minutos.
ConnectionTimeout: uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de
fazer conexão com o servidor. O valor padrão é dependente do driver.
: uma lógica (true/false) que define se as tabelas agrupadas por seus nomes de
HierarchicalNavigation
esquema serão exibidas (o padrão é false).
O parâmetro de registro é especificado como [option1 = value1, option2 = value2...] ou [Query = "select ..."], por
exemplo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](method as text, url as text, optional options as nullable record) as action

Sobre
Cria uma ação que, quando executada, retornará os resultados de realizar uma solicitação method com relação a
url usando HTTP como um valor binário. Um parâmetro de registro opcional, options , pode ser fornecido para
especificar propriedades adicionais. O registro pode conter os seguintes campos:
Query : adicione programaticamente parâmetros de consulta à URL sem precisar se preocupar com a saída.
ApiKeyName : se o site de destino tiver uma noção de uma chave de API, esse parâmetro poderá ser usado para
especificar o nome (não o valor) do parâmetro de chave que deve ser usado na URL. O valor real da chave é
fornecido na credencial.
Content : a especificação desse valor altera a solicitação da Web de GET para POST, usando o valor do campo
Content como o conteúdo de POST.
Headers : especificar esse valor como um registro fornecerá cabeçalhos adicionais a uma solicitação HTTP.
Timeout : especificar esse valor como uma duração alterará o tempo limite de uma solicitação HTTP. O valor
padrão é de 100 segundos.
IsRetry : a especificação desse valor lógico como verdadeiro ignorará qualquer resposta existente no cache ao
buscar dados.
ManualStatusHandling : especificar esse valor como uma lista impedirá qualquer manipulação interna para
solicitações HTTP cuja resposta tenha um desses códigos de status.
RelativePath : especificar esse valor como texto o acrescentará à URL base antes de fazer a solicitação.
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](url as text, optional options as nullable record) as text

Sobre
Esta função não está disponível porque requer o .NET 4.5.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](url as text, optional options as nullable record) as binary

Sobre
Retorna o conteúdo baixado de url como binário. Um parâmetro de registro opcional, options , pode ser
fornecido para especificar propriedades adicionais. O registro pode conter os seguintes campos:
Query : adicione programaticamente parâmetros de consulta à URL sem precisar se preocupar com a saída.
ApiKeyName : se o site de destino tiver uma noção de uma chave de API, esse parâmetro poderá ser usado para
especificar o nome (não o valor) do parâmetro de chave que deve ser usado na URL. O valor real da chave é
fornecido na credencial.
Content : a especificação desse valor altera a solicitação da Web de GET para POST, usando o valor do campo
Content como o conteúdo de POST.
Headers : especificar esse valor como um registro fornecerá cabeçalhos adicionais a uma solicitação HTTP.
Timeout : especificar esse valor como uma duração alterará o tempo limite de uma solicitação HTTP. O valor
padrão é de 100 segundos.
ExcludedFromCacheKey : especificar esse valor como uma lista excluirá essas chaves de cabeçalho HTTP de
fazerem parte do cálculo para armazenar dados em cache.
IsRetry : a especificação desse valor lógico como verdadeiro ignorará qualquer resposta existente no cache ao
buscar dados.
ManualStatusHandling : especificar esse valor como uma lista impedirá qualquer manipulação interna para
solicitações HTTP cuja resposta tenha um desses códigos de status.
RelativePath : especificar esse valor como texto o acrescentará à URL base antes de fazer a solicitação.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](html as any) as table

Sobre
Retorna o conteúdo do documento HTML decomposto em suas estruturas constitutivas, bem como uma
representação do documento completo e respectivo texto após a remoção das marcas.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Especifica o método DELETE para HTTP.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Especifica o método GET para HTTP.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Especifica o método HEAD para HTTP.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Especifica o método PATCH para HTTP.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Especifica o método POST para HTTP.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Especifica o método PUT para HTTP.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](contents as any, optional encoding as nullable number) as table

Sobre
Retorna o conteúdo do documento XML como uma tabela hierárquica.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](contents as any, optional options as nullable record, optional encoding as nullable
number) as table

Sobre
Retorna o conteúdo do documento XML como uma coleção aninhada de tabelas niveladas.
Funções binárias
08/05/2020 • 6 minutes to read

Essas funções criam e manipulam dados binários.

Formatos binários
Leitura de números
F UN Ç Ã O DESC RIÇ Ã O

BinaryFormat.7BitEncodedSignedInteger Um formato binário que lê um inteiro com sinal de 64 bits que


foi codificado usando a codificação de tamanho variável de 7
bits.

BinaryFormat.7BitEncodedUnsignedInteger Um formato binário que lê um inteiro sem sinal de 64 bits que


foi codificado usando a codificação de tamanho variável de 7
bits.

[Link] Retorna um formato binário que lê um valor binário.

[Link] Um formato binário que lê um inteiro sem sinal de 8 bits.

[Link] Retorna um formato binário que escolhe o próximo formato


binário com base em um valor que já foi lido.

[Link] Um formato binário que lê um valor decimal de 16 bytes do


.NET.

[Link] Um formato binário que lê um valor de ponto flutuante de


precisão dupla IEEE de 8 bytes.

[Link] Retorna um formato binário que lê um grupo de itens. Cada


valor de item é precedido por um valor de chave exclusivo. O
resultado é uma lista de valores de itens.

[Link] Retorna um formato binário que limita a quantidade de dados


que pode ser lida. Tanto [Link] quanto
[Link] podem ser usados para fazer a leitura até
o final dos dados. [Link] pode ser usado para
limitar o número de bytes lidos.

[Link] Retorna um formato binário que lê uma sequência de itens e


retorna uma lista.

[Link] Um formato binário que lê zero bytes e retorna nulo.

[Link] Retorna um formato binário que lê um registro. Cada campo


do registro pode ter um formato binário diferente.

BinaryFormat.SignedInteger16 Um formato binário que lê um inteiro com sinal de 16 bits.


F UN Ç Ã O DESC RIÇ Ã O

BinaryFormat.SignedInteger32 Um formato binário que lê um inteiro com sinal de 32 bits.

BinaryFormat.SignedInteger64 Um formato binário que lê um inteiro com sinal de 64 bits.

[Link] Um formato binário que lê um valor de ponto flutuante de


precisão simples IEEE de 4 bytes.

[Link] Retorna um formato binário que lê um valor de texto. O valor


de codificação opcional especifica a codificação do texto.

[Link] Retorna um formato binário que transformará os valores lidos


por outro formato binário.

BinaryFormat.UnsignedInteger16 Um formato binário que lê um inteiro sem sinal de 16 bits.

BinaryFormat.UnsignedInteger32 Um formato binário que lê um inteiro sem sinal de 32 bits.

BinaryFormat.UnsignedInteger64 Um formato binário que lê um inteiro sem sinal de 64 bits.

C O N T RO L E DA O RDEM DE B Y T E DESC RIÇ Ã O

[Link] Retorna um formato binário com a ordem de byte especificada


por uma função.

[Link] Retorna informações sobre como uma tabela é particionada.

Binário
F UN Ç Ã O DESC RIÇ Ã O

[Link] Armazena em buffer o valor binário na memória. O resultado


dessa chamada é um valor binário estável, o que significa que
ele terá uma ordem de byte e um tamanho determinísticos.

[Link] Combina uma lista de binários em um só binário.

[Link] Compacta um valor binário usando o tipo de compactação


especificado.

[Link] Descompacta um valor binário usando o tipo de compactação


especificado.

[Link] Retorna um valor binário do valor especificado.

[Link] Converte uma lista de números em um valor binário

[Link] Decodifica dados de um formato de texto em binário.

[Link] Retorna um registro com o campo [Link] que contém


o tipo MIME inferido.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna o tamanho dos valores binários.

[Link] Converte um valor binário em lista de números

[Link] Codifica dados binários em um formato de texto.

BinaryEncoding.Base64 Constante a ser usada como o tipo de codificação quando a


codificação de Base 64 é necessária.

[Link] Constante a ser usada como o tipo de codificação quando a


codificação hexadecimal é necessária.

[Link] O item não deverá aparecer nenhuma vez ou deverá aparecer


uma vez na entrada.

[Link] O item não deverá aparecer nenhuma vez ou deverá aparecer


mais vezes na entrada.

[Link] O item deverá aparecer uma vez na entrada.

[Link] Um valor possível para o parâmetro byteOrder em


[Link] . O byte mais significativo aparece
primeiro na ordem de byte big endian.

[Link] Um valor possível para o parâmetro byteOrder em


[Link] . O byte menos significativo
aparece primeiro na ordem de byte little endian.

[Link] Os dados compactados estão no formato 'Deflate'.

[Link] Os dados compactados estão no formato 'GZip'.

[Link] O item não deverá aparecer nenhuma vez ou deverá aparecer


uma vez na entrada.

[Link] O item não deverá aparecer nenhuma vez ou deverá aparecer


mais vezes na entrada.

[Link] O item deverá aparecer uma vez na entrada.

#binary Cria um valor binário usando números ou texto.


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](binary as nullable binary) as nullable binary

Sobre
Armazena em buffer o valor binário na memória. O resultado dessa chamada é um valor binário estável, o que
significa que ele terá uma ordem de byte e um tamanho determinísticos.

Exemplo 1
Crie uma versão estável do valor binário.

[Link]([Link]({0..10}))

#binary({0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10})
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](binaries as list) as binary

Sobre
Combina uma lista de binários em um só binário.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](binary as nullable binary, compressionType as number) as nullable binary

Sobre
Compacta um valor binário usando o tipo de compactação especificado. O resultado dessa chamada é uma cópia
compactada da entrada. Os tipos de compactação incluem:
[Link]
[Link]

Exemplo 1
Comprime o valor binário.

[Link]([Link]([Link]({10}, 1000)), [Link])

#binary({227, 226, 26, 5, 163, 96, 20, 12, 119, 0, 0})


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](binary as nullable binary, compressionType as number) as nullable binary

Sobre
Descompacta um valor binário usando o tipo de compactação especificado. O resultado dessa chamada é uma
cópia descompactada da entrada. Os tipos de compactação incluem:
[Link]

[Link]

Exemplo 1
Descompacte o valor binário.

[Link](#binary({115, 103, 200, 7, 194, 20, 134, 36, 134, 74, 134, 84, 6, 0}), [Link])

#binary({71, 0, 111, 0, 111, 0, 100, 0, 98, 0, 121, 0, 101, 0})


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional encoding as nullable number) as nullable binary

Sobre
Retorna um valor binary do value especificado. Se o value fornecido for null , [Link] retornará null .
Se o value fornecido for binary , value será retornado. Os valores dos seguintes tipos podem ser convertidos
em um valor binary :
text : Um valor binary da representação de texto. Confira [Link] para obter detalhes.
Se value for de qualquer outro tipo, um erro será retornado.

Exemplo 1
Obtenha o valor binary de "1011" .

[Link]("1011")

[Link]("1011", BinaryEncoding.Base64)
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list) as binary

Sobre
Converte uma lista de números em um valor binário.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, optional encoding as nullable number) as nullable binary

Sobre
Retorna o resultado da conversão do valor de texto text em um binário (lista de number ). encoding pode ser
especificado para indicar a codificação usada no valor de texto. Os valores de BinaryEncoding a seguir podem ser
usados para encoding .
BinaryEncoding.Base64 : Codificação base 64
[Link] : Codificação hexadecimal

Exemplo 1
Decodifique "1011" em binário.

[Link]("1011")

[Link]("1011", BinaryEncoding.Base64)

Exemplo 2
Decodifique "1011" em binário com codificação Hexadecimal.

[Link]("1011", [Link])

[Link]("EBE=", BinaryEncoding.Base64)
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](source as binary) as record

Sobre
Retorna um registro com o campo [Link] que contém o tipo MIME inferido. Se o tipo de conteúdo inferido
for text/* e uma página de código de codificação for detectada, retornará também o campo [Link] que
contém a codificação do fluxo. Se o tipo de conteúdo inferido for texto/csv e o formato for delimitado, retornará
também o campo [Link] que contém uma tabela para análise de possíveis delimitadores. Se o tipo
de conteúdo inferido for texto/csv e o formato for de largura fixa, retornará também o campo
[Link] contendo uma lista para a análise de posições de coluna de largura fixa potencial.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](binary as nullable binary) as nullable number

Sobre
Retorna o número de caracteres.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](binary as binary) as list

Sobre
Converte um valor binário em lista de números.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](binary as nullable binary, optional encoding as nullable number) as nullable text

Sobre
Retorna o resultado da conversão de uma lista binária de números binary em um valor de texto. Opcionalmente,
encoding pode ser especificado para indicar que a codificação a ser usada no valor de texto produzido. Os
seguintes valores BinaryEncoding podem ser usados para encoding .
BinaryEncoding.Base64 : Codificação base 64
[Link] : Codificação hexadecimal
BinaryEncoding.Base64
09/05/2020 • 2 minutes to read

Sobre
Constante a ser usada como o tipo de codificação quando a codificação de Base 64 é necessária.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Constante a ser usada como o tipo de codificação quando a codificação hexadecimal é necessária.
BinaryFormat.7BitEncodedSignedInteger
09/05/2020 • 2 minutes to read

Sintaxe
BinaryFormat.7BitEncodedSignedInteger(binary as binary) as any

Sobre
Um formato binário que lê um inteiro com sinal de 64 bits que foi codificado usando a codificação de tamanho
variável de 7 bits.
BinaryFormat.7BitEncodedUnsignedInteger
09/05/2020 • 2 minutes to read

Sintaxe
BinaryFormat.7BitEncodedUnsignedInteger(binary as binary) as any

Sobre
Um formato binário que lê um inteiro sem sinal de 64 bits que foi codificado usando a codificação de tamanho
variável de 7 bits.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](optional length as any) as function

Sobre
Retorna um formato binário que lê um valor binário. Se length for especificado, o valor binário conterá esse
número de bytes. Se length não for especificado, o valor binário conterá os bytes restantes. O length pode ser
especificado como um número ou como um formato binário do tamanho que precede os dados binários.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](binary as binary) as any

Sobre
Um formato binário que lê um inteiro sem sinal de 8 bits.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](binaryFormat as function, byteOrder as number) as function

Sobre
Retorna um formato binário com a ordem de byte especificada por binaryFormat . A ordem de byte padrão é
[Link] .
[Link]
09/05/2020 • 3 minutes to read

Sintaxe
[Link](binaryFormat as function, chooseFunction as function, optional type as
nullable type, optional combineFunction as nullable function) as function

Sobre
Retorna um formato binário que escolhe o próximo formato binário com base em um valor que já foi lido. O valor
de formato binário produzido por essa função funciona em estágios:
O formato binário especificado pelo parâmetro binaryFormat é usado para ler um valor.
O valor é passado para a função choice especificada pelo parâmetro chooseFunction .
A função choice inspeciona o valor e retorna um segundo formato binário.
O segundo formato binário é usado para ler um segundo valor.
Se a função combine for especificada, o primeiro e o segundo valores serão passados para a função combine e
o valor resultante será retornado.
Se a função combine não for especificada, o segundo valor será retornado.
O segundo valor é retornado.
O parâmetro opcional type indica o tipo de formato binário que será retornado pela função choice. type any ,
type list ou type binary pode ser especificado. Se o parâmetro type não for especificado, type any será usado.
Se type list ou type binary for usado, o sistema poderá retornar um valor binary ou list de streaming, em vez
de um armazenado em buffer, o que pode reduzir a quantidade de memória necessária para ler o formato.

Exemplo 1
Leia uma lista de bytes em que o número de elementos é determinado pelo primeiro byte.

let
binaryData = #binary({2, 3, 4, 5}),
listFormat = [Link](
[Link],
(length) => [Link]([Link], length)
)
in
listFormat(binaryData)

Exemplo 2
Leia uma lista de bytes em que o número de elementos seja determinado pelo primeiro byte e preserve o primeiro
byte lido.
let
binaryData = #binary({2, 3, 4, 5}),
listFormat = [Link](
[Link],
(length) => [Link]([
length = length,
list = [Link]([Link], length)
])
)
in
listFormat(binaryData)

C O M P RIM EN TO 2

L ISTA [Lista]

Exemplo 3
Leia uma lista de bytes em que o número de elementos seja determinado pelo primeiro byte usando uma lista de
fluxo.

let
binaryData = #binary({2, 3, 4, 5}),
listFormat = [Link](
[Link],
(length) => [Link]([Link], length),
type list
)
in
listFormat(binaryData)

4
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](binary as binary) as any

Sobre
Um formato binário que lê um valor decimal de 16 bytes do .NET.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](binary as binary) as any

Sobre
Um formato binário que lê um valor de ponto flutuante de precisão dupla IEEE de 8 bytes.
[Link]
09/05/2020 • 5 minutes to read

Sintaxe
[Link](binaryFormat as function, group as list, optional extra as nullable function,
optional lastKey as any) as function

Sobre
Os parâmetros são os seguintes:
O parâmetro binaryFormat especifica o formato binário do valor de chave.
O parâmetro group fornece informações sobre o grupo de itens conhecidos.
O parâmetro opcional extra pode ser usado para especificar uma função que retornará um valor de formato
binário para o valor após qualquer chave inesperada. Se o parâmetro extra não for especificado, um erro será
gerado se houver valores de chave inesperados.
O parâmetro group especifica uma lista de definições de item. Cada definição de item é uma lista contendo de três a
cinco valores, como segue:
Valor da chave. O valor da chave que corresponde ao item. Deve ser exclusivo dentro do conjunto de itens.
Formato do item. O formato binário correspondente ao valor do item. Isso permite que cada item tenha um
formato diferente.
Ocorrência do item. O valor [Link] para quantas vezes o item deve aparecer no grupo. Os itens
necessários que não estão presentes causam um erro. Itens duplicados necessários ou opcionais são tratados
como valores de chave inesperados.
Valor do item padrão (opcional). Se o valor do item padrão for exibido na lista definição de item e não for nulo,
ele será usado em vez do padrão. O padrão para itens repetidos ou opcionais é NULL e o padrão para valores
repetitivos é uma lista vazia { }.
Transformação de valor de item (opcional). Se a função de transformação valor do item estiver presente na lista
definição de item e não for nula, ela será chamada para transformar o valor do item antes que ele seja
retornado. A função de transformação só será chamada se o item aparecer na entrada (nunca será chamada
com o valor padrão).

Exemplo 1
O seguinte pressupõe um valor de chave que seja um único byte, com quatro itens esperados no grupo, todos com
um byte de dados após a chave. Os itens aparecem na entrada da seguinte maneira:
A chave 1 é necessária e é exibida com o valor 11.
A chave 2 é repetida e aparece duas vezes com o valor 22 e resulta em um valor de { 22, 22 }.
A chave 3 é opcional e não aparece e resulta em um valor de null.
A chave 4 repete-se, mas não aparece, e resulta em um valor de { }.
A chave 5 não faz parte do grupo, mas é exibida uma vez com o valor 55. A função extra é chamada com o valor
de chave 5 e retorna o formato correspondente a esse valor ([Link]). O valor 55 é lido e descartado.
let
b = #binary({
1, 11,
2, 22,
2, 22,
5, 55,
1, 11
}),
f = [Link](
[Link],
{
{1, [Link], [Link]},
{2, [Link], [Link]},
{3, [Link], [Link]},
{4, [Link], [Link]}
},
(extra) => [Link]
)
in
f(b)

11

[Lista]

[Lista]

Exemplo 2
O exemplo a seguir ilustra a transformação de valor de item e o valor de item padrão. O item repetido com a chave
1 soma a lista de valores lidos usando [Link]. O item opcional com a chave 2 tem um valor padrão de 123, em
vez de null.

let
b = #binary({
1, 101,
1, 102
}),
f = [Link](
[Link],
{
{1, [Link], [Link],
0, (list) => [Link](list)},
{2, [Link], [Link], 123}
}
)
in
f(b)

203

123
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](binaryFormat as function, length as any) as function

Sobre
Retorna um formato binário que limita a quantidade de dados que pode ser lida. Tanto [Link] quanto
[Link] podem ser usados para ler até o final dos dados. [Link] pode ser usado para
limitar o número de bytes lidos. O parâmetro binaryFormat especifica o formato binário a ser limitado. O
parâmetro length especifica o número de bytes a serem lidos. O parâmetro length pode ser um valor numérico
ou um valor de formato binário que especifica o formato do valor de comprimento que aparece e que precede o
valor que está sendo lido.

Exemplo 1
Limite o número de bytes lido a 2 ao ler uma lista de bytes.

let
binaryData = #binary({1, 2, 3}),
listFormat = [Link](
[Link]([Link]),
2
)
in
listFormat(binaryData)

Exemplo 2
Limite o número de bytes lidos durante a leitura de uma lista de bytes para o valor de byte anterior na lista.

let
binaryData = #binary({1, 2, 3}),
listFormat = [Link](
[Link]([Link]),
[Link]
)
in
listFormat(binaryData)

2
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](binaryFormat as function, optional countOrCondition as any) as function

Sobre
Retorna um formato binário que lê uma sequência de itens e retorna uma list . O parâmetro binaryFormat
especifica o formato binário de cada item. Há três maneiras de determinar o número de itens lidos:
Se o countOrCondition não for especificado, o formato binário será lido até que não haja mais itens.
Se o countOrCondition for um número, o formato binário lerá aquele número de itens.
Se o countOrCondition for uma função, essa função será invocada para cada item lido. A função retorna true
para continuar e false para interromper a leitura de itens. O item final está incluído na lista.
Se a countOrCondition for um formato binário, a contagem de itens deverá anteceder à lista e o formato
especificado será usado para ler a contagem.

Exemplo 1
Bytes lidos até o fim dos dados.

let
binaryData = #binary({1, 2, 3}),
listFormat = [Link]([Link])
in
listFormat(binaryData)

Exemplo 2
Dois bytes lidos.

let
binaryData = #binary({1, 2, 3}),
listFormat = [Link]([Link], 2)
in
listFormat(binaryData)

1
2

Exemplo 3
Bytes lidos até que o valor de byte seja maior ou igual a dois.

let
binaryData = #binary({1, 2, 3}),
listFormat = [Link]([Link], (x) => x < 2)
in
listFormat(binaryData)

2
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](binary as binary) as any

Sobre
Um formato binário que lê zero bytes e retorna nulo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](record as record) as function

Sobre
Retorna um formato binário que lê um registro. O parâmetro record especifica o formato do registro. Cada
campo do registro pode ter um formato binário diferente. Se um campo contiver um valor que não seja um valor
de formato binário, nenhum dado será lido para esse campo e o valor do campo será ecoado para o resultado.

Exemplo 1
Leia um registro contendo um número inteiro de 16 bits e um número inteiro de 32 bits.

let
binaryData = #binary({
0x00, 0x01,
0x00, 0x00, 0x00, 0x02
}),
recordFormat = [Link]([
A = BinaryFormat.UnsignedInteger16,
B = BinaryFormat.UnsignedInteger32
])
in
recordFormat(binaryData)

A 1

B 2
BinaryFormat.SignedInteger16
09/05/2020 • 2 minutes to read

Sintaxe
BinaryFormat.SignedInteger16(binary as binary) as any

Sobre
Um formato binário que lê um inteiro com sinal de 16 bits.
BinaryFormat.SignedInteger32
09/05/2020 • 2 minutes to read

Sintaxe
BinaryFormat.SignedInteger32(binary as binary) as any

Sobre
Um formato binário que lê um inteiro com sinal de 32 bits.
BinaryFormat.SignedInteger64
09/05/2020 • 2 minutes to read

Sintaxe
BinaryFormat.SignedInteger64(binary as binary) as any

Sobre
Um formato binário que lê um inteiro com sinal de 64 bits.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](binary as binary) as any

Sobre
Um formato binário que lê um valor de ponto flutuante de precisão simples IEEE de 4 bytes.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](length as any, optional encoding as nullable number) as function

Sobre
Retorna um formato binário que lê um valor de texto. O length especifica o número de bytes a serem
decodificados ou o formato binário do comprimento que precede o texto. O valor de encoding opcional especifica
a codificação do texto. Se o encoding não for especificado, a codificação será determinada das marcas de ordem
de byte Unicode. Se nenhuma marca de ordem de byte estiver presente, TextEncoding.Utf8 será usado.

Exemplo 1
Decodifique dois bytes como texto ASCII.

let
binaryData = #binary({65, 66, 67}),
textFormat = [Link](2, [Link])
in
textFormat(binaryData)

"AB"

Exemplo 2
Decodifique o texto ASCII em que o comprimento do texto em bytes aparece antes do texto como um byte.

let
binaryData = #binary({2, 65, 66}),
textFormat = [Link](
[Link],
[Link]
)
in
textFormat(binaryData)

"AB"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](binaryFormat as function, function as function) as function

Sobre
Retorna um formato binário que transformará os valores lidos por outro formato binário. O parâmetro
binaryFormat especifica o formato binário que será usado para ler o valor. O function é invocado com o valor lido
e retorna o valor transformado.

Exemplo 1
Leia um byte e adicione-o a ele.

let
binaryData = #binary({1}),
transformFormat = [Link](
[Link],
(x) => x + 1
)
in
transformFormat(binaryData)

2
BinaryFormat.UnsignedInteger16
09/05/2020 • 2 minutes to read

Sintaxe
BinaryFormat.UnsignedInteger16(binary as binary) as any

Sobre
Um formato binário que lê um inteiro sem sinal de 16 bits.
BinaryFormat.UnsignedInteger32
09/05/2020 • 2 minutes to read

Sintaxe
BinaryFormat.UnsignedInteger32(binary as binary) as any

Sobre
Um formato binário que lê um inteiro sem sinal de 32 bits.
BinaryFormat.UnsignedInteger64
09/05/2020 • 2 minutes to read

Sintaxe
BinaryFormat.UnsignedInteger64(binary as binary) as any

Sobre
Um formato binário que lê um inteiro sem sinal de 64 bits.
[Link]
09/05/2020 • 2 minutes to read

Sobre
O item não deverá aparecer nenhuma vez ou deverá aparecer uma vez na entrada.
[Link]
09/05/2020 • 2 minutes to read

Sobre
O item não deverá aparecer nenhuma vez ou deverá aparecer mais vezes na entrada.
[Link]
09/05/2020 • 2 minutes to read

Sobre
O item deverá aparecer uma vez na entrada.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um valor possível para o parâmetro byteOrder em [Link] . O byte mais significativo aparece
primeiro na ordem de byte big endian.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um valor possível para o parâmetro byteOrder em [Link] . O byte menos significativo aparece
primeiro na ordem de byte little endian.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Os dados compactados estão no formato 'Deflate'.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Os dados compactados estão no formato 'GZip'.
[Link]
09/05/2020 • 2 minutes to read

Sobre
O item não deverá aparecer nenhuma vez ou deverá aparecer uma vez na entrada.
[Link]
09/05/2020 • 2 minutes to read

Sobre
O item não deverá aparecer nenhuma vez ou deverá aparecer mais vezes na entrada.
[Link]
09/05/2020 • 2 minutes to read

Sobre
O item deverá aparecer uma vez na entrada.
#binary
09/05/2020 • 2 minutes to read

Sintaxe
#binary(value as any) as any

Sobre
Cria um valor binário usando uma lista de números ou um valor de texto codificado em base 64.

Exemplo 1
Criar um valor binário usando uma lista de números.

#binary({0x30, 0x31, 0x32})

[Link]("012")

Exemplo 2
Criar um valor binário usando um valor de texto codificado em base 64.

#binary("1011")

[Link]("1011", BinaryEncoding.Base64)
Funções de combinação
08/05/2020 • 2 minutes to read

Essas funções são usadas por outras funções de biblioteca que mesclam valores. Por exemplo, [Link] e
[Link] aplicam uma função de combinação a cada linha em uma tabela para produzir um valor
único para cada linha.

Combinador
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna uma função que combina uma lista de texto em texto
único usando os delimitadores especificados.

[Link] Retorna uma função que combina uma lista de texto em texto
único usando cada delimitador especificado na sequência.

[Link] Retorna uma função que combina uma lista de texto em texto
único usando os tamanhos especificados.

[Link] Retorna uma função que combina uma lista de texto em texto
único usando as posições especificadas.

[Link] Retorna uma função que combina uma lista de texto em texto
único usando as posições e os tamanhos especificados.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](delimiter as text, optional quoteStyle as nullable number) as
function

Sobre
Retorna uma função que combina uma lista de texto em texto único usando os delimitadores especificados.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](delimiters as list, optional quoteStyle as nullable number) as
function

Sobre
Retorna uma função que combina uma lista de texto em texto único usando cada delimitador especificado na
sequência.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](lengths as list, optional template as nullable text) as function

Sobre
Retorna uma função que combina uma lista de texto em texto único usando os tamanhos especificados.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](positions as list, optional template as nullable text) as function

Sobre
Retorna uma função que combina uma lista de texto em texto único usando as posições especificadas.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](ranges as list, optional template as nullable text) as function

Sobre
Retorna uma função que combina uma lista de texto em texto único usando as posições e os tamanhos
especificados.
Funções de comparação
08/05/2020 • 2 minutes to read

Essas funções testam a igualdade e determinam a ordem.

Comparador
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna um valor lógico baseado na verificação de igualdade


sobre os dois valores fornecidos.

[Link] Retorna uma função de comparador, dada a cultura e um valor


lógico para diferenciação de maiúsculas e minúsculas para a
comparação. O valor padrão para ignoreCase é false. O valor
de cultura são representações de texto conhecidas de
localidades usadas no .NET Framework.

[Link] Retorna uma função de comparador que usa regras do


Ordinal para comparar valores.

[Link] Retorna uma função de comparador sem diferenciação de


maiúsculas e minúsculas que usa regras Ordinais para
comprar os valores fornecidos x e y.

[Link] Retorna a cultura atual do sistema.


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](comparer as function, x as any, y as any) as logical

Sobre
Retorna um valor logical com base na verificação de igualdade sobre os dois valores especificados, x e y ,
usando o comparer especificado.
comparer é um Comparer usado para controlar a comparação. Os comparadores podem ser usados para fornecer
comparações com detecção de localidade e cultura ou sem diferenciação de maiúsculas e minúsculas.
Os seguintes comparadores internos estão disponíveis na linguagem da fórmula:
[Link] : Usado para executar uma comparação ordinal exata
[Link] : Usado para executar uma comparação ordinal exata sem diferenciação de
maiúsculas e minúsculas
[Link] : Usado para executar uma comparação com detecção de cultura

Exemplo 1
Comparar "1" e "A" usando a localidade "pt-BR" para determinar se os valores são iguais.

[Link]([Link]("en-us"), "1", "A")

false
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](culture as text, optional ignoreCase as nullable logical) as function

Sobre
Retorna uma função de comparador, dada a culture e um valor lógico ignoreCase para diferenciação de
maiúsculas e minúsculas para a comparação. O valor padrão para ignoreCase é false. O valor de cultura são
representações de texto conhecidas de localidades usadas no .NET Framework.

Exemplo 1
Comparar "a" e "A" usando a localidade "pt-BR" para determinar se os valores são iguais.

[Link]("en-us")("a", "A")

-1

Exemplo 2
Comparar "a" e "A" usando a localidade "pt-BR", ignorando maiúsculas e minúsculas, para determinar se os valores
são iguais.

[Link]("en-us", true)("a", "A")

0
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](x as any, y as any) as number

Sobre
Retorna uma função de comparador que usa regras Ordinais para comparar os valores x e y fornecidos.

Exemplo 1
Usando regras Ordinais, compare se "encyclopædia" e "encyclopaedia" são equivalentes. Observe que elas são
equivalentes usando [Link]("en-us") .

[Link]([Link], "encyclopædia", "encyclopaedia")

false
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](x as any, y as any) as number

Sobre
Retorna uma função de comparador sem diferenciação de maiúsculas e minúsculas que usa regras Ordinais para
comprar os valores fornecidos x e y .

Exemplo
Usando regras ordinais que não diferenciam maiúsculas de minúsculas, compare "Abc" com "abc". Observação:
"Abc" é menor que "abc" usando [Link] .

[Link]("Abc", "abc")

0
[Link]
09/05/2020 • 2 minutes to read

Sobre
Retorna o nome da cultura atual do aplicativo.
Funções de data
08/05/2020 • 11 minutes to read

Essas funções criam e manipulam o componente de data dos valores date, datetime e datetimezone.

Date
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna um valor de Date/DateTime/DateTimeZone com a


parte de dia incrementada pelo número de dias fornecido.
Também cuida do incremento das partes de mês e ano do
valor, conforme apropriado.

[Link] Retorna um valor de DateTime com a parte de mês


incrementada por n meses.

[Link] Retorna um valor de Date/DateTime/DateTimeZone


incrementado pelo número de trimestres fornecido. Cada
trimestre é definido como uma duração de três meses.
Também cuida do incremento da parte de ano do valor,
conforme apropriado.

[Link] Retorna um valor de Date/DateTime/DateTimeZone


incrementado pelo número de semanas fornecido. Cada
semana é definida como uma duração de sete dias. Também
cuida do incremento das partes de mês e ano do valor,
conforme apropriado.

[Link] Retorna um valor de DateTime com a parte de ano


incrementada por n anos.

[Link] Retorna o dia de um valor de DateTime.

[Link] Retorna um número (de 0 a 6) que indica o dia da semana do


valor fornecido.

[Link] Retorna o nome do dia da semana.

[Link] Retorna um número que representa o dia do ano de um valor


de DateTime.

[Link] Retorna o número de dias no mês de um valor de DateTime.

[Link] Retorna um valor de DateTime para o final do dia.

[Link] Retorna um valor de DateTime para o final do mês.

[Link] Retorna um valor de Date/DateTime/DateTimeZone que


representa o final do trimestre. As partes de data e hora são
redefinidas para os valores de término para o trimestre. As
informações de fuso horário são persistidas.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna um valor de DateTime para o fim da semana.

[Link] Retorna um valor de DateTime para o final do ano.

[Link] Retorna um valor de data com base em um valor.

[Link] Retorna um valor de Date de um conjunto de formatos de


data e valor de cultura.

[Link] Indica se o valor de datetime dateTime especificado ocorre


durante o dia atual, conforme determinado pela data e pela
hora atuais do sistema.

[Link] Retorna um valor lógico que indica se o


Date/DateTime/DateTimeZone especificado ocorreu durante o
mês atual, conforme determinado pela data e pela hora atuais
do sistema.

[Link] Retorna um valor lógico que indica se o


Date/DateTime/DateTimeZone especificado ocorreu durante o
trimestre atual, conforme determinado pela data e pela hora
atuais do sistema.

[Link] Retorna um valor lógico que indica se o


Date/DateTime/DateTimeZone especificado ocorreu durante a
semana atual, conforme determinado pela data e pela hora
atuais do sistema.

[Link] Retorna um valor lógico que indica se o


Date/DateTime/DateTimeZone especificado ocorreu durante o
ano atual, conforme determinado pela data e pela hora atuais
do sistema.

[Link] Indica se o valor de datetime especificado dateTime ocorre


durante o dia seguinte, conforme determinado pela data e
pela hora atuais do sistema.

[Link] Retorna um valor lógico que indica se o


Date/DateTime/DateTimeZone especificado ocorreu durante o
mês seguinte, conforme determinado pela data e pela hora
atuais do sistema.

[Link] Indica se o valor de datetime especificado dateTime ocorre


durante o próximo número de dias, conforme determinado
pela data e pela hora atuais do sistema.

[Link] Indica se o valor de datetime especificado dateTime ocorre


durante o próximo número de meses, conforme determinado
pela data e pela hora atuais do sistema.

[Link] Indica se o valor de datetime especificado dateTime ocorre


durante o próximo número de trimestres, conforme
determinado pela data e pela hora atuais do sistema.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Indica se o valor de datetime especificado dateTime ocorre


durante o próximo número de semanas, conforme
determinado pela data e pela hora atuais do sistema.

[Link] Indica se o valor de datetime especificado dateTime ocorre


durante o próximo número de anos, conforme determinado
pela data e pela hora atuais do sistema.

[Link] Retorna um valor lógico que indica se o


Date/DateTime/DateTimeZone especificado ocorreu durante o
próximo trimestre, conforme determinado pela data e pela
hora atuais do sistema.

[Link] Retorna um valor lógico que indica se o


Date/DateTime/DateTimeZone especificado ocorreu durante a
próxima semana, conforme determinado pela data e pela hora
atuais do sistema.

[Link] Retorna um valor lógico que indica se o


Date/DateTime/DateTimeZone especificado ocorreu durante o
ano seguinte, conforme determinado pela data e pela hora
atuais do sistema.

[Link] Indica se o valor de datetime especificado dateTime ocorre


durante o dia anterior, conforme determinado pela data e pela
hora atuais do sistema.

[Link] Retorna um valor lógico que indica se o


Date/DateTime/DateTimeZone especificado ocorreu durante o
mês anterior, conforme determinado pela data e pela hora
atuais do sistema.

[Link] Indica se o valor de datetime especificado dateTime ocorre


durante o número anterior de dias, conforme determinado
pela data e pela hora atuais do sistema.

[Link] Indica se o valor de datetime especificado dateTime ocorre


durante o número anterior de meses, conforme determinado
pela data e pela hora atuais do sistema.

[Link] Indica se o valor de datetime especificado dateTime ocorre


durante o número anterior de trimestres, conforme
determinado pela data e pela hora atuais do sistema.

[Link] Indica se o valor de datetime especificado dateTime ocorre


durante o número anterior de semanas, conforme
determinado pela data e pela hora atuais do sistema.

[Link] Indica se o valor de datetime especificado dateTime ocorre


durante o número anterior de anos, conforme determinado
pela data e pela hora atuais do sistema.

[Link] Retorna um valor lógico que indica se o


Date/DateTime/DateTimeZone especificado ocorreu durante o
trimestre anterior, conforme determinado pela data e pela
hora atuais do sistema.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna um valor lógico que indica se o


Date/DateTime/DateTimeZone especificado ocorreu durante a
semana anterior, conforme determinado pela data e pela hora
atuais do sistema.

[Link] Retorna um valor lógico que indica se o


Date/DateTime/DateTimeZone especificado ocorreu durante o
ano anterior, conforme determinado pela data e pela hora
atuais do sistema.

[Link] Retorna um valor lógico que indica se o


Date/DateTime/DateTimeZone especificado ocorreu no
período que começa em 1º de janeiro do ano atual e termina
no dia atual, conforme determinado pela data e pela hora
atuais do sistema.

[Link] Retorna um valor lógico que indica se a parte de ano de um


valor de DateTime é um ano bissexto.

[Link] Retorna o mês de um valor de DateTime.

[Link] Retorna o componente do nome do mês.

[Link] Retorna um número entre 1 e 4 para o trimestre do ano de


um valor de DateTime.

[Link] Retorna um valor de DateTime para o início do dia.

[Link] Retorna um valor de DateTime que representa o início do mês.

[Link] Retorna um valor de DateTime que representa o início do


trimestre.

[Link] Retorna um valor de DateTime que representa o início da


semana.

[Link] Retorna um valor de DateTime que representa o início do ano.

[Link] Retorna um registro que contém partes de valor de Date.

[Link] Retorna um valor de texto de um valor de Date.

[Link] Retorna um número para a contagem da semana no mês


atual.

[Link] Retorna um número para a contagem da semana no ano


atual.

[Link] Retorna o ano de um valor de DateTime.

#date Cria um valor de data do ano, do mês e do dia.


VA LO RES DE PA RÂ M ET RO S DESC RIÇ Ã O

[Link] Representa o domingo.

[Link] Representa a segunda-feira.

[Link] Representa a terça-feira.

[Link] Representa a quarta-feira.

[Link] Representa a quinta-feira.

[Link] Representa a sexta-feira.

[Link] Representa o sábado.


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, numberOfDays as number) as any

Sobre
Retorna o resultado date , datetime ou datetimezone de adicionar numberOfDays dias ao valor datetime .,
dateTime .

dateTime : O valor date , datetime ou datetimezone ao qual os dias estão sendo adicionado.
numberOfDays : O número de dias a serem adicionados.

Exemplo 1
Adicione cinco dias ao valor date , datetime ou datetimezone que representa a data 14/05/2011.

[Link](#date(2011, 5, 14), 5)

#date(2011, 5, 19)
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, numberOfMonths as number) as any

Sobre
Retorna o resultado date , datetime ou datetimezone de adicionar numberOfMonths meses ao valor datetime ,
dateTime .

dateTime : O valor date , datetime ou datetimezone ao qual os meses estão sendo adicionado.
numberOfMonths : O número de meses a serem adicionados.

Exemplo 1
Adicione cinco meses ao valor date , datetime ou datetimezone que representa a data 14/05/2011.

[Link](#date(2011, 5, 14), 5)

#date(2011, 10, 14)

Exemplo 2
Adicione 18 meses ao valor date , datetime ou datetimezone que representa a data e a hora de 14/05/2011
08:15:22 AM.

[Link](#datetime(2011, 5, 14, 8, 15, 22), 18)

#datetime(2012, 11, 14, 8, 15, 22)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, numberOfQuarters as number) as any

Sobre
Retorna o resultado date , datetime ou datetimezone de adicionar numberOfQuarters trimestres ao valor
datetime ., dateTime .

dateTime : O valor date , datetime ou datetimezone ao qual os trimestres estão sendo adicionado.
numberOfQuarters : O número de trimestres a serem adicionados.

Exemplo 1
Adicione um trimestre ao valor date , datetime ou datetimezone que representa a data 14/05/2011.

[Link](#date(2011, 5, 14), 1)

#date(2011, 8, 14)
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, numberOfWeeks as number) as any

Sobre
Retorna o resultado date , datetime ou datetimezone de adicionar numberOfWeeks semanas ao valor datetime .,
dateTime .

dateTime : O valor date , datetime ou datetimezone ao qual as semanas estão sendo adicionadas.
numberOfWeeks : O número de semanas a serem adicionadas.

Exemplo 1
Adicione duas semanas ao valor date , datetime ou datetimezone que representa a data 14/05/2011.

[Link](#date(2011, 5, 14), 2)

#date(2011, 5, 28)
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, numberOfYears as number) as any

Sobre
Retorna o resultado date , datetime ou datetimezone da adição de numberOfYears a um valor datetime ,
dateTime .

dateTime : O valor date , datetime ou datetimezone ao qual os anos são adicionados.


numberOfYears : O número de anos a serem adicionados.

Exemplo 1
Adicione quatro anos ao valor date , datetime ou datetimezone que representa a data 14/05/2011.

[Link](#date(2011, 5, 14), 4)

#date(2015, 5, 14)

Exemplo 2
Adicione 10 anos ao valor date , datetime ou datetimezone que representa a data e a hora de 14/05/2011
08:15:22 AM.

[Link](#datetime(2011, 5, 14, 8, 15, 22), 10)

#datetime(2021, 5, 14, 8, 15, 22)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable number

Sobre
Retorna o componente de dia de um valor date , datetime ou datetimezone .
dateTime : Um valor date , datetime ou datetimezone do qual o componente de dia é extraído.

Exemplo 1
Obtém o componente de dia de um valor date , datetime ou datetimezone que representa a data e a hora de 14/-
5/2011 05:00:00 PM.

[Link](#datetime(2011, 5, 14, 17, 0, 0))

14
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, optional firstDayOfWeek as nullable number) as nullable number

Sobre
Retorna um número (de 0 a 6) que indica o dia da semana do dateTime fornecido.
dateTime : Um valor date , datetime ou datetimezone .
firstDayOfWeek : Um valor Day indicando qual dia deve ser considerado o primeiro dia da semana. Os valores
permitidos são [Link], [Link], [Link], [Link], [Link], [Link] ou
[Link]. Se não for especificado, um padrão dependente de cultura será usado.

Exemplo 1
Obter o dia da semana representado por segunda-feira, 21 de fevereiro de 2011, tratando o domingo como o
primeiro dia da semana.

[Link](#date(2011, 02, 21), [Link])`

Exemplo 2
Obter o dia da semana representado por segunda-feira, 21 de fevereiro de 2011, tratando a segunda-feira como o
primeiro dia da semana.

[Link](#date(2011, 02, 21), [Link])

0
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](date as any, optional culture as nullable text)

Sobre
Retorna o nome do dia da semana para a date fornecida. Uma culture opcional também pode ser fornecida (por
exemplo, "pt-BR").

Exemplo 1
Obtenha o nome do dia da semana.

[Link](#date(2011, 12, 31), "en-US")

"Saturday"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable number

Sobre
Retorna um número que representa o dia do ano no valor date , datetime ou datetimezone fornecido, dateTime .

Exemplo 1
O número do dia 1º de março de 2011 ( #date(2011, 03, 01) ).

[Link](#date(2011, 03, 01))

60
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable number

Sobre
Retorna o número de dias do mês no valor de dateTime de date , datetime ou datetimezone .
dateTime : Um valor date , datetime ou datetimezone para o qual o número de dias do mês é retornado.

Exemplo 1
Número de dias do mês de dezembro, conforme representado por #date(2011, 12, 01) .

[Link](#date(2011, 12, 01))

31
[Link]
09/05/2020 • 2 minutes to read

[Link](dateTime as any) as any

Sobre
Retorna um valor date , datetime ou datetimezone que representa o fim do dia em dateTime . As informações de
fuso horário são preservadas.
dateTime : Um valor date , datetime ou datetimezone do qual o fim do dia é calculado.

Exemplo 1
Obtenha o fim do dia de 14/5/2011 05:00: 00 PM.

[Link](#datetime(2011, 5, 14, 17, 0, 0))

#datetime(2011, 5, 14, 23, 59, 59.9999999)

Exemplo 2
Obtenha o fim do dia de 17/5/2011 05:00: 00 PM -7:00.

[Link](#datetimezone(2011, 5, 17, 5, 0, 0, -7, 0))

#datetimezone(2011, 5, 17, 23, 59, 59.9999999, -7, 0)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as any

Sobre
Retorna o último dia do mês em dateTime .
dateTime : Um valor date , datetime ou datetimezone do qual o fim do mês é calculado

Exemplo 1
Obter o fim do mês de 14/5/2011.

[Link](#date(2011, 5, 14))

#date(2011, 5, 31)

Exemplo 2
Obter o fim do mês de 17/5/2011 17h – 7:00.

[Link](#datetimezone(2011, 5, 17, 5, 0, 0, -7, 0))

#datetimezone(2011, 5, 31, 23, 59, 59.9999999, -7, 0)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as any

Sobre
Retorna um valor date , datetime ou datetimezone que representa o fim do trimestre em dateTime . As
informações de fuso horário são preservadas.
dateTime : Um valor date , datetime ou datetimezone do qual o fim do trimestre é calculado.

Exemplo 1
Localizar o fim do trimestre de 10 de outubro de 2011, 8:00 AM ( #datetime(2011, 10, 10, 8, 0, 0) ).

[Link](#datetime(2011, 10, 10, 8, 0, 0))

#datetime(2011, 12, 31, 23, 59, 59.9999999)


[Link]
12/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, optional firstDayOfWeek as nullable number) as any

Sobre
Retorna o último dia da semana em date , datetime ou datetimezone``dateTime fornecido. Essa função usa um
Day opcional, firstDayOfWeek , para definir o primeiro dia da semana para esse cálculo relativo. O valor padrão é
[Link] .

dateTime : Um valor date , datetime ou datetimezone com base no qual o último dia da semana é calculado
firstDayOfWeek : [Opcional] Um valor [Link] que representa o primeiro dia da semana. Os valores possíveis
são [Link] , [Link] , [Link] , [Link] , [Link] , [Link] e [Link]. . O
valor padrão é [Link] .

Exemplo 1
Obter o fim da semana de 14/5/2011.

[Link](#date(2011, 5, 14))

#date(2011, 5, 14)

Exemplo 2
Obter o fim da semana de 17/5/2011 17h – 7h, considerando o domingo como primeiro dia da semana.

[Link](#datetimezone(2011, 5, 17, 5, 0, 0, -7, 0), [Link])

#datetimezone(2011, 5, 21, 23, 59, 59.9999999, -7, 0)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as any

Sobre
Retorna um valor que representa o fim do ano em dateTime , incluindo segundos fracionários. As informações de
fuso horário são preservadas.
dateTime : Um valor date , datetime ou datetimezone do qual o fim do ano é calculado.

Exemplo 1
Obtenha o fim do ano de 14/5/2011 05:00: 00 PM.

[Link](#datetime(2011, 5, 14, 17, 0, 0))

#datetime(2011, 12, 31, 23, 59, 59.9999999)

Exemplo 2
Obtenha o fim da hora de 17/5/2011 05:00: 00 PM -7:00.

[Link](#datetimezone(2011, 5, 17, 5, 0, 0, -7, 0))

#datetimezone(2011, 12, 31, 23, 59, 59.9999999, -7, 0)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional culture as nullable text) as nullable date

Sobre
Retorna um valor date do value especificado. Uma culture opcional também pode ser fornecida (por exemplo,
"pt-BR"). Se o value fornecido for null , [Link] retornará null . Se o value fornecido for date , value será
retornado. Os valores dos seguintes tipos podem ser convertidos em um valor date :
text : Um valor date da representação textual. Confira [Link] para obter detalhes.
datetime : O componente de data do value .
datetimezone : O componente de data do equivalente de datetime local de value .
number : O componente de data do equivalente de datetime da Data de Automação OLE expresso por value .
Se value for de qualquer outro tipo, um erro será retornado.

Exemplo 1
Converter 43910 em um valor date .

[Link](43910)

#date(2020, 3, 20)

Exemplo 2
Converter #datetime(1899, 12, 30, 06, 45, 12) em um valor date .

[Link](#datetime(1899, 12, 30, 06, 45, 12))

#date(1899, 12, 30)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, optional culture as nullable text) as nullable date

Sobre
Cria um valor de date com base em uma representação textual, text , seguindo o padrão de formato ISO 8601.
Uma culture opcional também pode ser fornecida (por exemplo, "pt-BR").
[Link]("2010-02-19") // Data, aaaa-MM-dd

Exemplo 1
Converter "December 31, 2010" em um valor de data.

[Link]("2010-12-31")

#date(2010, 12, 31)

Exemplo 2
Converter "December 31, 2010" em um valor de data, com um formato diferente

[Link]("2010, 12, 31")

#date(2010, 12, 31)

Exemplo 3
Converter "December, 2010" em um valor de data.

[Link]("2010, 12")

#date(2010, 12, 1)

Exemplo 4
Converter "2010" em um valor de data.

[Link]("2010")

#date(2010, 1, 1)
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o dia atual, conforme determinado pela data e
pela hora atuais do sistema.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.

Exemplo
Determine se a hora atual do sistema ocorre no dia atual.

[Link]([Link]())

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o mês atual, conforme determinado pela data
e pela hora atuais do sistema.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.

Exemplo 1
Determinar se a hora atual do sistema ocorre no mês atual.

[Link]([Link]())

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o trimestre atual, conforme determinado pela
data e pela hora atuais do sistema.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.

Exemplo 1
Determine se a hora atual do sistema ocorre no trimestre atual.

[Link]([Link]())

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante a semana atual, conforme determinado pela
data e pela hora atuais do sistema.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.

Exemplo 1
Determinar se a hora atual do sistema ocorre na semana atual.

[Link]([Link]())

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o ano atual, conforme determinado pela data e
pela hora atuais do sistema.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.

Exemplo 1
Determine se a hora atual do sistema ocorre no ano atual.

[Link]([Link]())

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o dia seguinte, conforme determinado pela
data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um valor que ocorre
no dia atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.

Exemplo 1
Determinar se o dia após a hora atual do sistema ocorre no dia seguinte.

[Link]([Link]([Link](), 1))

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o próximo mês, conforme determinado pela
data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um valor que ocorre
no mês atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.

Exemplo 1
Determine se o mês após a hora atual do sistema é o mês seguinte.

[Link]([Link]([Link](), 1))

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, days as number) as nullable logical

Sobre
Indica se o valor dateTime de datetime especificado ocorre durante o próximo número de dias, conforme
determinado pela data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um
valor que ocorre no dia atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.
days : O número de dias.

Exemplo 1
Determina se o dia após a hora atual do sistema é nos próximos dois dias.

[Link]([Link]([Link](), 1), 2)

true
[Link]
09/05/2020 • 2 minutes to read

[Link](dateTime as any, months as number) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o próximo número de meses, conforme
determinado pela data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um
valor que ocorre no mês atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.
months : O número de meses.

Exemplo 1
Determina se o mês após a hora atual do sistema é nos próximos dois meses.

[Link]([Link]([Link](), 1), 2)

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, quarters as number) as nullable logical

Sobre
Indica se o valor dateTime de datetime especificado ocorre durante o próximo número de trimestres, conforme
determinado pela data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um
valor ocorrido dentro do trimestre atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.
quarters : O número de trimestres.

Exemplo 1
Determine se o trimestre após a hora atual do sistema é nos próximos dois trimestres.

[Link]([Link]([Link](), 1), 2)

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, weeks as number) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o próximo número de semanas, conforme
determinado pela data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um
valor que ocorre na semana atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.
weeks : O número de semanas.

Exemplo 1
Determina se o semana após a hora atual do sistema é nas próximas duas semanas.

[Link]([Link]([Link](), 7), 2)

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, years as number) as nullable logical

Sobre
Indica se o valor dateTime de datetime especificado ocorre durante o próximo número de anos, conforme
determinado pela data e pela hora atuais do sistema. Observe que essa função retornará falso quando receber um
valor que ocorre no ano atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.
years : O número de anos.

Exemplo 1
Determina se o ano após a hora atual do sistema é nos próximos dois anos.

[Link]([Link]([Link](), 1), 2)

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o próximo trimestre, conforme determinado
pela data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um valor
ocorrido dentro do trimestre atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.
####Exemplo 1 Determine se o trimestre após a hora atual do sistema é o próximo trimestre.

[Link]([Link]([Link](), 1))

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante a semana a seguir, conforme determinado pela
data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um valor que ocorre
na semana atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.

Exemplo 1
Determine se a semana após a hora atual do sistema é a semana seguinte.

[Link]([Link]([Link](), 7))

true
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o próximo ano, conforme determinado pela
data e pela hora atuais do sistema. Observe que essa função retornará falso quando receber um valor que ocorre
no ano atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.

Exemplo 1
Determine se o ano após a hora atual do sistema é o ano seguinte.

[Link]([Link]([Link](), 1))

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime especificado dateTime ocorre durante o dia anterior, conforme determinado pela data
e pela hora atuais do sistema. Observe que essa função retornará false quando receber um valor que ocorre no dia
atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.

Exemplo 1
Determine se o dia antes da hora atual do sistema é o dia anterior.

[Link]([Link]([Link](), -1))

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o mês anterior, conforme determinado pela
data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um valor que ocorre
no mês atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.

Exemplo 1
Determine se o mês antes da hora atual do sistema é o mês anterior.

[Link]([Link]([Link](), -1))

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, days as number) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o número anterior de dias, conforme
determinado pela data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um
valor que ocorre no dia atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.
days : O número de dias.

Exemplo 1
Determina se o dia anterior à hora atual do sistema é nos dois dias anteriores.

[Link]([Link]([Link](), -1), 2)

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, months as number) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o número anterior de meses, conforme
determinado pela data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um
valor que ocorre no mês atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.
months : O número de meses.

Exemplo 1
Determina se o mês anterior à hora atual do sistema ocorre nos dois meses anteriores.

[Link]([Link]([Link](), -1), 2)

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, quarters as number) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o número anterior de trimestres, conforme
determinado pela data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um
valor ocorrido dentro do trimestre atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.
quarters : O número de trimestres.

Exemplo 1
Determina se o trimestre anterior à hora atual do sistema é nos dois trimestres anteriores.

[Link]([Link]([Link](), -1), 2)

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, weeks as number) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o número anterior de semanas, conforme
determinado pela data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um
valor que ocorre na semana atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.
weeks : O número de semanas.

Exemplo 1
Determinar se a semana anterior à hora atual do sistema ocorre nas duas semanas anteriores.

[Link]([Link]([Link](), -7), 2)

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, years as number) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o número anterior de anos, conforme
determinado pela data e pela hora atuais do sistema. Observe que essa função retornará falso quando receber um
valor que ocorre no ano atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.
years : O número de anos.

Exemplo 1
Determina se o ano anterior à hora atual do sistema é nos dois anos anteriores.

[Link]([Link]([Link](), -1), 2)

true
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o trimestre anterior, conforme determinado
pela data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um valor
ocorrido dentro do trimestre atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.

Exemplo 1
Determine se o trimestre anterior à hora atual do sistema ocorre no trimestre anterior.

[Link]([Link]([Link](), -1))

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante a semana anterior, conforme determinado pela
data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um valor que ocorre
na semana atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.

Exemplo 1
Determine se a semana antes da hora atual do sistema é a semana anterior.

[Link]([Link]([Link](), -7))

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o ano anterior, conforme determinado pela
data e pela hora atuais do sistema. Observe que essa função retornará falso quando receber um valor que ocorre
no ano atual.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.

Exemplo 1
Determinar se o ano anterior à hora atual do sistema ocorre no ano anterior.

[Link]([Link]([Link](), -1))

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o ano atual e se ocorre no dia atual ou antes
dele, conforme determinado pela data e pela hora atuais do sistema.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.

Exemplo 1
Determine se a hora atual do sistema ocorre desde o início do ano.

[Link]([Link]())

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado cai em um ano bissexto.
dateTime : Um valor date , datetime ou datetimezone a ser avaliado.

Exemplo 1
Determina se o ano de 2012, conforme representado por #date(2012, 01, 01) , é um ano bissexto.

[Link](#date(2012, 01, 01))

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable number

Sobre
Retorna o componente de mês do valor datetime fornecido, dateTime .

Exemplo 1
Localize o mês em #datetime (2011, 12, 31, 9, 15, 36).

[Link](#datetime(2011, 12, 31, 9, 15, 36))

12
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](date as any, optional culture as nullable text) as nullable text

Sobre
Retorna o nome do componente de mês para a date fornecida. Uma culture opcional também pode ser
fornecida (por exemplo, "pt-BR").

Exemplo
Obter o nome do mês.

[Link](#datetime(2011, 12, 31, 5, 0, 0), "en-US")

"December"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable number

Sobre
Retorna um número de 1 a 4 que indica em qual trimestre do ano a data dateTime cairá. dateTime pode ser um
valor date , datetime ou datetimezone .

Exemplo 1
Localize em qual trimestre do ano a data #date(2011, 12, 31) cairá.

[Link](#date(2011, 12, 31))

4
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as any

Sobre
Retorna o primeiro valor do dia dateTime . dateTime precisa ser um valor date , datetime ou datetimezone .

Exemplo 1
Localizar o início do dia de 10 de outubro de 2011, 8h ( #datetime(2011, 10, 10, 8, 0, 0) ).

[Link](#datetime(2011, 10, 10, 8, 0, 0))

#datetime(2011, 10, 10, 0, 0, 0)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as any

Sobre
Retorna o primeiro valor do mês, considerando um tipo date ou datetime .

Exemplo 1
Localizar o início do mês de 10 de outubro de 2011, 8h10min32 ( #datetime(2011, 10, 10, 8, 10, 32) ).

[Link](#datetime(2011, 10, 10, 8, 10, 32))

#datetime(2011, 10, 1, 0, 0, 0)
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as any

Sobre
Retorna o primeiro valor do trimestre < dateTime . dateTime precisa ser um valor date , datetime ou
datetimezone .

Exemplo 1
Localizar o início do trimestre de 10 de outubro de 2011, 8h ( #datetime(2011, 10, 10, 8, 0, 0) ).

[Link](#datetime(2011, 10, 10, 8, 0, 0))

#datetime(2011, 10, 1, 0, 0, 0)
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, optional firstDayOfWeek as nullable number) as any

Sobre
Retorna o primeiro valor da semana, considerando um valor date , datetime ou datetimezone .

Exemplo 1
Localizar o início da semana de 10 de outubro de 2011, 8h10min32 ( #datetime(2011, 10, 10, 8, 10, 32) ).

[Link](#datetime(2011, 10, 10, 8, 10, 32))

#datetime(2011, 10, 9, 0, 0, 0)
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as any

Sobre
Retorna o primeiro valor do ano, considerando um valor date , datetime ou datetimezone .

Exemplo 1
Localize o início do ano para 10 de outubro de 2011, 8h10min32 ( #datetime(2011, 10, 10, 8, 10, 32) ).

[Link](#datetime(2011, 10, 10, 8, 10, 32))

#datetime(2011, 1, 1, 0, 0, 0)
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](date as date) as record

Sobre
Retorna um registro que contém as partes do valor de data especificado, date .
date : Um valor date com base no qual o registro das partes deve ser calculado.

Exemplo 1
Converter o valor de #date(2011, 12, 31) em um registro contendo partes do valor de data.

[Link](#date(2011, 12, 31))

ANO 2011

M ÊS 12

DIA 31
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](date as nullable date, optional format as nullable text, optional culture as nullable
text) as nullable text

Sobre
Retorna uma representação textual de date , o valor de Data, date . Essa função usa um parâmetro de formato
opcional format . Para obter uma lista completa dos formatos compatíveis, confira o documento de especificação
da biblioteca. Uma culture opcional também pode ser fornecida (por exemplo, "pt-BR").

Exemplo 1
Obtenha uma representação textual #date(2010, 12, 31).

[Link](#date(2010, 12, 31))

"12/31/2010"

Exemplo 2
Obtenha uma representação textual de #date(2010, 12, 31) com opção de formato.

[Link](#date(2010, 12, 31), "yyyy/MM/dd")

"2010/12/31"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, optional firstDayOfWeek as nullable number) as nullable number

Sobre
Retorna um número de 1 a 5 que indica em qual semana do ano e do mês a data dateTime cai.
dateTime : Um valor datetime para o qual a semana do mês é determinada.

Exemplo 1
Determinar em qual semana o dia 15 de março cai em 2011 ( #date(2011, 03, 15) ).

[Link](#date(2011, 03, 15))

3
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, optional firstDayOfWeek as nullable number) as nullable number

Sobre
Retorna um número de 1 a 54 que indica em qual semana do ano a data, dateTime , cairá.
dateTime : Um valor datetime em que a semana do ano é determinada.
firstDayOfWeek: Um valor de [Link] opcional que indica qual dia é considerado o início de uma nova
semana (por exemplo, [Link] . Se não for especificado, um padrão dependente de cultura será usado.

Exemplo 1
Determina em qual semana do ano 27 de março cairá em 2011 ( #date(2011, 03, 27) ).

[Link](#date(2011, 03, 27))

14

Exemplo 2
Determina em qual semana do ano 27 de março cairá em 2011 ( #date(2011, 03, 27) ), usando a segunda-feira
como o início de uma nova semana.

[Link](#date(2011, 03, 27), [Link])

13
[Link]
09/05/2020 • 2 minutes to read

[Link](dateTime as any) as nullable number

Sobre
Retorna o componente de ano do valor datetime fornecido, dateTime .

Exemplo 1
Localizar o ano em #datetime(2011, 12, 31, 9, 15, 36).

[Link](#datetime(2011, 12, 31, 9, 15, 36))

2011
[Link]
09/05/2020 • 2 minutes to read

Sobre
Retorna 6, o número que representa a sexta-feira.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Retorna 2, o número que representa a segunda-feira.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Retorna 7, o número que representa o sábado.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Retorna 1, o número que representa o domingo.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Retorna 5, o número que representa a quinta-feira.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Retorna 3, o número que representa a terça-feira.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Retorna 4, o número que representa a quarta-feira.
#date
09/05/2020 • 2 minutes to read

Sintaxe
#date(year as number, month as number, day as number) as date

Sobre
Cria um valor de data do ano year , do mês month e do dia day . Gera um erro se isto não é verdadeiro:
1 ≤ ano ≤ 9999
1 ≤ mês ≤ 12
1 ≤ dia ≤ 31
Funções de DateTime
08/05/2020 • 5 minutes to read

Essas funções criam e manipulam valores datetime e datetimezone.

DateTime
F UN Ç Ã O DESC RIÇ Ã O

[Link] Adiciona o timezonehours como uma diferença para o valor


de datetime inserido e retorna um novo valor datetimezone.

[Link] Retorna uma parte de data de um valor de DateTime

[Link] Retorna um valor de DateTime definido como a data e a hora


atuais do sistema.

[Link] Retorna o valor de datetime de um valor.

[Link] Retorna o valor de DateTime de um valor fornecido.

[Link] Retorna um valor de DateTime de um conjunto de formatos


de data e valor de cultura.

[Link] Indica se o valor de datetime especificado ocorre durante a


hora atual, conforme determinado pela data e pela hora atuais
do sistema.

[Link] Indica se o valor de datetime especificado ocorre durante o


minuto atual, conforme determinado pela data e pela hora
atuais do sistema.

[Link] Indica se o valor de datetime especificado ocorre durante o


segundo atual, conforme determinado pela hora e pela data
atuais do sistema.

[Link] Indica se o valor de datetime especificado ocorre durante a


hora a seguir, conforme determinado pela data e pela hora
atuais do sistema.

[Link] Indica se o valor de datetime especificado ocorre durante o


minuto a seguir, conforme determinado pela data e pela hora
atuais do sistema.

[Link] Indica se o valor de datetime especificado ocorre durante o


próximo número de horas, conforme determinado pela data e
pela hora atuais do sistema.

[Link] Indica se o valor de datetime especificado ocorre durante o


próximo número de minutos, conforme determinado pela data
e pela hora atuais do sistema.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Indica se o valor de datetime especificado ocorre durante o


próximo número de segundos, conforme determinado pela
data e pela hora atuais do sistema.

[Link] Indica se o valor de datetime especificado ocorre durante o


segundo a seguir, conforme determinado pela hora e pela
data atuais do sistema.

[Link] Indica se o valor de datetime especificado ocorre durante a


hora anterior, conforme determinado pela data e pela hora
atuais do sistema.

[Link] Indica se o valor de datetime especificado ocorre durante o


minuto anterior, conforme determinado pela data e pela hora
atuais do sistema.

[Link] Indica se o valor de datetime especificado ocorre durante o


número anterior de horas, conforme determinado pela data e
pela hora atuais do sistema.

[Link] Indica se o valor de datetime especificado ocorre durante o


número anterior de minutos, conforme determinado pela data
e pela hora atuais do sistema.

[Link] Indica se o valor de datetime especificado ocorre durante o


número anterior de segundos, conforme determinado pela
data e pela hora atuais do sistema.

[Link] Indica se o valor de datetime especificado ocorre durante o


próximo segundo, conforme determinado pela hora e pela
data atuais do sistema.

[Link] Retorna um valor de datetime definido como a data e a hora


atuais do sistema.

[Link] Retorna uma parte de hora de um valor de DateTime.

[Link] Retorna um registro contendo partes do valor de DateTime.

[Link] Retorna o valor de texto de um valor de DateTime.

#datetime Cria um valor de datetime usando ano, mês, dia, hora, minuto
e segundo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as nullable datetime, timezoneHours as number, optional timezoneMinutes
as nullable number) as nullable datetimezone

Sobre
Define as informações de fuso horário em um valor de datetime dateTime . As informações de fuso horário
incluirão timezoneHours e, opcionalmente, timezoneMinutes .

Exemplo 1
Define a informação de fuso horário de #datetime(2010, 12, 31, 11, 56, 02) para 7 horas, 30 minutos.

[Link](#datetime(2010, 12, 31, 11, 56, 02), 7, 30)

#datetimezone(2010, 12, 31, 11, 56, 2, 7, 30)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable date

Sobre
Retorna o componente de data de dateTime , o valor de date , datetime ou datetimezone especificado.

Exemplo 1
Encontrar o valor de data de #datetime(2010, 12, 31, 11, 56, 02).

[Link](#datetime(2010, 12, 31, 11, 56, 02))

#date(2010, 12, 31)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link]() as datetime

Sobre
Retorna um valor datetime definido como a data e a hora atuais do sistema. O valor é fixo e não será alterado com
as chamadas sucessivas, diferentemente de [Link], que poderá retornar valores diferentes no
decorrer da execução de uma expressão.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional culture as nullable text) as nullable datetime

Sobre
Retorna um valor datetime do value especificado. Uma culture opcional também pode ser fornecida (por
exemplo, "pt-BR"). Se o value fornecido for null , [Link] retornará null . Se o value fornecido for
datetime , value será retornado. Os valores dos seguintes tipos podem ser convertidos em um valor datetime :

text : Um valor datetime da representação textual. Confira [Link] para obter detalhes.
date : Um datetime com value como o componente de data e 12:00:00 AM como o componente de hora.
datetimezone : O datetime local equivalente de value .
time : Um datetime com o equivalente de data da Data de Automação OLE de 0 como o componente de data
e value como o componente de hora.
number : Um datetime equivalente da Data de Automação OLE expresso por value .

Se value for de qualquer outro tipo, um erro será retornado.

Exemplo 1
Converter #time(06, 45, 12) em um valor datetime .

[Link](#time(06, 45, 12))

#datetime(1899, 12, 30, 06, 45, 12)

Exemplo 2
Converter #date(1975, 4, 4) em um valor datetime .

[Link](#date(1975, 4, 4))

#datetime(1975, 4, 4, 0, 0, 0)
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](fileTime as nullable number) as nullable datetime

Sobre
Cria um valor datetime com base no valor de fileTime e o converte no fuso horário local. O filetime é um valor
temporal de arquivo do Windows que representa o número de intervalos de 100 a nanossegundos decorridos
desde a meia-noite de 1º de janeiro de 1601 D.C. (C.E.) Tempo Universal Coordenado (UTC).

Exemplo 1
Converter 129876402529842245 em um valor de datetime.

[Link](129876402529842245)

#datetime(2012, 7, 24, 14, 50, 52.9842245)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, optional culture as nullable text) as nullable datetime

Sobre
Cria um valor de datetime com base em uma representação textual, text , seguindo o padrão de formato ISO
8601. Uma culture opcional também pode ser fornecida (por exemplo, "pt-BR").
[Link]("2010-12-31T01:30:00") // aaaa-MM-ddThh:mm:ss

Exemplo 1
Converter "2010-12-31T01:30:25" em um valor de datetime.

[Link]("2010-12-31T01:30:25")

#datetime(2010, 12, 31, 1, 30, 25)

Exemplo 2
Converter "2010-12-31T01:30" em um valor de datetime.

[Link]("2010-12-31T01:30")

#datetime(2010, 12, 31, 1, 30, 0)

Exemplo 3
Converter "20101231T013025" em um valor de datetime.

[Link]("20101231T013025")

#datetime(2010, 12, 31, 1, 30, 25)

Exemplo 4
Converter "20101231T01:30:25" em um valor de datetime.

[Link]("20101231T01:30:25")

#datetime(2010, 12, 31, 1, 30, 25)


Exemplo 5
Converter "20101231T01:30:25.121212" em um valor de datetime.

[Link]("20101231T01:30:25.121212")

#datetime(2010, 12, 31, 1, 30, 25.121212)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante a hora atual, conforme determinado pela data
e pela hora atuais do sistema.
dateTime : Um valor datetime ou datetimezone a ser avaliado.

Exemplo 1
Determinar se a hora atual do sistema ocorre na hora atual.

[Link]([Link]())

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o minuto atual, conforme determinado pela
data e pela hora atuais do sistema.
dateTime : Um valor datetime ou datetimezone a ser avaliado.

Exemplo 1
Determinar se o horário atual do sistema está no minuto atual.

[Link]([Link]())

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o segundo atual, conforme determinado pela
hora e pela data atuais do sistema.
dateTime : Um valor datetime ou datetimezone a ser avaliado.

Exemplo 1
Determinar se a hora atual do sistema ocorre no segundo atual.

[Link]([Link]())

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante a hora a seguir, conforme determinado pela
data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um valor ocorrido
dentro da hora atual.
dateTime : Um valor datetime ou datetimezone a ser avaliado.

Exemplo 1
Determinar se a hora após o horário atual do sistema está na próxima hora.

[Link]([Link]() + #duration(0, 1, 0, 0))

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o minuto seguinte, conforme determinado
pela data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um valor que
ocorre no minuto atual.
dateTime : Um valor datetime ou datetimezone a ser avaliado.

Exemplo 1
Determinar se o minuto após a hora atual do sistema ocorre no minuto seguinte.

[Link]([Link]() + #duration(0, 0, 1, 0))

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, hours as number) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o próximo número de horas, conforme
determinado pela data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um
valor ocorrido dentro da hora atual.
dateTime : Um valor datetime ou datetimezone a ser avaliado.
hours : O número de horas.

Exemplo 1
Determinar se a hora após o horário atual do sistema está nas próximas duas horas.

[Link]([Link]() + #duration(0, 2, 0, 0), 2)

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, minutes as number) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o próximo número de minutos, conforme
determinado pela data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um
valor que ocorre no minuto atual.
dateTime : Um valor datetime ou datetimezone a ser avaliado.
minutes : O número de minutos.

Exemplo 1
Determinar se o minuto após a hora atual do sistema ocorre nos próximos dois minutos.

[Link]([Link]() + #duration(0, 0, 2, 0), 2)

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, seconds as number) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o próximo número de segundos, conforme
determinado pela data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um
valor que ocorre no segundo atual.
dateTime : Um valor datetime ou datetimezone a ser avaliado.
seconds : O número de segundos.

Exemplo 1
Determinar se o segundo após o horário atual do sistema está nos próximos dois segundos.

[Link]([Link]() + #duration(0, 0, 0, 2), 2)

true
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o segundo a seguir, conforme determinado
pela hora e pela data atuais do sistema. Observe que essa função retornará false quando receber um valor que
ocorre no segundo atual.
dateTime : Um valor datetime ou datetimezone a ser avaliado.

Exemplo 1
Determinar se o segundo após o horário atual do sistema está no próximo segundo.

[Link]([Link]() + #duration(0, 0, 0, 1))

true
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante a hora anterior, conforme determinado pela
data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um valor ocorrido
dentro da hora atual.
dateTime : Um valor datetime ou datetimezone a ser avaliado.

Exemplo 1
Determinar se a hora antes do horário atual do sistema está na hora anterior.

[Link]([Link]() - #duration(0, 1, 0, 0))

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o minuto anterior, conforme determinado pela
data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um valor que ocorre
no minuto atual.
dateTime : Um valor datetime ou datetimezone a ser avaliado.

Exemplo 1
Determinar se o minuto antes do horário atual do sistema está no minuto anterior.

[Link]([Link]() - #duration(0, 0, 1, 0))

true
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, hours as number) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o número anterior de horas, conforme
determinado pela data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um
valor ocorrido dentro da hora atual.
dateTime : Um valor datetime ou datetimezone a ser avaliado.
hours : O número de horas.

Exemplo 1
Determinar se a hora anterior à hora atual do sistema ocorre nas duas horas anteriores.

[Link]([Link]() - #duration(0, 2, 0, 0), 2)

true
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, minutes as number) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o número anterior de minutos, conforme
determinado pela data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um
valor que ocorre no minuto atual.
dateTime : Um valor datetime ou datetimezone a ser avaliado.
minutes : O número de minutos.

Exemplo 1
Determinar se o minuto antes do horário atual do sistema está nos dois minutos anteriores.

[Link]([Link]() - #duration(0, 0, 2, 0), 2)

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any, seconds as number) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o número anterior de segundos, conforme
determinado pela data e pela hora atuais do sistema. Observe que essa função retornará false quando receber um
valor que ocorre no segundo atual.
dateTime : Um valor datetime ou datetimezone a ser avaliado.
seconds : O número de segundos.

Exemplo 1
Determinar se o segundo antes da hora atual do sistema ocorre nos dois segundos anteriores.

[Link]([Link]() - #duration(0, 0, 0, 2), 2)

true
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable logical

Sobre
Indica se o valor de datetime dateTime especificado ocorre durante o próximo segundo, conforme determinado
pela hora e pela data atuais do sistema. Observe que essa função retornará false quando receber um valor que
ocorre no segundo atual.
dateTime : Um valor datetime ou datetimezone a ser avaliado.

Exemplo 1
Determinar se o segundo antes do horário atual do sistema está no segundo anterior.

[Link]([Link]() - #duration(0, 0, 0, 1))

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link]() as datetime

Sobre
Retorna um valor datetime definido como a data e a hora atuais do sistema.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable time

Sobre
Retorna a parte de hora do valor datetime especificado, dateTime .

Exemplo 1
Localize o valor temporal de #datetime(2010, 12, 31, 11, 56, 02).

[Link](#datetime(2010, 12, 31, 11, 56, 02))

#time(11, 56, 2)
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as datetime) as record

Sobre
Retorna um registro que contém as partes do valor de datetime especificado, dateTime .
dateTime : Um valor datetime com base no qual o registro das partes deve ser calculado.

Exemplo 1
Converter o valor #datetime(2011, 12, 31, 11, 56, 2) em um registro contendo valores de Date e Time.

[Link](#datetime(2011, 12, 31, 11, 56, 2))

ANO 2011

M ÊS 12

DIA 31

H O RA 11

M IN UT E 56

SEC O N D 2
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as nullable datetime, optional format as nullable text, optional culture
as nullable text) as nullable text

Sobre
Retorna uma representação textual de dateTime , o valor de datetime, dateTime . Essa função usa um parâmetro de
formato opcional format . Para obter uma lista completa dos formatos compatíveis, confira o documento de
especificação da biblioteca. Uma culture opcional também pode ser fornecida (por exemplo, "pt-BR").

Exemplo 1
Obtenha uma representação textual #datetime(2011, 12, 31, 11, 56, 2).

[Link](#datetime(2010, 12, 31, 11, 56, 2))

"12/31/2010 11:56:02 AM"

Exemplo 2
Obtenha uma representação textual de #datetime(2011, 12, 31, 11, 56, 2) com opção de formato.

[Link](#datetime(2010, 12, 31, 11, 56, 2), "yyyy/MM/ddThh:mm:ss")

"2010/12/31T11:56:02"
#datetime
09/05/2020 • 2 minutes to read

Sintaxe
#datetime(year as number, month as number, day as number, hour as number, minute as number, second
as number) as any

Sobre
Cria um valor DateTime de números inteiros year , mês month , dia day , hora hour , minuto minute e segundo
second (fracionário). Gera um erro se isto não é verdadeiro:

1 ≤ ano ≤ 9999
1 ≤ mês ≤ 12
1 ≤ dia ≤ 31
0 ≤ hora ≤ 23
0 ≤ minuto ≤ 59
0 ≤ segundo ≤ 59
Funções de DateTimeZone
08/05/2020 • 2 minutes to read

Essas funções criam e manipulam valores datetimezone.

DateTimeZone
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna um valor de DateTimeZone definido como a data, a


hora e o fuso horário de diferença no sistema.

[Link] Retorna a data e a hora atuais em UTC (fuso horário GMT).

[Link] Retorna o valor de datetimezone de um valor.

[Link] Retorna o DateTimeZone de um valor numérico.

[Link] Retorna um valor de DateTimeZone de um conjunto de


formatos de data e valor de cultura.

[Link] Retorna um valor de DateTime definido como a data e a hora


atuais do sistema.

[Link] Retorna um valor de datetime com as informações de zona


removidas do valor de datetimezone inserido.

[Link] Altera as informações de fuso horário para o DateTimeZone


inserido.

[Link] Retorna um valor de DateTime do fuso horário local.

[Link] Retorna um registro contendo partes do valor de DateTime.

[Link] Retorna o valor de texto de um valor de DateTime.

[Link] Retorna um valor de DateTime para o fuso horário UTC.

[Link] Retorna um valor de DateTime definido como a data e a hora


atuais do sistema no fuso horário UTC.

[Link] Retorna um valor de hora de fuso horário de um valor de


DateTime.

[Link] Retorna um valor de minuto de fuso horário de um valor de


DateTime.

#datetimezone Cria um valor de datetimezone usando ano, mês, dia, hora,


minuto, segundo, horas de diferença e minutos de diferença.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link]() as datetimezone

Sobre
Retorna um valor datetime definido como a data e a hora atuais do sistema. O valor retornado contém
informações de fuso horário que representam o fuso horário local. O valor é fixo e não será alterado com as
chamadas sucessivas, ao contrário de [Link], que poderá retornar valores diferentes no decorrer
da execução de uma expressão.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link]() as datetimezone

Sobre
Retorna a data e a hora atuais em UTC (fuso horário GMT). Esse valor é fixo e não será alterado com chamadas
sucessivas.
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional culture as nullable text) as nullable datetimezone

Sobre
Retorna um valor datetimezone do value especificado. Uma culture opcional também pode ser fornecida (por
exemplo, "pt-BR"). Se o value fornecido for null , [Link] retornará null . Se o value fornecido for
datetimezone , value será retornado. Os valores dos seguintes tipos podem ser convertidos em um valor
datetimezone :

text : Um valor datetimezone da representação textual. Confira [Link] para obter detalhes.
date : Um datetimezone com value como o componente de data, 12:00:00 AM como o componente de hora e
o deslocamento correspondente ao fuso horário local.
datetime : Um datetimezone com value como o datetime e o deslocamento correspondente ao fuso horário
local.
time : Um datetimezone com o equivalente de data da Data de Automação OLE de 0 como o componente de
data, value como o componente de hora e o deslocamento correspondente ao fuso horário local.
number : Um datetimezone com o equivalente de datetime da Data de Automação OLE expresso por value e o
deslocamento correspondente ao fuso horário local.
Se value for de qualquer outro tipo, um erro será retornado.

Exemplo 1
Converter "2020-10-30T01:30:00-08:00" em um valor datetimezone .

[Link]("2020-10-30T01:30:00-08:00")

#datetimezone(2020, 10, 30, 01, 30, 00, -8, 00)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](fileTime as nullable number) as nullable datetimezone

Sobre
Cria um valor datetimezone com base no valor de fileTime e o converte no fuso horário local. O filetime é um
valor temporal de arquivo do Windows que representa o número de intervalos de 100 a nanossegundos
decorridos desde a meia-noite de 1º de janeiro de 1601 D.C. (C.E.) Tempo Universal Coordenado (UTC).

Exemplo 1
Converter 129876402529842245 em um valor de datetimezone.

[Link](129876402529842245)

#datetimezone(2012, 7, 24, 14, 50, 52.9842245, -7, 0)


[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, optional culture as nullable text) as nullable
datetimezone

Sobre
Cria um valor de datetimezone com base em uma representação textual, text , seguindo o padrão de formato ISO
8601. Uma culture opcional também pode ser fornecida (por exemplo, "pt-BR").
[Link]("2010-12-31T01:30:00-08:00") // aaaa-MM-ddThh:mm:ssZ

Exemplo 1
Converter "2010-12-31T01:30:00-08:00" em um valor de datetimezone.

[Link]("2010-12-31T01:30:00-08:00")

#datetimezone(2010, 12, 31, 1, 30, 0, -8, 0)

Exemplo 2
Converter "2010-12-31T01:30:00.121212-08:00" em um valor de datetimezone.

[Link]("2010-12-31T01:30:00.121212-08:00")

#datetimezone(2010, 12, 31, 1, 30, 0.121212, -8, 0)

Exemplo 3
Converter "2010-12-31T01:30:00Z" em um valor de datetimezone.

[Link]("2010-12-31T01:30:00Z")

#datetimezone(2010, 12, 31, 1, 30, 0, 0, 0)

Exemplo 4
Converter "20101231T013000+0800" em um valor de datetimezone.

[Link]("20101231T013000+0800")

#datetimezone(2010, 12, 31, 1, 30, 0, 8, 0)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link]() as datetimezone

Sobre
Retorna um valor datetimezone definido como a data e a hora atuais do sistema. O valor retornado contém
informações de fuso horário que representam o fuso horário local.
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTimeZone as nullable datetimezone) as nullable datetime

Sobre
Retorna um valor de #datetime de dateTimeZone com as informações de fuso horário removidas.

Exemplo 1
Remover as informações de fuso horário do valor de #datetimezone(2011, 12, 31, 9, 15, 36, -7, 0).

[Link](#datetimezone(2011, 12, 31, 9, 15, 36, -7, 0))

#datetime(2011, 12, 31, 9, 15, 36)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTimeZone as nullable datetimezone, timezoneHours as number, optional
timezoneMinutes as nullable number) as nullable datetimezone

Sobre
Altera as informações de fuso horário no valor de datetimezone dateTimeZone para as novas informações de fuso
horário fornecidas por timezoneHours e, opcionalmente, timezoneMinutes . Se dateTimeZone não tem um
componente de fuso horário, uma exceção é gerada.

Exemplo 1
Alterar as informações de fuso horário de #datetimezone(2010, 12, 31, 11, 56, 02, 7, 30) para 8 horas.

[Link](#datetimezone(2010, 12, 31, 11, 56, 02, 7, 30), 8)

#datetimezone(2010, 12, 31, 12, 26, 2, 8, 0)

Exemplo 2
Alterar as informações de fuso horário de #datetimezone(2010, 12, 31, 11, 56, 02, 7, 30) para -30 minutos.

[Link](#datetimezone(2010, 12, 31, 11, 56, 02, 7, 30), 0, -30)

#datetimezone(2010, 12, 31, 3, 56, 2, 0, -30)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTimeZone as nullable datetimezone) as nullable datetimezone

Sobre
Altera as informações de fuso horário do valor de datetimezone dateTimeZone para as informações de fuso horário
local. Se dateTimeZone não tiver um componente de fuso horário, as informações de fuso horário local serão
adicionadas.

Exemplo 1
Alterar as informações de fuso horário de #datetimezone(2010, 12, 31, 11, 56, 02, 7, 30) para o fuso horário local
(pressupondo PST).

[Link](#datetimezone(2010, 12, 31, 11, 56, 02, 7, 30))

#datetimezone(2010, 12, 31, 12, 26, 2, -8, 0)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTimeZone as datetimezone) as record

Sobre
Retorna um registro contendo as partes do valor de datetimezone especificado, dateTimeZone .
dateTimeZone : Um valor datetimezone com base no qual o registro das partes deve ser calculado.

Exemplo 1
Converter o valor #datetimezone(2011, 12, 31, 11, 56, 2, 8, 0) em um registro contendo valores de Date, Time e
Zone.

[Link](#datetimezone(2011, 12, 31, 11, 56, 2, 8, 0))

ANO 2011

M ÊS 12

DIA 31

H O RA 11

M IN UT E 56

SEC O N D 2

Z O N EH O URS 8

Z O N EM IN UT ES 0
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTimeZone as nullable datetimezone, optional format as nullable text,
optional culture as nullable text) as nullable text

Sobre
Retorna uma representação textual de dateTimeZone , o valor datetimezone, dateTimeZone . Essa função usa um
parâmetro de formato opcional format . Para obter uma lista completa dos formatos compatíveis, confira o
documento de especificação da biblioteca. Uma culture opcional também pode ser fornecida (por exemplo, "pt-
BR").

Exemplo 1
Obtenha uma representação textual #datetimezone(2011, 12, 31, 11, 56, 2, 8, 0).

[Link](#datetimezone(2010, 12, 31, 11, 56, 2, 8, 0))

"12/31/2010 11:56:02 AM +08:00"

Exemplo 2
Obtenha uma representação textual de #datetimezone(2010, 12, 31, 11, 56, 2, 10, 12) com opção de formato.

[Link](#datetimezone(2010, 12, 31, 11, 56, 2, 10, 12), "yyyy/MM/ddThh:mm:sszzz")

"2010/12/31T11:56:02+10:12"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTimeZone as nullable datetimezone) as nullable datetimezone

Sobre
Altera as informações de fuso horário do valor de datetime dateTimeZone para as informações de fuso horário UTC
ou Tempo Universal. Se dateTimeZone não tiver um componente de fuso horário, as informações de fuso horário
UTC serão adicionadas.

Exemplo 1
Alterar as informações de fuso horário de #datetimezone(2010, 12, 31, 11, 56, 02, 7, 30) para o fuso horário UTC.

[Link](#datetimezone(2010, 12, 31, 11, 56, 02, 7, 30))

#datetimezone(2010, 12, 31, 4, 26, 2, 0, 0)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link]() as datetimezone

Sobre
Retorna a data e a hora atuais em UTC (fuso horário GMT).

Exemplo 1
Obtenha a data e a hora atuais em UTC.

[Link]()

#datetimezone(2011, 8, 16, 23, 34, 37.745, 0, 0)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTimeZone as nullable datetimezone) as nullable number

Sobre
Altera o fuso horário do valor.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTimeZone as nullable datetimezone) as nullable number

Sobre
Altera o fuso horário do valor.
#datetimezone
09/05/2020 • 2 minutes to read

Sintaxe
#datetimezone(year as number, month as number, day as number, hour as number, minute as number,
second as number, offsetHours as number, offsetMinutes as number) as any

Sobre
Cria um valor datetimezone dos números inteiros year , mês month , dia day , hora hour , minuto minute ,
segundo second (fracionário), horas de deslocamento offsetHours (fracionário) e minutos de deslocamento
offsetMinutes . Gera um erro se isto não é verdadeiro:

1 ≤ ano ≤ 9999
1 ≤ mês ≤ 12
1 ≤ dia ≤ 31
0 ≤ hora ≤ 23
0 ≤ minuto ≤ 59
0 ≤ segundo ≤ 59
-14 ≤ horas de deslocamento + minutos de deslocamento / 60 ≤ 14
Funções de duração
08/05/2020 • 2 minutes to read

Essas funções criam e manipulam valores de duração.

Duração
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna o componente de dia do valor de duração.

[Link] Retorna o valor de duração de um valor.

[Link] Retorna o valor de duração de um valor de texto.

[Link] Retorna o componente de hora do valor de duração.

[Link] Retorna o componente de minuto do valor de duração.

[Link] Retorna o componente de segundo do valor de duração.

[Link] Retorna um registro com partes de um valor de duração.

[Link] Retorna a magnitude total de dias com base em um valor de


duração.

[Link] Retorna a magnitude total de horas de um valor de duração.

[Link] Retorna a magnitude total de minutos de um valor de


duração.

[Link] Retorna a magnitude total de segundos de um valor de


duração.

[Link] Retorna um valor de texto de um valor de duração.

#duration Cria um valor de duração usando dias, hora, minuto e


segundo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](duration as nullable duration) as nullable number

Sobre
Retorna o componente de dia do valor duration fornecido, duration .

Exemplo 1
Localizar o dia em #duration(5, 4, 3, 2).

[Link](#duration(5, 4, 3, 2))

5
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any) as nullable duration

Sobre
Retorna um valor duration do value especificado. Se o value fornecido for null , [Link] retornará
null . Se o value fornecido for duration , value será retornado. Os valores dos seguintes tipos podem ser
convertidos em um valor duration :
text : Um valor duration do formato textual de tempo decorrido (d.h:m:s). Confira [Link] para
obter detalhes.
number : Um duration equivalente ao número de dias inteiros e fracionários expressos por value .

Se value for de qualquer outro tipo, um erro será retornado.

Exemplo 1
Converter 2.525 em um valor duration .

[Link](2.525)

#duration(2, 12, 36, 0)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text) as nullable duration

Sobre
Retorna um valor de duração do texto especificado, text . Os seguintes formatos podem ser analisados por esta
função:
(-)hh:mm(:ss(.ff))
(-)ddd(.hh:mm(:ss(.ff)))

(Todos os intervalos são inclusivos)


ddd: Número de dias.
hh: Número de horas, entre 0 e 23.
mm: Número de minutos, entre 0 e 59.
ss: Número de segundos, entre 0 e 59.
ff: Fração de segundos, entre 0 e 9999999.

Exemplo 1
Converter "2.05:55:20" em um valor duration .

[Link]("2.05:55:20")

#duration(2, 5, 55, 20)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](duration as nullable duration) as nullable number

Sobre
Retorna o componente de hora do valor duration fornecido, duration .

Exemplo 1
Localizar as horas em #duration(5, 4, 3, 2).

[Link](#duration(5, 4, 3, 2))

4
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](duration as nullable duration) as nullable number

Sobre
Retorna o componente de minutos do valor duration fornecido, duration .

Exemplo 1
Localize os minutos em #duration(5, 4, 3, 2).

[Link](#duration(5, 4, 3, 2))

3
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](duration as nullable duration) as nullable number

Sobre
Retorna o componente de segundos do valor duration fornecido, duration .

Exemplo 1
Localizar os segundos em #duration(5, 4, 3, 2).

[Link](#duration(5, 4, 3, 2))

2
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](duration as duration) as record

Sobre
Retorna um registro contendo as partes do valor de duração, duration .
duration : Uma duration em que o registro é criado.

Exemplo 1
Converta #duration(2, 5, 55, 20) em um registro das partes, incluindo dias, horas, minutos e segundos, se
aplicável.

[Link](#duration(2, 5, 55, 20))

DIA S 2

H O RA S 5

M IN UTO S 55

SEGUN DO S 20
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](duration as nullable duration) as nullable number

Sobre
Retorna o total de dias abrangidos pelo valor de duration fornecido, duration .

Exemplo 1
Localizar o total de dias abrangidos em #duration(5, 4, 3, 2).

[Link](#duration(5, 4, 3, 2))

5.1687731481481478
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](duration as nullable duration) as nullable number

Sobre
Retorna o total de horas abarcado pelo valor duration fornecido, duration .

Exemplo 1
Localize o total de horas abarcados em #duration(5, 4, 3, 2).

[Link](#duration(5, 4, 3, 2))

124.05055555555555
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](duration as nullable duration) as nullable number

Sobre
Retorna o total de minutos abrangidos pelo valor de duration fornecido, duration .

Exemplo 1
Localizar o total de minutos abrangidos em #duration(5, 4, 3, 2).

[Link](#duration(5, 4, 3, 2))

7443.0333333333338
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](duration as nullable duration) as nullable number

Sobre
Retorna o total de segundos abarcado pelo valor duration fornecido, duration .

Exemplo 1
Localize o total de segundos abarcados em #duration(5, 4, 3, 2).

[Link](#duration(5, 4, 3, 2))

446582
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](duration as nullable duration, optional format as nullable text) as nullable text

Sobre
Retorna uma representação textual no formato "[Link]:mins:sec" do valor de duração especificado, duration .
Um valor de texto que especifica o formato pode ser fornecido como um segundo parâmetro opcional, format .
duration : Uma duration com base na qual a representação textual é calculada.
format : [Opcional] Um valor text que especifica o formato.

Exemplo 1
Converter #duration(2, 5, 55, 20) em um valor de texto.

[Link](#duration(2, 5, 55, 20))

"2.05:55:20"
#duration
09/05/2020 • 2 minutes to read

Sintaxe
#duration(days as number, hours as number, minutes as number, seconds as number) as duration

Sobre
Cria um valor de duração usando os números de dias days , horas hours , minutos minutes e segundos seconds .
Tratamento de erro
08/05/2020 • 2 minutes to read

Essas funções retornam rastreamentos de diagnóstico em diferentes níveis de detalhamento, além de gerar
registros de erros.

Erro
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna um identificador opaco para a avaliação atualmente


em execução.

[Link] Grava uma entrada de rastreamento se o rastreamento está


habilitado e retorna o valor.

[Link] Retorna um registro que contém os campos “Motivo”,


“Mensagem” e “Detalhes” definidos com os valores fornecidos.
O registro pode ser usado para gerar um erro.

[Link] Retorna 1, o valor para o nível de rastreamento Crítico.

[Link] Retorna 2, o valor para o nível de rastreamento de Erro.

[Link] Retorna 4, o valor do nível de rastreamento de Informações.

[Link] Retorna 5, o valor para o nível de rastreamento Detalhado.

[Link] Retorna 3, o valor do nível de rastreamento de Aviso.


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link]() as nullable text

Sobre
Retorna um identificador opaco para a avaliação atualmente em execução.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](traceLevel as number, message as anynonnull, value as any, optional delayed as
nullable logical) as any

Sobre
Grava uma message de rastreamento, se o rastreamento está habilitado e retorna value . Um parâmetro opcional
delayed especifica se a avaliação de value deve ser atrasada até a mensagem ser rastreada. traceLevel pode
usar um dos seguintes valores:
- [Link] - [Link]

[Link]
[Link]
[Link]

Exemplo 1
Rastrear a mensagem antes de invocar a função [Link] e retornar o resultado.

[Link]([Link], "TextValueFromNumber", () => [Link](123), true)

"123"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](reason as text, optional message as nullable text, optional detail as any) as record

Sobre
Retorna um registro de erro dos valores de texto fornecidos para motivo, mensagem e detalhes.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Retorna 1, o valor para o nível de rastreamento Crítico.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Retorna 2, o valor para o nível de rastreamento de Erro.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Retorna 4, o valor do nível de rastreamento de Informações.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Retorna 5, o valor para o nível de rastreamento Detalhado.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Retorna 3, o valor do nível de rastreamento de Aviso.
Funções de expressão
08/05/2020 • 2 minutes to read

Essas funções permitem a construção e a avaliação do código M.

Expressão
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna a representação do código-fonte M de um valor


constante.

[Link] Retorna o resultado da avaliação de uma expressão M.

[Link] Retorna a representação do código-fonte M de um


identificador.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any) as text

Sobre
Retorna a representação do código-fonte M de um valor constante.

Exemplo 1
Obter a representação do código-fonte M de um valor numérico.

[Link](123)

"123"

Exemplo 2
Obter a representação do código-fonte M de um valor de data.

[Link](#date(2035, 01, 02))

"#date(2035, 1, 2)"

Exemplo 3
Obter a representação do código-fonte M de um valor de texto.

[Link]("abc")

"""abc"""
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](document as text, optional environment as nullable record) as any

Sobre
Retorna o resultado da avaliação de uma expressão M document , com os identificadores disponíveis que podem
ser referenciados por environment .

Exemplo 1
Avaliar uma soma simples.

[Link]("1 + 1")

Exemplo 2
Avaliar uma soma mais complexa.

[Link]("[Link]({1, 2, 3})", [[Link] = [Link]])

Exemplo 3
Avaliar a concatenação de um valor de texto com um identificador.

[Link]([Link]("""abc") & " & " & [Link]("x"), [x = "def"""])

"""abcdef"""
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](name as text) as text

Sobre
Retorna a representação do código-fonte M de um identificador name .

Exemplo 1
Obter a representação do código-fonte M de um identificador.

[Link]("MyIdentifier")

"MyIdentifier"

Exemplo 2
Obter a representação do código-fonte M de um identificador que contenha um espaço.

[Link]("My Identifier")

"#""My Identifier"""
Valores de função
08/05/2020 • 2 minutes to read

Essas funções criam e invocam outras funções M.

Função
F UN Ç Ã O DESC RIÇ Ã O

[Link] Usa uma função unária function e cria uma nova função
com o tipo functionType , que cria uma lista dos seus
argumentos e a transfere para function .

[Link] Chama a função fornecida usando o especificado e retorna o


resultado.

[Link] Retorna o resultado da função de invocação após o atraso de


duração ter passado.

[Link] Retorna se a função é considerada ou não uma fonte de


dados.

[Link] Retorna uma função escalar do tipo scalarFunctionType que


invoca vectorFunction com uma única linha de argumentos e
retorna a única saída.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](functionType as type, function as function) as function

Sobre
Usa uma função unária function e cria uma nova função com o tipo functionType , que cria uma lista dos seus
argumentos e a transfere para function .

Exemplo 1
Converte [Link] em uma função de dois argumentos que são adicionados de modo conjunto.

[Link](type function (a as number, b as number) as number, [Link])(2, 1)

Exemplo 2
Converte uma função que leva uma lista para uma função de dois argumentos.

[Link](type function (a as text, b as text) as text, (list) => list{0} & list{1})("2", "1")

"21"
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](function as function, args as list) as any

Sobre
Chama a função fornecida usando a lista de argumentos especificada e retorna o resultado.

Exemplo 1
Chama [Link] com um argumento [A=1,B=2]

[Link]([Link], {[A = 1, B = 2]}

B
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](function as function, delay as duration) as any

Sobre
Retorna o resultado da invocação de function após o decorrer da duração delay .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](function as function) as logical

Sobre
Retorna se function é considerado ou não uma fonte de dados.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](scalarFunctionType as type, vectorFunction as function) as function

Sobre
Retorna uma função escalar do tipo scalarFunctionType que invoca vectorFunction com uma única linha de
argumentos e retorna a única saída. Além disso, quando a função escalar é aplicada repetidamente a cada linha de
uma tabela de entradas, como em [Link], em vez disso, vectorFunction será aplicada uma vez a todas
as entradas.
vectorFunction receberá uma tabela cujas colunas têm nomes correspondentes e posicionam os parâmetros de
scalarFunctionType . Cada linha dessa tabela contém os argumentos para uma chamada à função escalar, com as
colunas correspondentes aos parâmetros de scalarFunctionType .
vectorFunction precisa retornar uma lista com o mesmo tamanho da tabela de entrada, cujo item em cada posição
precisa ter o mesmo resultado da avaliação da função escalar na linha de entrada da mesma posição.
A tabela de entrada deve ser transmitida e, portanto, vectorFunction deve transmitir a saída conforme a entrada é
recebida, trabalhando apenas com uma parte da entrada de cada vez. Em particular, vectorFunction não deve
enumerar a tabela de entrada mais de uma vez.
Funções de linha
08/05/2020 • 2 minutes to read

Essas funções convertem listas de texto de e para valores de texto único e binário.

Linhas
F UN Ç Ã O DESC RIÇ Ã O

[Link] Converte um valor binário em uma lista de valores de texto


dividida em quebras de linha.

[Link] Converte um valor de texto em uma lista de valores de texto


dividida em quebras de linha.

[Link] Converte uma lista de texto em valor binário usando a


codificação especificada e o lineSeparator. O lineSeparator
especificado é acrescentado a cada linha. Se não for
especificado, o retorno de carro e os caracteres de alimentação
de linha serão usados.

[Link] Converte uma lista de texto em um só texto. O lineSeparator


especificado é acrescentado a cada linha. Se não for
especificado, o retorno de carro e os caracteres de alimentação
de linha serão usados.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](binary as binary, optional quoteStyle as nullable number, optional
includeLineSeparators as nullable logical, optional encoding as nullable number) as list

Sobre
Converte um valor binário em uma lista de valores de texto dividida em quebras de linha. Se um estilo de aspas for
especificado, as quebras de linha poderão aparecer entre aspas. Se includeLineSeparators for true, os caracteres de
quebra de linha serão incluídos no texto.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as text, optional quoteStyle as nullable number, optional
includeLineSeparators as nullable logical) as list

Sobre
Converte um valor de texto em uma lista de valores de texto dividida em quebras de linha. Se
includeLineSeparators for true, os caracteres de quebra de linha serão incluídos no texto.
[Link]: (padrão) Nenhum comportamento de aspas é necessário.
[Link]: As aspas são de acordo com o CSV. Um caractere de aspas duplas é usado para demarcar
essas regiões e um par de caracteres de aspas duplas é usado para indicar um único caractere de aspas duplas
nessa região.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](lines as list, optional lineSeparator as nullable text, optional encoding as
nullable number, optional includeByteOrderMark as nullable logical) as binary

Sobre
Converte uma lista de texto em valor binário usando a codificação especificada e o lineSeparator. O lineSeparator
especificado é acrescentado a cada linha. Se não for especificado, o retorno de carro e os caracteres de alimentação
de linha serão usados.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](lines as list, optional lineSeparator as nullable text) as text

Sobre
Converte uma lista de texto em um só texto. O lineSeparator especificado é acrescentado a cada linha. Se não for
especificado, o retorno de carro e os caracteres de alimentação de linha serão usados.
Funções de lista
08/05/2020 • 16 minutes to read

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

Informações
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna o número de itens em uma lista.

[Link] Retorna o número de itens em uma lista excluindo valores


nulos

[Link] Retorna uma mensagem informando se uma lista está vazia.

Seleção
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna uma lista com os itens alternados da lista original


baseado em uma contagem, repeatInterval opcional e um
deslocamento opcional.

[Link] Armazena em buffer a lista na memória. O resultado dessa


chamada é uma lista estável, o que significa que ela terá uma
ordem dos itens e uma contagem determinísticas.

[Link] Filtra uma lista removendo duplicatas. Um valor de critérios de


equação opcional pode ser especificado para controlar a
comparação de igualdade. O primeiro valor de cada grupo de
igualdade é escolhido.

[Link] Pesquisa uma lista de valores, incluindo campos de registro,


para um valor de texto.

[Link] 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 opcional se a lista está vazia. Se a lista estiver vazia e
um valor padrão não for especificado, a função retornará.

[Link] Retorna o primeiro conjunto de itens da lista especificando


quantos itens devem ser retornados ou uma condição de
qualificação fornecida por countOrCondition .

[Link] Insere itens de valores no índice fornecido na lista de entrada.

[Link] Retorna uma mensagem informando se uma lista é distinta.

[Link] Retorna o último conjunto de itens da lista especificando


quantos itens devem ser retornados ou uma condição de
qualificação fornecida por countOrCondition .
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna o último conjunto de itens de uma lista especificando


quantos itens devem ser retornados ou uma condição de
qualificação.

[Link] Retorna verdadeiro se todos os itens de uma lista atendem a


uma condição.

[Link] Retorna verdadeiro se qualquer item de uma lista atende a


uma condição.

[Link] Retorna uma lista de posições de uma lista de entrada.

[Link] Retorna uma contagem de itens começando em um


deslocamento.

[Link] Seleciona os itens que correspondem a uma condição.

[Link] Retorna o único item da lista ou gera um [Link] se a


lista tem mais de um item.

[Link] Retorna um único item de uma lista.

[Link] Ignora o primeiro item da lista. Considerando uma lista vazia,


ele retorna uma lista vazia. Essa função usa um parâmetro
opcional countOrCondition para dar suporte ao recurso de
ignorar vários valores.

Funções de transformação
F UN Ç Ã O DESC RIÇ Ã O

[Link] Acumula um resultado da lista. Começando na semente de


valor inicial, essa função aplica a função de acumulador e
retorna o resultado final.

[Link] Mescla uma lista de listas em uma só lista.

[Link] Retorna uma lista que remove itens de contagem começando


no deslocamento. A contagem padrão é 1.

[Link] Retorna uma lista com o número especificado de elementos


removidos da lista, começando no primeiro elemento. O
número de elementos removidos depende do parâmetro
opcional countOrCondition.

[Link] Remove itens de list1 que estão presentes em list2 e retorna


uma nova lista.

[Link] Retorna uma lista com o número especificado de elementos


removidos da lista, começando no último elemento. O número
de elementos removidos depende do parâmetro opcional
countOrCondition.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna uma lista que repete o conteúdo do número de


contagens de uma lista de entrada.

[Link] Retorna uma lista que substitui valores de contagem em uma


lista por uma lista replaceWith começando em um índice.

[Link] Remove todas as ocorrências dos valores especificados na lista.

[Link] Remove os valores nulos de uma lista.

[Link] 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 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.

[Link] Pesquisa o valor em uma lista de valores e substitui cada


ocorrência pelo valor de substituição.

[Link] Retorna uma lista que reverte os itens em uma lista.

[Link] Divide a lista especificada em uma lista de listas usando o


tamanho da página especificado.

[Link] Executa a função em cada item da lista e retorna a nova lista.

[Link] Retorna uma lista cujos elementos são projetados com 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.

F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna verdadeiro se todas as expressões de uma lista são


verdadeiras

[Link] Retorna verdadeiro se qualquer expressão de uma lista é


verdadeira

[Link] Retorna verdadeiro se um valor é encontrado em uma lista.

[Link] Retorna verdadeiro se todos os itens nos valores são


encontrados em uma lista.

[Link] Retorna verdadeiro se qualquer item nos valores é encontrado


em uma lista.

[Link] Encontra a primeira ocorrência de um valor em uma lista e


retorna a posição dela.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Encontra a primeira ocorrência de qualquer valor nos valores e


retorna a posição dela.

Operações de conjuntos
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna os itens da lista 1 que não aparecem na lista 2. Há


suporte para valores duplicados.

[Link] Retorna uma lista de uma lista de listas e intersecciona itens


comuns em listas individuais. Há suporte para valores
duplicados.

[Link] Retorna uma lista de uma lista de listas e une os itens nas
listas 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.

[Link] Retorna uma lista de listas combinando itens na mesma


posição.

Ordenação
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 [Link] é gerado.
Tipos de dados comparáveis
Número
Duração
DateTime
Texto
Logical
Nulo

F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna o item máximo em uma lista ou o valor padrão


opcional se a lista está vazia.

[Link] Retorna os valores máximos na lista. Depois que as linhas são


classificadas, parâmetros opcionais podem ser especificados
para filtrar ainda mais o resultado

[Link] Retorna o item mediano de uma lista.

[Link] Retorna o item mínimo em uma lista ou o valor padrão


opcional se a lista está vazia.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna os valores mínimos em uma lista.

[Link] Retorna uma lista classificada usando o critério de


comparação.

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

F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna um valor médio de uma lista no tipo de dados dos


valores na lista.

[Link] Retorna um item que aparece mais comumente em uma lista.

[Link] Retorna todos os itens que aparecem com a mesma


frequência máxima.

[Link] Retorna o desvio padrão de uma lista de valores.


[Link] faz uma estimativa baseada em
amostra. 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.

F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna a soma de uma lista.

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

F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna a covariância de duas listas como um número.

[Link] Retorna o produto de uma lista de números.

Geradores
Essas funções geram uma lista de valores.

F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna uma lista de valores de data da contagem de


tamanho, começando no início, e adiciona um incremento a
cada valor.

[Link] Retorna uma lista de valores de datetime da contagem de


tamanho, começando no início, e adiciona um incremento a
cada valor.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna uma lista de valores de datetimezone da contagem de


tamanho, começando no início, e adiciona um incremento a
cada valor.

[Link] Retorna uma lista de valores de durações da contagem de


tamanho, começando no início, e adiciona um incremento a
cada valor.

[Link] Gera uma lista com base em uma função de valor, uma função
de condição, uma função next e uma função de transformação
opcional nos valores.

[Link] Retorna uma lista de números da contagem de tamanho,


começando no início, e adiciona um incremento. O incremento
usa 1 como padrão.

[Link] Retorna uma lista de números aleatórios de contagem, com


um parâmetro de semente opcional.

[Link] Retorna uma lista de valores de tempo da contagem de


tamanho, começando no início.

Valores de parâmetros
Especificação de ocorrência
[Link] = 0;
[Link] = 1;
[Link] = 2;
Ordem de classificação
[Link] = 0;
[Link] = 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 é
Um seletor de chave que determina o valor na lista para aplicar os critérios de igualdade ou
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
Exatamente dois itens
O primeiro elemento é o seletor de chave, conforme especificado acima
O segundo elemento é um comparador, conforme especificado acima.
Para obter mais informações e exemplos, confira [Link].
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. [Link] é um método que pode
ser usado para delegar essa lógica.
Para obter mais informações e exemplos, confira [Link].
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
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, seed as any, accumulator as function) as any

Sobre
Acumula um valor de resumo com base nos itens da lista list , usando accumulator . Um parâmetro semente
opcional, seed , pode ser definido.

Exemplo 1
Acumula o valor de resumo dos itens na lista {1, 2, 3, 4, 5} usando ((state, current) => state + current ).

[Link]({1, 2, 3, 4, 5}, 0, (state, current) => state + current)

15
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list) as logical

Sobre
Retorna verdadeiro se todas as expressões da lista list são verdadeiras.

Exemplo 1
Determinar se todas as expressões da lista {true, true, 2 > 0} são verdadeiras.

[Link]({true, true, 2 > 0})

true

Exemplo 2
Determinar se todas as expressões da lista {true, true, 2 < 0} são verdadeiras.

[Link]({true, false, 2 < 0})

false
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, count as number, optional repeatInterval as nullable number, optional
offset as nullable number) as list

Sobre
Retorna uma lista composta por todos os elementos de deslocamento de número ímpar em uma lista. Alterna
entre usar e ignorar valores da lista list , dependendo dos parâmetros.
count : Especifica o número de valores que são ignorados a cada vez.
repeatInterval : Um intervalo de repetição opcional para indicar quantos valores são adicionados entre os
valores ignorados.
offset : Um parâmetro de deslocamento opcional para começar a ignorar os valores no deslocamento inicial.

Exemplo 1
Crie uma lista com base em {1..10} que ignore o primeiro número.

[Link]({1..10}, 1)

10

Exemplo 2
Crie uma lista com base em {1..10} que ignore todos os outros números.
[Link]({1..10}, 1, 1)

10

Exemplo 3
Crie uma lista com base em {1..10} que comece em 1 e ignore todos os outros números.

[Link]({1..10}, 1, 1, 1)

Exemplo 4
Crie uma lista com base em {1..10} que comece em 1, ignore um valor, mantenha dois valores e assim por diante.

[Link]({1..10}, 1, 2, 1)

10
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list) as logical

Sobre
Retorna verdadeiro se qualquer expressão da lista list é verdadeira.

Exemplo 1
Determinar se uma das expressões da lista {true, false, 2 > 0} é verdadeira.

[Link]({true, false, 2>0})

true

Exemplo 2
Determinar se uma das expressões da lista {2 = 0, false, 2 < 0} é verdadeira.

[Link]({2 = 0, false, 2 < 0})

false
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, optional precision as nullable number) as any

Sobre
Retorna o valor médio dos itens na lista list . O resultado é fornecido no mesmo tipo de dados que os valores na
lista. Funciona somente com valores number, date, datetime, datetimezone e duration. Se a lista estiver vazia, nulo
será retornado.

Exemplo 1
Localize a média da lista de números, {3, 4, 6} .

[Link]({3, 4, 6})

4.333333333333333

Exemplo 2
Localize a média dos valores date 1º de janeiro de 2011, 2 de janeiro de 2011 e 3 de janeiro de 2011.

[Link]({#date(2011, 1, 1), #date(2011, 1, 2), #date(2011, 1, 3)})

#date(2011, 1, 2)
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list) as list

Sobre
Armazena em buffer a lista list na memória. O resultado dessa chamada é uma lista estável.

Exemplo 1
Criar uma cópia estável da lista {1..10}.

[Link]({1..10})

10
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](lists as list) as list

Sobre
Faça uma lista das listas, lists , e mescle-as em uma única lista nova.

Exemplo 1
Combine as duas listas simples {1, 2} e {3, 4}.

[Link]({{1, 2}, {3, 4}})

Exemplo 2
Combine as duas listas, {1, 2} e {3, {4, 5}}, uma delas contendo uma lista aninhada.

[Link]({{1, 2}, {3, {4, 5}}})

[Lista]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, value as any, optional equationCriteria as any) as logical

Sobre
Indica se a lista list contém o valor value . Retorna true se o valor é encontrado na lista; caso contrário, false. Um
valor de critérios de equação opcional, equationCriteria , pode ser especificado para controlar o teste de
igualdade.

Exemplo 1
Descobrir se a lista {1, 2, 3, 4, 5} contém 3.

[Link]({1, 2, 3, 4, 5}, 3)

true

Exemplo 2
Descobrir se a lista {1, 2, 3, 4, 5} contém 6.

[Link]({1, 2, 3, 4, 5}, 6)

false
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, values as list, optional equationCriteria as any) as logical

Sobre
Indica se a lista list inclui todos os valores em outra lista, values . Retorna true se o valor é encontrado na lista;
caso contrário, false. Um valor de critérios de equação opcional, equationCriteria , pode ser especificado para
controlar o teste de igualdade.

Exemplo 1
Descubra se a lista {1, 2, 3, 4, 5} contém 3 e 4.

[Link]({1, 2, 3, 4, 5}, {3, 4})

true

Exemplo 2
Descubra se a lista {1, 2, 3, 4, 5} contém 5 e 6.

[Link]({1, 2, 3, 4, 5}, {5, 6})

false
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, values as list, optional equationCriteria as any) as logical

Sobre
Indica se a lista list inclui um dos valores em outra lista, values . Retorna true se o valor é encontrado na lista;
caso contrário, false. Um valor de critérios de equação opcional, equationCriteria , pode ser especificado para
controlar o teste de igualdade.

Exemplo 1
Descobrir se a lista {1, 2, 3, 4, 5} contém 3 ou 9.

[Link]({1, 2, 3, 4, 5}, {3, 9})

true

Exemplo 2
Descobrir se a lista {1, 2, 3, 4, 5} contém 6 ou 7.

[Link]({1, 2, 3, 4, 5}, {6, 7})

false
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list) as number

Sobre
Retorna o número de itens na lista list .

Exemplo 1
Localize o número de valores na lista {1, 2, 3}.

[Link]({1, 2, 3})

3
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](numberList1 as list, numberList2 as list) as nullable number

Sobre
Retorna a covariância entre duas listas, numberList1 e numberList2 . numberList1 e numberList2 precisam conter o
mesmo número de valores number .

Exemplo 1
Calcular a covariância entre duas listas.

[Link]({1, 2, 3}, {1, 2, 3})

0.66666666666666607
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](start as date, count as number, step as duration) as list

Sobre
Retorna uma lista de valores date do tamanho count , começando em start . O incremento especificado, step ,
é um valor duration que é adicionado a cada valor.

Exemplo 1
Crie uma lista de 5 valores que comece na véspera do ano novo (#date(2011, 12, 31)) e cujos valores sejam
incrementados em um dia (#duration(1, 0, 0, 0)).

[Link](#date(2011, 12, 31), 5, #duration(1, 0, 0, 0))

31/12/2011 12:00:00 AM

1/1/2012 12:00:00 AM

2/1/2012 12:00:00 AM

3/1/2012 12:00:00 AM

4/1/2012 12:00:00 AM
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](start as datetime, count as number, step as duration) as list

Sobre
Retorna uma lista de valores datetime do tamanho count , começando em start . O incremento especificado,
step , é um valor duration que é adicionado a cada valor.

Exemplo
Criar uma lista de dez valores que começa em cinco minutos antes do primeiro dia do ano [#datetime(2011, 12, 31,
23, 55, 0)] e com um incremento de um minuto [#duration(0, 0, 1, 0)].

[Link](#datetime(2011, 12, 31, 23, 55, 0), 10, #duration(0, 0, 1, 0))

31/12/2011 11:55:00 PM

31/12/2011 11:56:00 PM

31/12/2011 11:57:00 PM

31/12/2011 11:58:00 PM

31/12/2011 11:59:00 PM

1/1/2012 12:00:00 AM

1/1/2012 12:01:00 AM

1/1/2012 12:02:00 AM

1/1/2012 12:03:00 AM

1/1/2012 12:04:00 AM
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](start as datetimezone, count as number, step as duration) as list

Sobre
Retorna uma lista de valores datetimezone do tamanho count , começando em start . O incremento especificado,
step , é um valor duration que é adicionado a cada valor.

Exemplo 1
Crie uma lista de dez valores que comece em 5 minutos antes do dia do ano novo (#datetimezone(2011, 12, 31, 23,
55, 0, -8, 0)) e cujos valores sejam incrementados em um minuto (#duration(0, 0, 1, 0)).

[Link](#datetimezone(2011, 12, 31, 23, 55, 0, -8, 0), 10, #duration(0, 0, 1, 0))

12/31/2011 11:55:00 PM -08:00

12/31/2011 11:56:00 PM -08:00

12/31/2011 11:57:00 PM -08:00

12/31/2011 11:58:00 PM -08:00

12/31/2011 11:59:00 PM -08:00

1/1/2012 12:00:00 AM -08:00

1/1/2012 12:01:00 AM -08:00

1/1/2012 12:02:00 AM -08:00

1/1/2012 12:03:00 AM -08:00

1/1/2012 12:04:00 AM -08:00


[Link]
08/05/2020 • 2 minutes to read

[Link](list1 as list, list2 as list, optional equationCriteria as any) as list

Sobre
Retorna os itens da lista list1 que não aparecem na lista list2 . Há suporte para valores duplicados. Um valor de
critérios de equação opcional, equationCriteria , pode ser especificado para controlar o teste de igualdade.

Exemplo 1
Encontrar os itens da lista {1, 2, 3, 4, 5} que não aparecem em {4, 5, 3}.

[Link]({1, 2, 3, 4, 5}, {4, 5, 3})

Exemplo 2
Encontrar os itens da lista {1, 2} que não aparecem em {1, 2, 3}.

[Link]({1, 2}, {1, 2, 3})


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, optional equationCriteria as any) as list

Sobre
Retorna uma lista que contém todos os valores na lista list com duplicatas removidas. Se a lista estiver vazia, o
resultado será uma lista vazia.

Exemplo 1
Remova as duplicatas da lista {1, 1, 2, 3, 3, 3}.

[Link]({1, 1, 2, 3, 3, 3})

3
[Link]
12/05/2020 • 2 minutes to read

Sintaxe
[Link](start as duration, count as number, step as duration) as list

Sobre
Retorna uma lista de valores count duration , começando em start e incrementada pelo duration step
fornecido.

Exemplo
Criar uma lista de cinco valores que começa em uma hora e com um incremento de uma hora.

[Link](#duration(0, 1, 0, 0), 5, #duration(0, 1, 0, 0))

01:00:00

02:00:00

03:00:00

04:00:00

05:00:00
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, text as text) as list

Sobre
Retorna uma lista de valores da lista list que continha o valor text .

Exemplo 1
Localize os valores de texto da lista {"a", "b", "ab"} que correspondam a "a".

[Link]({"a", "b", "ab"}, "a")

um

ab
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, optional defaultValue as any) as any

Sobre
Retorna o primeiro item da lista list ou o valor padrão opcional, defaultValue , se a lista está vazia. Se a lista
estiver vazia e um valor padrão não for especificado, a função retornará null .

Exemplo 1
Encontrar o primeiro valor da lista {1, 2, 3}.

[Link]({1, 2, 3})

Exemplo 2
Encontrar o primeiro valor da lista {}. Se a lista estiver vazia, retornará -1.

[Link]({}, -1)

-1
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, countOrCondition as any) as any

Sobre
Se um número for especificado, até que esse número de itens seja retornado.
Se uma condição for especificada, serão retornados todos os itens que atendam inicialmente à condição.
Quando um item falha na condição, nenhum outro item é considerado.

Exemplo 1
Localize os valores iniciais na lista {3, 4, 5, -1, 7, 8, 2} que sejam maiores que 0.

[Link]({3, 4, 5, -1, 7, 8, 2}, each _ > 0)

5
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](initial as function, condition as function, next as function, optional selector as
nullable function) as list

Sobre
Gera uma lista de valores com base em quatro funções que geram o valor inicial initial , realizam o teste com
base em uma condição condition e, se o teste é bem-sucedido, selecionam o resultado e geram o próximo valor
next . Um parâmetro opcional, selector , também pode ser especificado.

Exemplo 1
Crie uma lista que comece em 10, permaneça maior que 0 e decremente em 1.

[Link](() => 10, each _ > 0, each _ - 1)

10

Exemplo 2
Gere uma lista de registros contendo x e y, em que x é um valor e y é uma lista. x deve permanecer menor que 10 e
representar o número de itens na lista y. Depois que a lista for gerada, retorne apenas os valores x.
[Link](
() => [x = 1, y = {}],
each [x] < 10,
each [x = [Link]([y]), y = [y] & {x}],
each [x]
)

9
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, index as number, values as list) as list

Sobre
Retorna uma nova lista produzida inserindo os valores de values em list no index . A primeira posição na lista
é no índice 0.
list : A lista de destino em que os valores devem ser inseridos.
index : O índice da lista de destino ( list ) em que os valores devem ser inseridos. A primeira posição na lista é
no índice 0.
values : A lista de valores que devem ser inseridos em list .

Exemplo 1
Inserir a lista ({3, 4}) na lista de destino ({1, 2, 5}) no índice 2.

[Link]({1, 2, 5}, 2, {3, 4})

Exemplo 2
Inserir uma lista com uma lista aninhada ({1, {1.1, 1.2}}) em uma lista de destino ({2, 3, 4}) no índice 0.

[Link]({2, 3, 4}, 0, {1, {1.1, 1.2}})

[Lista]

3
4
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](lists as list, optional equationCriteria as any) as list

Sobre
Retorna a interseção dos valores de lista encontrados na lista de entrada lists . Um parâmetro opcional,
equationCriteria , pode ser especificado.

Exemplo 1
Localize a interseção das listas {1..5}, {2..6}, {3..7}.

[Link]({{1..5}, {2..6}, {3..7}})

5
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, optional equationCriteria as any) as logical

Sobre
Retorna um valor lógico se há duplicatas na lista list ; true se a lista é distinta; false se há valores duplicados.

Exemplo 1
Descobrir se a lista {1, 2, 3} é distinta (ou seja, se não há duplicatas).

[Link]({1, 2, 3})

true

Exemplo 2
Descobrir se a lista {1, 2, 3, 3} é distinta (ou seja, se não há duplicatas).

[Link]({1, 2, 3, 3})

false
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list) as logical

Sobre
Retorna true se a lista, list , não contém valores (comprimento 0). Se a lista contém valores (comprimento > 0),
retorna false .

Exemplo 1
Descubra se a lista {} está vazia.

[Link]({})

true

Exemplo 2
Descubra se a lista {1, 2} está vazia.

[Link]({1, 2})

false
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, optional defaultValue as any) as any

Sobre
Retorna o último item da lista list ou o valor padrão opcional, defaultValue , se a lista está vazia. Se a lista
estiver vazia e um valor padrão não for especificado, a função retornará null .

Exemplo 1
Localizar o último valor da lista {1, 2, 3}.

[Link]({1, 2, 3})

Exemplo 2
Localizar o último valor da lista {} ou -1 se ela estiver vazia.

[Link]({}, -1)

-1
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, optional countOrCondition as any) as any

Sobre
Retorna o último item da lista list . Se a lista estiver vazia, uma exceção será gerada. Essa função usa um
parâmetro opcional, countOrCondition , para dar suporte à coleta de vários itens ou à filtragem de itens.
countOrCondition pode ser especificado de três maneiras:

Se um número for especificado, até que esse número de itens seja retornado.
Se uma condição for especificada, serão retornados todos os itens que atendam inicialmente à condição,
começando no fim da lista. Quando um item falha na condição, nenhum outro item é considerado.
Se esse parâmetro for nulo, o último item da lista será retornado.

Exemplo 1
Localize o último valor da lista {3, 4, 5, -1, 7, 8, 2}.

[Link]({3, 4, 5, -1, 7, 8, 2}, 1)

Exemplo 2
Localize os últimos valores da lista {3, 4, 5, -1, 7, 8, 2} que sejam maiores que 0.

[Link]({3, 4, 5, -1, 7, 8, 2}, each _ > 0)

2
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, condition as function) as logical

Sobre
Retornará true se a função condition, condition , for atendida por todos os valores da lista list , caso contrário,
retornará false .

Exemplo 1
Determine se todos os valores da lista {11, 12, 13} serão maiores que 10.

[Link]({11, 12, 13}, each _ > 10)

true

Exemplo 2
Determine se todos os valores da lista {1, 2, 3} serão maiores que 10.

[Link]({1, 2, 3}, each _ > 10)

false
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, condition as function) as logical

Sobre
Retornará true se a função condition, condition , for atendida por algum dos valores da lista list ; caso
contrário, retornará false .

Exemplo 1
Descubra se algum valor da lista {9, 10, 11} é maior que 10.

[Link]({9, 10, 11}, each _ > 10)

true

Exemplo 2
Descubra se algum valor da lista {1, 2, 3} é maior que 10.

[Link]({1, 2, 3}, each _ > 10)

false
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](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 list ou o valor padrão opcional default , se a lista está vazia. Um valor opcional
de comparisonCriteria, comparisonCriteria , pode ser especificado para determinar como comparar os itens na
lista. Se esse parâmetro for nulo, o comparador padrão será usado.

Exemplo 1
Localize o item máximo da lista {1, 4, 7, 3, -2, 5}.

[Link]({1, 4, 7, 3, -2, 5}, 1)

Exemplo 2
Localize o item máximo da lista {} ou retorne -1, se ela estiver vazia.

[Link]({}, -1)

-1
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, countOrCondition as any, optional comparisonCriteria as any, optional
includeNulls as nullable logical) as list

Sobre
Retorna os valores máximos na lista, list . Depois que as linhas são classificadas, parâmetros opcionais podem
ser especificados para filtrar ainda mais o resultado. O parâmetro opcional, countOrCondition , especifica o número
de valores a serem retornados ou uma condição de filtragem. O parâmetro opcional, comparisonCriteria ,
especifica como comparar valores na lista.
list : Lista de valores.
countOrCondition : Se um número for especificado, uma lista de até countOrCondition itens em ordem crescente
será retornada. Se uma condição for especificada, uma lista de itens que atendam inicialmente à condição será
retornada. Quando um item falha na condição, nenhum outro item é considerado.
comparisonCriteria : [Opcional] Um valor de comparisonCriteria opcional pode ser especificado para
determinar como comparar os itens na lista. Se esse parâmetro for nulo, o comparador padrão será usado.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, optional comparisonCriteria as any) as any

Sobre
Retorna o item mediano da lista list . Essa função retornará null se a lista não contiver valores não null . Se
houver um número par de itens, a função escolherá o menor dos dois itens medianos, a menos que a lista seja
composta inteiramente por datas/horas, durações, números ou horas, caso em que retornará a média dos dois
itens.

Exemplo 1
Localize o item mediano da lista {5, 3, 1, 7, 9} .

[Link]({5, 3, 1, 7, 9})

5
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, optional default as any, optional comparisonCriteria as any, optional
includeNulls as nullable logical) as any

Sobre
Retorna o item mínimo na lista list ou o valor padrão opcional default , se a lista está vazia. Um valor opcional
de comparisonCriteria, comparisonCriteria , pode ser especificado para determinar como comparar os itens na
lista. Se esse parâmetro for nulo, o comparador padrão será usado.

Exemplo 1
Localize o item mínimo da lista {1, 4, 7, 3, -2, 5}.

[Link]({1, 4, 7, 3, -2, 5})

-2

Exemplo 2
Localize o item mínimo da lista {} ou retorne -1, se ela estiver vazia.

[Link]({}, -1)

-1
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, countOrCondition as any, optional comparisonCriteria as any, optional
includeNulls as nullable logical) as list

Sobre
Retorna os valores mínimos na lista list . O parâmetro, countOrCondition , especifica o número de valores a
serem retornados ou uma condição de filtragem. O parâmetro opcional, comparisonCriteria , especifica como
comparar valores na lista.
list : Lista de valores.
countOrCondition : Se um número for especificado, uma lista de até countOrCondition itens em ordem crescente
será retornada. Se uma condição for especificada, uma lista de itens que atendam inicialmente à condição será
retornada. Quando um item falha na condição, nenhum outro item é considerado. Se esse parâmetro for nulo, o
menor valor mínimo da lista será retornado.
comparisonCriteria : [Opcional] Um valor de comparisonCriteria opcional pode ser especificado para
determinar como comparar os itens na lista. Se esse parâmetro for nulo, o comparador padrão será usado.

Exemplo 1
Localize os cinco menores valores da lista {3, 4, 5, -1, 7, 8, 2} .

[Link]({3, 4, 5, -1, 7, 8, 2}, 5)

-1

5
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, optional equationCriteria as any) as any

Sobre
Retorna o item que aparece com mais frequência na lista, list . Se a lista estiver vazia, uma exceção será gerada.
Se vários itens aparecerem com a mesma frequência máxima, o último será escolhido. Um valor de
comparisonCriteria opcional, equationCriteria , pode ser especificado para controlar o teste de igualdade.

Exemplo 1
Localiza o item que aparece com mais frequência na lista, {"A", 1, 2, 3, 3, 4, 5} .

[Link]({"A", 1, 2, 3, 3, 4, 5})

Exemplo 2
Localiza o item que aparece com mais frequência na lista, {"A", 1, 2, 3, 3, 4, 5, 5} .

[Link]({"A", 1, 2, 3, 3, 4, 5, 5})

5
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, optional equationCriteria as any) as list

Sobre
Retorna o item que aparece com mais frequência na lista, list . Se a lista estiver vazia, uma exceção será gerada.
Se vários itens aparecerem com a mesma frequência máxima, o último será escolhido. Um valor de
comparisonCriteria opcional, equationCriteria , pode ser especificado para controlar o teste de igualdade.

Exemplo 1
Localiza os itens que aparecem com mais frequência na lista, {"A", 1, 2, 3, 3, 4, 5, 5} .

[Link]({"A", 1, 2, 3, 3, 4, 5, 5})

5
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list) as number

Sobre
Retorna o número de itens não nulos da lista list .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](start as number, count as number, optional increment as nullable number) as list

Sobre
Retorna uma lista de números de um valor inicial, uma contagem e um valor de incremento opcional. O valor de
incremento padrão é 1.
start : O valor inicial na lista.
count : O número de valores a serem criados.
increment : [opcional] o valor a ser incrementado. Se os valores omitidos forem incrementados em 1.

Exemplo 1
Gere uma lista de 10 números consecutivos começando por 1.

[Link](1, 10)

10

Exemplo 2
Gere uma lista de 10 números começando por 1, com um incremento de 2 para cada número subsequente.
[Link](1, 10, 2)

11

13

15

17

19
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, value as any, optional occurrence as nullable number, optional
equationCriteria as any) as any

Sobre
Retorna o deslocamento no qual o valor value aparece na lista list . Retornará -1 se o valor não for exibido. Um
parâmetro de ocorrência opcional occurrence pode ser especificado.
occurrence : O número máximo de ocorrências a serem relatadas.

Exemplo 1
Localize a posição na lista {1, 2, 3} em que o valor 3 aparece.

[Link]({1, 2, 3}, 3)

2
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, values as list, optional occurrence as nullable number, optional
equationCriteria as any) as any

Sobre
Retorna o deslocamento na lista list da primeira ocorrência de um valor em uma lista values . Retornará -1 se
nenhuma ocorrência for encontrada. Um parâmetro de ocorrência opcional occurrence pode ser especificado.
occurrence : O número máximo de ocorrências que podem ser retornadas.

Exemplo 1
Localize a primeira posição na lista {1, 2, 3} em que o valor 2 ou 3 aparece.

[Link]({1, 2, 3}, {2, 3})

1
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list) as list

Sobre
Retorna uma lista de deslocamentos para a lista de entrada list . Ao usar [Link] para alterar uma lista, a
lista de posições pode ser usada para conceder acesso de transformação à posição.

Exemplo 1
Localize os deslocamentos de valores na lista {1, 2, 3, 4, null, 5}.

[Link]({1, 2, 3, 4, null, 5})

5
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](numbersList as list, optional precision as nullable number) as nullable number

Sobre
Retorna o produto dos números não nulos na lista, numbersList . Retornará nulo se não houver valores não nulos
na lista.

Exemplo 1
Localize o produto dos números na lista {1, 2, 3, 3, 4, 5, 5} .

[Link]({1, 2, 3, 3, 4, 5, 5})

1800
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](count as number, optional seed as nullable number) as list

Sobre
Retorna uma lista de números aleatórios entre 0 e 1, considerando o número de valores a serem gerados e um
valor de semente opcional.
count : O número de valores aleatórios a serem gerados.
seed : [Opcional] um valor numérico usado para propagar o gerador de números aleatórios. Se omitido, uma
lista exclusiva de números aleatórios será gerada cada vez que você chamar a função. Se você especificar o
valor de semente com um número, cada chamada à função gerará a mesma lista de números aleatórios.

Exemplo 1
Crie uma lista de três números aleatórios.

[Link](3)

0,992332

0,132334

0,023592

Exemplo 2
Crie uma lista de três números aleatórios, especificando o valor de semente.

[Link](3, 2)

0,883002

0,245344

0,723212
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, offset as number, optional count as nullable number) as list

Sobre
Retorna um subconjunto da lista começando em um deslocamento list . Um parâmetro opcional, offset , define
o número máximo de itens no subconjunto.

Exemplo 1
Localize o subconjunto começando no deslocamento 6 da lista de números de 1 a 10.

[Link]({1..10}, 6)

10

Exemplo 2
Localize o subconjunto de comprimento 2 no deslocamento 6, na lista de números de 1 a 10.

[Link]({1..10}, 6, 2)

8
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, optional countOrCondition as any) as list

Sobre
Retorna uma lista que remove o primeiro elemento da lista list . Se list for uma lista vazia, uma lista vazia será
retornada. Essa função usa um parâmetro opcional, countOrCondition , para dar suporte à remoção de vários
valores, conforme listado abaixo.
Se um número for especificado, até que esse número de itens seja removido.
Se uma condição for especificada, a lista retornada começará com o primeiro elemento em list que cumpre
os critérios. Quando um item falha na condição, nenhum outro item é considerado.
Se esse parâmetro for nulo, o comportamento padrão será observado.

Exemplo 1
Crie uma lista com base em {1, 2, 3, 4, 5} sem os três primeiros números.

[Link]({1, 2, 3, 4, 5}, 3)

Exemplo 2
Crie uma lista com base em {5, 4, 2, 6, 1} que comece com um número menor que 3.

[Link]({5, 4, 2, 6, 1}, each _ > 3)

1
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list1 as list, list2 as list) as list

Sobre
Remove todas as ocorrências dos valores especificados em list2 de list1 . Se os valores em list2 não
existirem em list1 , a lista original será retornada.

Exemplo 1
Remova os itens na lista {2, 4, 6} da lista {1, 2, 3, 4, 2, 5, 5}.

[Link]({1, 2, 3, 4, 2, 5, 5}, {2, 4, 6})

5
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, optional countOrCondition as any) as list

Sobre
Retorna uma lista que remove os últimos elementos de countOrCondition do final da lista list . Se list tiver
menos de countOrCondition elementos, uma lista vazia será retornada.
Se um número for especificado, até que esse número de itens seja removido.
Se uma condição for especificada, a lista retornada terminará com o primeiro elemento da parte inferior em
list que cumpre os critérios. Quando um item falha na condição, nenhum outro item é considerado.
Se esse parâmetro for nulo, apenas um item será removido.

Exemplo 1
Crie uma lista com base em {1, 2, 3, 4, 5} sem os três últimos números.

[Link]({1, 2, 3, 4, 5}, 3)

Exemplo 2
Crie uma lista com base em {5, 4, 2, 6, 4} que termine com um número menor que 3.

[Link]({5, 4, 2, 6, 4}, each _ > 3)

2
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list1 as list, list2 as list, optional equationCriteria as any) as list

Sobre
Remove todas as ocorrências dos valores especificados em list2 da lista list1 . Se os valores em list2 não
existirem em list1 , a lista original será retornada. Um valor de critérios de equação opcional, equationCriteria ,
pode ser especificado para controlar o teste de igualdade.

Exemplo 1
Crie uma lista em {1, 2, 3, 4, 5, 5} sem {1, 5}.

[Link]({1, 2, 3, 4, 5, 5}, {1, 5})

4
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list) as list

Sobre
Remove todas as ocorrências de valores "null" na list . Se não houver nenhum valor 'nulo' na lista, a lista original
será retornada.

Exemplo 1
Remova os valores "null" na lista {1, 2, 3, null, 4, 5, null, 6}.

[Link]({1, 2, 3, null, 4, 5, null, 6})

6
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, index as number, optional count as nullable number) as list

Sobre
Remove os valores count na list começando na posição especificada, index .

Exemplo 1
Remova três valores na lista {1, 2, 3, 4, -6, -2, -1, 5} começando no índice. 4.

[Link]({1, 2, 3, 4, -6, -2, -1, 5}, 4, 3)

5
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, count as number) as list

Sobre
Retorna uma lista que representa as repetições de count da lista original, list .

Exemplo 1
Criar uma lista que tenha 3 repetições de {1, 2}.

[Link]({1, 2}, 3)

2
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, replacements as list, optional equationCriteria as any) as
list

Sobre
Executa as substituições fornecidas na lista list . Uma operação de substituição replacements consiste em uma
lista de dois valores, o antigo e o novo, fornecidos em uma lista. Um valor de critérios de equação opcional,
equationCriteria , pode ser especificado para controlar o teste de igualdade.

Exemplo 1
Crie uma lista em {1, 2, 3, 4, 5} substituindo o valor 5 por -5 e o valor 1 por -1.

[Link]({1, 2, 3, 4, 5}, {{5, -5}, {1, -1}})

-1

-5
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, index as number, count as number, replaceWith as list) as list

Sobre
Substitui os valores count na list pela lista replaceWith , começando na posição especificada, index .

Exemplo 1
Substitua {7, 8, 9} na lista {1, 2, 7, 8, 9, 5} por {3, 4}.

[Link]({1, 2, 7, 8, 9, 5}, 2, 3, {3, 4})

5
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, oldValue as any, newValue as any, replacer as function) as list

Sobre
Pesquisa em uma lista de valores, list , o valor oldValue e substitui cada ocorrência pelo valor de substituição
newValue .

Exemplo 1
Substitua todos os valores "a" na lista {"a", "B", "a", "a"} por "A".
v [Link]({"a", "B", "a", "a"}, "a", "A", [Link])

<table> <tr><td>A</td></tr> <tr><td>B</td></tr> <tr><td>A</td></tr> <tr><td>A</td></tr> </table>


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list) as list

Sobre
Retorna uma lista com os valores da lista list na ordem inversa.

Exemplo 1
Crie uma lista com base em {1..10} na ordem inversa.

[Link]({1..10})

10

1
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, selection as function) as list

Sobre
Retorna uma lista de valores da lista list , que corresponde à condição de seleção selection .

Exemplo 1
Localize os valores da lista {1, -3, 4, 9, -2} que sejam maiores que 0.

[Link]({1, -3, 4, 9, -2}, each _ > 0)

9
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list) as any

Sobre
Se houver apenas um item na lista list , retornará esse item. Se houver mais de um item ou a lista estiver vazia, a
função gerará uma exceção.

Exemplo 1
Localize o valor único na lista {1}.

[Link]({1})

Exemplo 2
Localize o valor único na lista {1, 2, 3}.

[Link]({1, 2, 3})

[[Link]] There were too many elements in the enumeration to complete the operation.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, optional default as any) as any

Sobre
Se houver apenas um item na lista list , retornará esse item. Se a lista estiver vazia, a função retornará null, a
menos que um default opcional seja especificado. Se houver mais de um item na lista, a função retornará um
erro.

Exemplo 1
Localize o valor único na lista {1}.

[Link]({1})

Exemplo 2
Localize o valor único na lista {}.

[Link]({})

null

Exemplo 3
Localize o valor único na lista {}. Se estiver vazio, retornará -1.

[Link]({}, -1)

-1
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, optional countOrCondition as any) as list

Sobre
Retorna uma lista que ignora o primeiro elemento da lista list . Se list for uma lista vazia, uma lista vazia será
retornada. Essa função usa um parâmetro opcional, countOrCondition , para dar suporte a ignorar vários valores,
conforme listado abaixo.
Se um número for especificado, até que esse número de itens seja ignorado.
Se uma condição for especificada, a lista retornada começará com o primeiro elemento em list que cumpre
os critérios. Quando um item falha na condição, nenhum outro item é considerado.
Se esse parâmetro for nulo, o comportamento padrão será observado.

Exemplo 1
Crie uma lista com base em {1, 2, 3, 4, 5} sem os três primeiros números.

[Link]({1, 2, 3, 4, 5}, 3)

Exemplo 2
Crie uma lista com base em {5, 4, 2, 6, 1} que comece com um número menor que 3.

[Link]({5, 4, 2, 6, 1}, each _ > 3)

1
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, optional comparisonCriteria as any) as list

Sobre
Classifica uma lista de dados, list , de acordo com os critérios opcionais especificados. Um parâmetro opcional,
comparisonCriteria , pode ser especificado como o critério de comparação. Ele pode assumir os seguintes valores:

Para controlar a ordem, o critério de comparação pode ser um valor de enumeração de Ordem. (
[Link] , [Link] ).
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 ( {each 1 / _, [Link]} ).
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. [Link] é um método que pode ser
usado para delegar essa lógica.

Exemplo 1
Classifique a lista {2, 3, 1}.

[Link]({2, 3, 1})

Exemplo 2
Classifique a lista {2, 3, 1} em ordem decrescente.

[Link]({2, 3, 1}, [Link])

1
Exemplo 3
Classifique a lista {2, 3, 1} em ordem decrescente usando o método [Link].

[Link]({2, 3, 1}, (x, y) => [Link](1/x, 1/y))

1
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, pageSize as number) as list

Sobre
Divide o list em uma lista de listas em que o primeiro elemento da lista de saída é uma lista que contém os
primeiros pageSize elementos da lista de origem, o próximo elemento da lista de saída é uma lista que contém os
próximos pageSize elementos da lista de origem etc.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](numbersList as list) as nullable number

Sobre
Retorna uma estimativa baseada em amostra do desvio padrão dos valores na lista, numbersList . Se numbersList
for uma lista de números, um número será retornado. Uma exceção será gerada em uma lista vazia ou em uma
lista de itens que não são do tipo number .

Exemplo 1
Localize o desvio padrão dos números de 1 a 5.

[Link]({1..5})

1.5811388300841898
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, optional precision as nullable number) as any

Sobre
Retorna a soma dos valores não nulos na lista list . Retornará nulo se não houver valores não nulos na lista.

Exemplo 1
Localize a soma dos números na lista {1, 2, 3} .

[Link]({1, 2, 3})

6
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](start as time, count as number, step as duration) as list

Sobre
Retorna uma lista de valores time do tamanho count , começando em start . O incremento especificado, step ,
é um valor duration que é adicionado a cada valor.

Exemplo 1
Crie uma lista de quatro valores começando ao meio-dia (#time(12, 0, 0)) e cujos valores sejam incrementados em
uma hora (#duration(0, 1, 0, 0)).

[Link](#time(12, 0, 0), 4, #duration(0, 1, 0, 0))

12:00:00

13:00:00

14:00:00

15:00:00
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, transform as function) as list

Sobre
Retorna uma nova lista de valores aplicando a função transform transform à lista list .

Exemplo 1
Adicione 1 a cada valor na lista {1, 2}.

[Link]({1, 2}, each _ + 1)

3
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, collectionTransform as function, resultTransform as function) as
list

Sobre
Retorna uma lista cujos elementos são projetados com base na lista de entrada. A função collectionTransform é
aplicada a cada elemento e a função resultTransform é invocada para criar a lista resultante. O
collectionSelector tem a assinatura (x como Qualquer) = >... em que x é um elemento na lista. O
resultTransform projeta a forma do resultado e tem a assinatura (x como Qualquer, y como Qualquer) = >... em
que x é o elemento na lista e y é o elemento obtido aplicando o collectionTransform a esse elemento.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](lists as list, optional equationCriteria as any) as list

Sobre
Usa uma lista de listas lists , une os itens nas listas individuais e os retorna na lista de saída. Como resultado, a
lista retornada contém todos os itens em listas de entrada. Essa operação mantém a semântica da bolsa tradicional,
portanto, valores duplicados são combinados como parte da União. Um valor de critérios de equação opcional,
equationCriteria , pode ser especificado para controlar o teste de igualdade.

Exemplo 1
Crie uma união da lista {1..5}, {2..6}, {3..7}.

[Link]({{1..5}, {2..6}, {3..7}})

7
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](lists as list) as list

Sobre
Utiliza uma lista de listas, lists , e retorna uma lista de listas, combinando itens na mesma posição.

Exemplo 1
Compacta as duas listas simples {1, 2} e {3, 4}.

[Link]({{1, 2}, {3, 4}})

[Lista]

[Lista]

Exemplo 2
Compacta as duas listas simples de comprimentos diferentes {1, 2} e {3}.

[Link]({{1, 2}, {3}})

[Lista]

[Lista]
Funções lógicas
08/05/2020 • 2 minutes to read

Essas funções criam e manipulam valores lógicos (ou seja, true/false).

Lógico
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna um valor lógico de um valor.

[Link] Retorna um valor lógico de true ou false de um valor de texto.

[Link] Retorna um valor de texto de um valor lógico.


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any) as nullable logical

Sobre
Retorna um valor logical do value especificado. Se o value fornecido for null , [Link] retornará null .
Se o value fornecido for logical , value será retornado.
Os valores dos seguintes tipos podem ser convertidos em um valor logical :
text : Um valor de logical do valor de texto, seja "true" ou "false" . Confira [Link] para obter
detalhes.
number : false se value é igual a 0 , true caso contrário.

Se value for de qualquer outro tipo, um erro será retornado.

Exemplo 1
Converter 2 em um valor logical .

[Link](2)

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text) as nullable logical

Sobre
Cria um valor lógico com base no valor de texto text , "true" ou "false". Se text contiver uma cadeia de caracteres
diferente, uma exceção será gerada. O valor de texto text não diferencia maiúsculas de minúsculas.

Exemplo 1
Crie um valor lógico da cadeia de caracteres de texto "true".

[Link]("true")

true

Exemplo 2
Crie um valor lógico da cadeia de caracteres de texto "a".

[Link]("a")

[[Link]] Could not convert to a logical.


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](logicalValue as nullable logical) as nullable text

Sobre
Cria um valor de texto com base no valor lógico logicalValue , true ou false . Se logicalValue não for um valor
lógico, uma exceção será gerada.

Exemplo 1
Crie um valor de texto com base no true lógico.

[Link](true)

"true"
Funções numéricas
08/05/2020 • 6 minutes to read

Essas funções criam e manipulam valores numéricos.

Número
Constantes
F UN Ç Ã O DESC RIÇ Ã O

Number.E Retorna 2,7182818284590451, o valor de e até 16 dígitos


decimais.

[Link] Retorna o menor número possível.

[Link] Representa 0/0.

[Link] Representa -1/0.

[Link] Retorna 3,1415926535897931, o valor de Pi de até 16 dígitos


decimais.

[Link] Representa 1/0.

Informações
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna true se um valor é um número par.

[Link] Retorna true se um valor é [Link].

[Link] Retorna true se um valor é um número ímpar.

Conversão e formatação
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna um valor numérico de inteiro de 8 bits do valor


especificado.

[Link] Retorna um valor de moeda de um determinado valor.

[Link] Retorna um valor numérico decimal do valor especificado.

[Link] Retorna um valor de número duplo do valor especificado.

[Link] Retorna um valor numérico de inteiro de 8 bits com sinal do


valor especificado.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna um valor numérico de inteiro de 16 bits do valor


especificado.

[Link] Retorna um valor numérico de inteiro de 32 bits do valor


especificado.

[Link] Retorna um valor numérico de inteiro de 64 bits do valor


especificado.

[Link] Retorna um valor numérico de um valor.

[Link] Retorna um valor numérico de um valor de texto.

[Link] Retorna um valor de texto de um valor numérico.

[Link] Retorna um valor de percentual de um determinado valor.

[Link] Retorna um valor numérico único do valor especificado.

Arredondamento
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna um número anulável (n) se o valor é um inteiro.

[Link] Retorna [Link](value) quando valor >= 0 e


[Link](value) quando valor < 0.

[Link] Retorna o maior número inteiro inferior ou igual a um valor


numérico.

[Link] Retorna [Link](x) quando x >= 0 e


[Link](x) quando x < 0.

[Link] Retorna o número inteiro maior ou igual a um valor numérico.

Operações
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna o valor absoluto de um número.

[Link] Retorna o número de combinações de um determinado


número de itens para o tamanho de combinação opcional.

[Link] Retorna um número que representa e elevado a uma potência.

[Link] Retorna o fatorial de um número.

[Link] Divide dois números e retorna a parte inteira do número


resultante.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna o logaritmo natural de um número.

[Link] Retorna o logaritmo de um número para a base.

Number.Log10 Retorna o logaritmo de base 10 de um número.

[Link] Divide dois números e retorna o restante do número


resultante.

[Link] Retorna o número total de permutações de um determinado


número de itens para o tamanho de permuta opcional.

[Link] Retorna um número elevado por uma potência.

[Link] Retorna 1 para números positivos,-1 para números negativos


ou 0 para zero.

[Link] Retorna a raiz quadrada de um número.

Random
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna um número fracionário aleatório entre 0 e 1.

[Link] Retorna um número aleatório entre os dois valores numéricos


fornecidos.

Trigonometria
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna o arco cosseno de um número.

[Link] Retorna o arco seno de um número.

[Link] Retorna o arco tangente de um número.

Number.Atan2 Retorna o arco tangente da divisão de dois números.

[Link] Retorna o cosseno de um número.

[Link] Retorna o cosseno hiperbólico de um número.

[Link] Retorna o seno de um número.

[Link] Retorna o seno hiperbólico de um número.

[Link] Retorna a tangente de um número.

[Link] Retorna a tangente hiperbólica de um número.


Bytes
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna o resultado de uma operação AND bit a bit nos


operandos fornecidos.

[Link] Retorna o resultado de uma operação NOT bit a bit nos


operandos fornecidos.

[Link] Retorna o resultado de uma operação OR bit a bit nos


operandos fornecidos.

[Link] Retorna o resultado de uma operação de deslocamento à


esquerda bit a bit nos operandos.

[Link] Retorna o resultado de uma operação de deslocamento à


direita bit a bit nos operandos.

[Link] Retorna o resultado de uma operação XOR bit a bit nos


operandos fornecidos.

VA LO RES DE PA RÂ M ET RO S DESC RIÇ Ã O

[Link] [Link]

[Link] [Link]

[Link] [Link]

[Link] [Link]

[Link] [Link]
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional culture as nullable text, optional roundingMode as nullable
number) as nullable number

Sobre
Retorna um valor number > inteiro de 8 bits do value especificado. Se o value > fornecido for null , [Link]
retornará null . Se o value especificado for number dentro do intervalo do inteiro de 8 bits sem uma parte
fracionária, value será retornado. Se ele tiver uma parte fracionária, o número será arredondado com o modo de
arredondamento especificado. O modo de arredondamento padrão é [Link] . Se o value fornecido
for de qualquer outro tipo, confira [Link] para convertê-lo no valor number ; portanto, a instrução
anterior sobre a conversão do valor number no valor number inteiro de 8 bits é aplicável. Confira [Link]
para ver os modos de arredondamento disponíveis. Uma culture opcional também pode ser fornecida (por
exemplo, "pt-BR").

Exemplo 1
Obter o valor number inteiro de 8 bits de "4" .

[Link]("4")

Exemplo 2
Obter o valor number inteiro de 8 bits de "4.5" usando [Link] .

[Link]("4.5", null, [Link])

=
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional culture as nullable text, optional roundingMode as nullable
number) as nullable number

Sobre
Retorna um valor currency do value especificado. Se o value fornecido for null , [Link] retornará
null . Se o value especificado for number dentro do intervalo de moeda, a parte fracionária do value será
arredondada para quatro dígitos decimais e retornada. Se o value fornecido for de qualquer outro tipo, confira
[Link] para convertê-lo no valor number ; portanto, a instrução anterior sobre a conversão do valor
number no valor currency é aplicável. O intervalo válido para a moeda é -922,337,203,685,477.5808 para
922,337,203,685,477.5807 . Confira [Link] para obter os modos de arredondamento disponíveis. O padrão é
[Link] . Uma culture opcional também pode ser fornecida (por exemplo, "pt-BR").

Exemplo 1
Obtenha o valor currency de "1.23455" .

[Link]("1.23455")

1.2346

Exemplo 2
Obtenha o valor currency de "1.23455" usando [Link] .

[Link]("1.23455", "en-Us", [Link])

1.2345
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional culture as nullable text) as nullable number

Sobre
Retorna um valor number Decimal do value especificado. Se o value fornecido for null , [Link] retornará
null . Se o value fornecido for number dentro do intervalo de Decimal, value será retornado; caso contrário, um
erro será retornado. Se o value fornecido for de qualquer outro tipo, confira [Link] para convertê-lo no
valor number ; portanto, a instrução anterior sobre a conversão do valor number no valor number Decimal é
aplicável. Uma culture opcional também pode ser fornecida (por exemplo, "pt-BR").

Exemplo 1
Obter o valor de number Decimal de "4.5" .

[Link]("4.5")

4.5
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional culture as nullable text) as nullable number

Sobre
Retorna um valor number Double do value especificado. Se o value fornecido for null , [Link] retornará
null . Se o value fornecido for number dentro do intervalo de Double, value será retornado; caso contrário, um
erro será retornado. Se o value fornecido for de qualquer outro tipo, confira [Link] para convertê-lo no
valor number ; portanto, a instrução anterior sobre a conversão do valor number no valor number Double é
aplicável. Uma culture opcional também pode ser fornecida (por exemplo, "pt-BR").

Exemplo 1
Obter o valor number Double de "4" .

[Link]("4.5")

4.5
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional culture as nullable text, optional roundingMode as nullable
number) as nullable number

Sobre
Retorna um valor number inteiro com sinal de 8 bits do value especificado. Se o value fornecido for null ,
[Link] retornará null . Se o value especificado for number dentro do intervalo do inteiro com sinal de 8 bits
sem uma parte fracionária, value será retornado. Se ele tiver uma parte fracionária, o número será arredondado
com o modo de arredondamento especificado. O modo de arredondamento padrão é [Link] . Se o
value fornecido for de qualquer outro tipo, confira [Link] para convertê-lo no valor number ; portanto,
a instrução anterior sobre a conversão do valor number no valor number inteiro com sinal de 8 bits é aplicável.
Confira [Link] para obter os modos de arredondamento disponíveis. Uma culture opcional também pode
ser fornecida (por exemplo, "pt-BR").

Exemplo 1
Obter o valor number inteiro com sinal de 8 bits de "4" .

[Link]("4")

Exemplo 2
Obter o valor number inteiro com sinal de 8 bits de "4.5" usando [Link] .

[Link]("4.5", null, [Link])

5
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional culture as nullable text, optional roundingMode as nullable
number) as nullable number

Sobre
Retorna um valor number inteiro de 16 bits do value especificado. Se o value fornecido for null , [Link]
retornará null . Se o value especificado for number dentro do intervalo do inteiro de 16 bits sem uma parte
fracionária, value será retornado. Se ele tiver uma parte fracionária, o número será arredondado com o modo de
arredondamento especificado. O modo de arredondamento padrão é [Link] . Se o value fornecido
for de qualquer outro tipo, confira [Link] para convertê-lo no valor number ; portanto, a instrução
anterior sobre a conversão do valor number no valor number inteiro de 16 bits é aplicável. Confira [Link]
para obter os modos de arredondamento disponíveis. Uma culture opcional também pode ser fornecida (por
exemplo, "pt-BR").

Exemplo 1
Obter o valor number inteiro de 16 bits de "4" .

[Link]("4")

Exemplo 2
Obter o valor number inteiro de 16 bits de "4.5" usando [Link] .

[Link]("4.5", null, [Link])

5
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional culture as nullable text, optional roundingMode as nullable
number) as nullable number

Sobre
Retorna um valor number inteiro de 32 bits do value especificado. Se o value fornecido for null , [Link]
retornará null . Se o value especificado for number dentro do intervalo do inteiro de 32 bits sem uma parte
fracionária, value será retornado. Se ele tiver uma parte fracionária, o número será arredondado com o modo de
arredondamento especificado. O modo de arredondamento padrão é [Link] . Se o value fornecido
for de qualquer outro tipo, confira [Link] para convertê-lo no valor number ; portanto, a instrução
anterior sobre a conversão do valor number no valor number inteiro de 32 bits é aplicável. Confira [Link]
para obter os modos de arredondamento disponíveis. Uma culture opcional também pode ser fornecida (por
exemplo, "pt-BR").

Exemplo 1
Obter o valor number inteiro de 32 bits de "4" .

[Link]("4")

Exemplo 2
Obter o valor number inteiro de 32 bits de "4.5" usando [Link] .

[Link]("4.5", null, [Link])

5
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional culture as nullable text, optional roundingMode as nullable
number) as nullable number

Sobre
Retorna um valor number inteiro de 64 bits do value especificado. Se o value fornecido for null , [Link]
retornará null . Se o value especificado for number dentro do intervalo do inteiro de 64 bits sem uma parte
fracionária, value será retornado. Se ele tiver uma parte fracionária, o número será arredondado com o modo de
arredondamento especificado. O modo de arredondamento padrão é [Link] . Se o value fornecido
for de qualquer outro tipo, confira [Link] para convertê-lo no valor number ; portanto, a instrução
anterior sobre a conversão do valor number no valor number inteiro de 64 bits é aplicável. Confira [Link]
para obter os modos de arredondamento disponíveis. Uma culture opcional também pode ser fornecida (por
exemplo, "pt-BR").

Exemplo 1
Obter o valor number inteiro de 64 bits de "4" .

[Link]("4")

Exemplo 2
Obter o valor number inteiro de 64 bits de "4.5" usando [Link] .

[Link]("4.5", null, [Link])

5
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number) as nullable number

Sobre
Retorna o valor absoluto de number . Se number for nulo, [Link] retornará nulo.
number : Um number para o qual o valor absoluto deve ser calculado.

Exemplo 1
Valor absoluto de -3.

[Link](-3)

3
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number) as nullable number

Sobre
Retorna o arco cosseno de number .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number) as nullable number

Sobre
Retorna o arco seno de number .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number) as nullable number

Sobre
Retorna o arco tangente de number .
Number.Atan2
09/05/2020 • 2 minutes to read

Sintaxe
Number.Atan2(y as nullable number, x as nullable number) as nullable number

Sobre
Retorna o arco tangente da divisão dos dois números. y e x . A divisão será interpretada como y /x.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number1 as nullable number, number2 as nullable number) as nullable number

Sobre
Retorna o resultado da execução de uma operação bit a bit "And" entre number1 e number2 .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as any) as any

Sobre
Retorna o resultado da execução de uma operação bit a bit "Not" em number .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number1 as nullable number, number2 as nullable number) as nullable number

Sobre
Retorna o resultado da execução de uma operação bit a bit "Or" entre number1 e number2 .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number1 as nullable number, number2 as nullable number) as nullable number

Sobre
Retorna o resultado da execução de um deslocamento bit a bit para a esquerda em number1 , com base no número
especificado de bits number2 .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number1 as nullable number, number2 as nullable number) as nullable
number

Sobre
Retorna o resultado da execução de um deslocamento bit a bit para a direita em number1 , com base no número
especificado de bits number2 .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number1 as nullable number, number2 as nullable number) as nullable number

Sobre
Retorna o resultado da execução de uma operação bit a bit "XOR" (Exclusive-OR) entre number1 e number2 .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](setSize as nullable number, combinationSize as nullable number) as nullable
number

Sobre
Retorna o número de combinações exclusivas de uma lista de itens, setSize , com o tamanho de combinação
especificado, combinationSize .
setSize : O número de itens na lista.
combinationSize : O número de itens em cada combinação.

Exemplo 1
Localize o número de combinações de um total de cinco itens quando cada combinação for um grupo de 3.

[Link](5, 3)

10
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number) as nullable number

Sobre
Retorna o cosseno de number .

Exemplo 1
Localize o cosseno do ângulo 0.

[Link](0)

1
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number) as nullable number

Sobre
Retorna o cosseno hiperbólico de number .
Number.E
09/05/2020 • 2 minutes to read

Sobre
Uma constante que representa 2,7182818284590451, o valor de e até 16 dígitos decimais.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um valor de constante que representa ao menor número positivo que um número de ponto flutuante pode conter.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number) as nullable number

Sobre
Retorna o resultado da elevação de e à potência de number (função exponencial).
number : Um number para o qual a função exponencial deve ser calculada. Se number for nulo, [Link]
retornará nulo.

Exemplo 1
Eleva e à potência 3.

[Link](3)

20.085536923187668
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number) as nullable number

Sobre
Retorna o fatorial do número number .

Exemplo 1
Localize o fatorial 10.

[Link](10)

3628800
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional culture as nullable text) as nullable number

Sobre
Retorna um valor number do value especificado. Uma culture opcional também pode ser fornecida (por
exemplo, "pt-BR"). Se o value fornecido for null , [Link] retornará null . Se o value fornecido for
number , value será retornado. Os valores dos seguintes tipos podem ser convertidos em um valor number :

text : Um valor number da representação textual. Os formatos de texto comuns são tratados ("15", "3.423,10",
"5.0E-10"). Confira [Link] para obter detalhes.
logical : 1 para true , 0 para false .
datetime : Um número de ponto flutuante de precisão dupla que contém uma data de Automação OLE
equivalente.
datetimezone : Um número de ponto flutuante de precisão dupla que contém uma data de Automação OLE
equivalente da data e hora local de value .
date : Um número de ponto flutuante de precisão dupla que contém uma data de Automação OLE equivalente.
time : Expresso em dias fracionários.
duration : Expresso em dias inteiros e fracionários.

Se value for de qualquer outro tipo, um erro será retornado.

Exemplo 1
Obtenha o valor number de "4" .

[Link]("4")

Exemplo 2
Obtenha o valor number de #datetime(2020, 3, 20, 6, 0, 0) .

[Link](#datetime(2020, 3, 20, 6, 0, 0))

43910.25

Exemplo 3
Obtenha o valor number de "12.3%" .
[Link]("12.3%")

0.123
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, optional culture as nullable text) as nullable number

Sobre
Retorna um valor number do valor de texto especificado, text .
text : A representação textual de um valor numérico. A representação deve estar em um formato de número
comum – "15", "3423,10", "5.0E-10".
culture : Uma cultura opcional que controla como text é interpretada (por exemplo, "pt-BR").

Exemplo 1
Obter o valor numérico de "4" .

[Link]("4")

Exemplo 2
Obter o valor numérico de "5.0e-10" .

[Link]("5.0e-10")

5E-10
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number1 as nullable number, number2 as nullable number, optional precision as
nullable number) as nullable number

Sobre
Retorna a parte inteira do resultado da divisão de um número, number1 , por outro número, number2 . Se number1
ou number2 for nulo, [Link] retornará nulo.
number1 : O dividendo.
number2 : O divisor.

Exemplo 1
Divide 6 por 4.

[Link](6, 4)

Exemplo 2
Divide 8,3 por 3.

[Link](8.3, 3)

2
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as number) as logical

Sobre
Indica se o valor, number , é par retornando true se for par, caso contrário, false .

Exemplo 1
Verifique se 625 é um número par.

[Link](625)

false

Exemplo 2
Verifique se 82 é um número par.

[Link](82)

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as number) as logical

Sobre
Indica se o valor é NaN (e não um número). Retorna true se number for equivalente a [Link] , false caso
contrário.

Exemplo 1
Verifique se 0 dividido por 0 é NaN.

[Link](0/0)

true

Exemplo 2
Verifique se 1 dividido por 0 é NaN.

[Link](1/0)

false
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as number) as logical

Sobre
Indica se o valor é ímpar. Retorna true se number for um número ímpar, false caso contrário.

Exemplo 1
Verifique se 625 é um número ímpar.

[Link](625)

true

Exemplo 2
Verifique se 82 é um número ímpar.

[Link](82)

false
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number) as nullable number

Sobre
Retorna o logaritmo natural de um número, number . Se number for nulo, [Link] retornará nulo.
####Exemplo 1 Obtenha o logaritmo natural 15.

[Link](15)

2.70805020110221
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number, optional base as nullable number) as nullable number

Sobre
Retorna o logaritmo de um número, number , para a base base especificada. Se base não for especificado, o valor
padrão será Number.E. Se number for nulo, [Link] retornará nulo.

Exemplo 1
Obtém o logaritmo de base 10 de 2.

[Link](2, 10)

0.3010299956639812

Exemplo 2
Obtém o logaritmo de base e de 2.

[Link](2)

0.69314718055994529
Number.Log10
09/05/2020 • 2 minutes to read

Sintaxe
Number.Log10(number as nullable number) as nullable number

Sobre
Retorna o logaritmo de base 10 de um número, number . Se number for nulo, Number.Log10 retornará nulo.

Exemplo 1
Obtém o logaritmo de base 10 de 2.

Number.Log10(2)

0.3010299956639812
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number, divisor as nullable number, optional precision as nullable
number) as nullable number

Sobre
Retorna o resto resultante da divisão de número inteiro de number por divisor . Se number ou divisor for nulo,
[Link] retornará nulo.

number : O dividendo.
divisor : O divisor.

Exemplo 1
Localize o resto ao dividir 5 por 3.

[Link](5, 3)

2
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um valor de constante que representa 0 dividido por 0.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um valor de constante que representa -1 dividido por 0.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](setSize as nullable number, permutationSize as nullable number) as nullable
number

Sobre
Retorna o número de permutações que podem ser geradas com base em um número de itens, setSize , com um
tamanho de permutação especificado, permutationSize .

Exemplo 1
Localize o número de permutações em um total de cinco itens em grupos de três.

[Link](5, 3)

60
[Link]
09/05/2020 • 2 minutes to read

Sobre
Uma constante que representa 3,1415926535897932, o valor de pi até 16 dígitos decimais.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um valor de constante que representa 1 dividido por 0.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number, power as nullable number) as nullable number

Sobre
Retorna o resultado da geração de number à potência de power . Se number ou power for nulo, [Link]
retornará nulo.
number : A base.
power : O expoente.

Exemplo 1
Localize o valor 5 elevado à potência de 3 (5 ao cubo).

[Link](5, 3)

125
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link]() as number

Sobre
Retorna um número aleatório entre 0 e 1.

Exemplo 1
Obtenha um número aleatório.

[Link]()

0.919303
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](bottom as number, top as number) as number

Sobre
Retorna um número aleatório entre bottom e top .

Exemplo 1
Obtenha um número aleatório entre 1 e 5.

[Link](1, 5)

2.546797
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number, optional digits as nullable number, optional roundingMode
as nullable number) as nullable number

Sobre
Retorna o resultado do arredondamento de number para o número mais próximo. Se number for nulo,
[Link] retornará nulo. number é arredondado para o número inteiro mais próximo, a menos que o
parâmetro opcional digits seja especificado. Se digits for especificado, number será arredondado para o
digits número de dígitos decimais. Um parâmetro opcional roundingMode especifica a direção do
arredondamento quando há um vínculo entre os números possíveis de arredondar (confira [Link]
para obter os valores possíveis).

Exemplo 1
Arredonde 1,234 para o próximo número inteiro.

[Link](1.234)

Exemplo 2
Arredonde 1,56 para o próximo número inteiro.

[Link](1.56)

Exemplo 3
Arredonde 1,2345 para duas casas decimais.

[Link](1.2345, 2)

1.23

Exemplo 4
Arredonde 1,2345 para três casas decimais (arredondamento para cima).

[Link](1.2345, 3, [Link])
1.235

Exemplo 5
Arredonde 1,2345 para três casas decimais (arredondamento para baixo).

[Link](1.2345, 3, [Link])

1.234
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number, optional digits as nullable number) as
nullable number

Sobre
Retornará o resultado de arredondar number com base no sinal do número. Essa função arredondará números
positivos para cima e números negativos para baixo. Se digits for especificado, number será arredondado para o
digits número de dígitos decimais.

Exemplo 1
Arredonde o número -1,2 em direção oposta a zero.

[Link](-1.2)

-2

Exemplo 2
Arredonde o número 1,2 em direção oposta a zero.

[Link](1.2)

Exemplo 3
Arredonda o número -1,234 em duas casas decimais após o zero.

[Link](-1.234, 2)

-1.24
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number, optional digits as nullable number) as nullable number

Sobre
Retorna o resultado do arredondamento number até o número inteiro mais alto anterior. Se number for nulo,
[Link] retornará nulo. Se digits for especificado, number será arredondado para o digits número
de dígitos decimais.

Exemplo 1
Arredondar 1,234 para baixo, de modo que se torne um número inteiro.

[Link](1.234)

Exemplo 2
Arredondar 1,999 para baixo, de modo que se torne um número inteiro.

[Link](1.999)

Exemplo 3
Arredondar 1,999 para duas casas decimais.

[Link](1.999, 2)

1.99
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number, optional digits as nullable number) as nullable
number

Sobre
Retornará o resultado de arredondar number com base no sinal do número. Essa função arredondará números
positivos para baixo e números negativos para cima. Se digits for especificado, number será arredondado para o
digits número de dígitos decimais.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number, optional digits as nullable number) as nullable number

Sobre
Retorna o resultado do arredondamento number até o número inteiro mais alto anterior. Se number for nulo,
[Link] retornará nulo. Se digits for especificado, number será arredondado para o digits número
de dígitos decimais.

Exemplo 1
Arredondar 1,234 para cima de modo que se torne um número inteiro.

[Link](1.234)

Exemplo 2
Arredondar 1,999 para cima de modo que se torne um número inteiro.

[Link](1.999)

Exemplo 3
Arredondar 1,234 para duas casas decimais.

[Link](1.234, 2)

1.24
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number) as nullable number

Sobre
Retornará 1 se number for um número positivo,-1 se for um número negativo e 0 se for zero. Se number for nulo,
[Link] retornará nulo.

Exemplo 1
Determina o sinal de 182.

[Link](182)

Exemplo 2
Determina o sinal de -182.

[Link](-182)

-1

Exemplo 3
Determina o sinal de 0.

[Link](0)

0
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number) as nullable number

Sobre
Retorna o seno de number .

Exemplo 1
Localize o seno do ângulo 0.

[Link](0)

0
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number) as nullable number

Sobre
Retorna o seno hiperbólico de number .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number) as nullable number

Sobre
Retorna a raiz quadrada de number . Se number for nulo, [Link] retornará nulo. Se for um valor negativo,
[Link] será retornado (não é um número).

Exemplo 1
Localize a raiz quadrada de 625.

[Link](625)

25

Exemplo 2
Localize a raiz quadrada de 85.

[Link](85)

9.2195444572928871
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number) as nullable number

Sobre
Retorna a tangente de number .

Exemplo 1
Localize a tangente do ângulo 1.

[Link](1)

1.5574077246549023
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number) as nullable number

Sobre
Retorna a tangente hiperbólica de number .
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number, optional format as nullable text, optional culture as
nullable text) as nullable text

Sobre
Formata o valor numérico number em um valor de texto de acordo com o formato especificado por format . O
formato é um código de caractere único, opcionalmente seguido por um especificador de precisão de número. Os
códigos de caracteres a seguir podem ser usados para format .
"D" ou "d": (Decimal) Formata o resultado como dígitos inteiros. O especificador de precisão controla o número
de dígitos na saída.
"E" ou "e": (Exponencial [científico]) Notação exponencial. O especificador de precisão controla o número
máximo de dígitos decimais (o padrão é 6).
"F" ou "f": (Ponto fixo) Dígitos inteiros e decimais.
"G" ou "g": (Geral) A forma mais compacta de um ponto fixo ou científico.
"N" ou "n": (Número) Dígitos inteiros e decimais com separadores de grupo e um separador decimal.
"P" ou "p": (Percentual) Número multiplicado por 100 e exibido com um símbolo de porcentagem.
"R" ou "r": (Viagem de ida e volta) Um valor de texto que pode fazer uma viagem de ida e volta de um número
idêntico. O especificador de precisão é ignorado.
"X" ou "x": (Hexadecimal) Um valor de texto hexadecimal.
Uma culture opcional também pode ser fornecida (por exemplo, "pt-BR").

Exemplo 1
Formatar um número como texto sem formato especificado.

[Link](4)

"4"

Exemplo 2
Formatar um número como texto em formato Exponencial.

[Link](4, "e")

"4.000000e+000"

Exemplo 3
Formatar um número como texto em formato Decimal com precisão limitada.
[Link](-0.1234, "P1")

"-12.3 %"
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional culture as nullable text) as nullable number

Sobre
Retorna um valor percentage do value especificado. Se o value fornecido for null , [Link] retornará
null . Se o value fornecido for text com um símbolo de porcentagem à direita, o número decimal convertido
será retornado. Caso contrário, confira [Link] para convertê-lo no valor number . Uma culture opcional
também pode ser fornecida (por exemplo, "pt-BR").

Exemplo 1
Obtenha o valor percentage de "12.3%" .

[Link]("12.3%")

0.123
[Link]
09/05/2020 • 2 minutes to read

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sobre
[Link]
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional culture as nullable text) as nullable number

Sobre
Retorna um valor number Single do value especificado. Se o value fornecido for null , [Link] retornará
null . Se o value fornecido for number dentro do intervalo de Single, value será retornado; caso contrário, um
erro será retornado. Se o value fornecido for de qualquer outro tipo, confira [Link] para convertê-lo no
valor number ; portanto, a instrução anterior sobre a conversão do valor number no valor number Single é
aplicável. Uma culture opcional também pode ser fornecida (por exemplo, "pt-BR").

Exemplo 1
Obter o valor number Single de "1.5" .

[Link]("1.5")

1.5
Funções de registro
08/05/2020 • 4 minutes to read

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

Registro
Informações
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna o número de campos em um registro.

[Link] Retornará true se houver nomes do campo em um registro.

Transformações
F UN Ç Ã O DESC RIÇ Ã O

[Link] Adiciona um campo de um valor e nome de campo.

[Link] Combina os registros em uma lista.

[Link] Retorna um novo registro que reordena os campos


especificados em relação uns aos outros. Todos os campos não
especificados permanecem em seus locais originais.

[Link] Retorna um novo registro que renomeia os campos


especificados. Os campos resultantes reterão sua ordem
original. Essa função dá suporte à troca e ao encadeamento
de nomes de campo. No entanto, todos os nomes de destino
mais os nomes de campo restantes devem constituir um
conjunto exclusivo ou ocorrerá um erro.

[Link] Retorna um novo registro que reordena os campos em relação


uns aos outros. Todos os campos não especificados
permanecem em seus locais originais. Requer dois campos ou
mais.

[Link] Transforma campos aplicando transformOperations. Para obter


mais informações sobre valores com suporte do
transformOperations, confira Valores de parâmetro.

Seleção
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna o valor do campo fornecido. Essa função pode ser


usada para criar dinamicamente a sintaxe de pesquisa de
campo para um determinado registro. Dessa forma, é um
versão dinâmica da sintaxe record[field].
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna uma lista de nomes de campo na ordem dos campos


do registro.

[Link] Retorna o valor de um campo de um registro ou o valor


padrão se o campo não existe.

[Link] Retorna uma lista de valores de campo na ordem dos campos


do registro.

[Link] Retorna um novo registro que contém os campos


selecionados do registro de entrada. A ordem original dos
campos é mantida.

Serialização
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna um registro de acordo com uma lista de valores de


campos e um conjunto de campos.

[Link] Retorna um registro de uma tabela de registros contendo


nomes de campo e de valores.

[Link] Retorna uma lista de valores que contêm valores de campo do


registro de entrada.

[Link] Retorna uma tabela de registros contendo nomes de campo e


de valores de um registro de entrada.

Valores do parâmetro
As definições de tipo a seguir são usadas para descrever os valores de parâmetro referenciados em funções de
Registro acima.

Opção MissingField [Link] = 0;

[Link] = 1;

[Link] = 2;

Operações de transformação As operações de transformação podem ser especificadas por


qualquer um dos seguintes valores:

Um valor de lista de dois itens, sendo o primeiro item o nome


do campo e o segundo item a função de transformação
aplicada a esse campo para produzir um novo valor.

Uma lista de transformações pode ser fornecida informando


um valor de lista e sendo cada item o valor de lista de dois
itens, conforme descrito acima.

Para obter exemplos, confira a descrição de


[Link]
Operações de renomear As operações de renomear para um registro podem ser
especificadas como uma das opções:

Uma única operação de renomear, representada por uma lista


de dois nomes de campo, antigo e novo.

Para obter exemplos, confira a descrição de


[Link].
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um parâmetro opcional nas funções de registro e de tabela indicando que os campos ausentes devem resultar em
erro. (Esse é o valor do parâmetro padrão.)
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um parâmetro opcional nas funções de registro e de tabela indicando que os campos ausentes serão ignorados.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um parâmetro opcional nas funções de registro e de tabela indicando que os campos ausentes serão incluídos
como valores nulos.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](record as record, fieldName as text, value as any, optional delayed as nullable
logical) as record

Sobre
Adiciona um campo a um registro record do nome do campo fieldName e do valor value .

Exemplo 1
Adicionar o campo Endereço ao registro.

[Link]([CustomerID = 1, Name = "Bob", Phone = "123-4567"], "Address", "123 Main St.")

C USTO M ERID 1

NOME Bob

T EL EF O N E 123-4567

EN DEREÇ O 123 Main St.


[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](records as list) as record

Sobre
Combina os registros na lista especificada records . Se o records contiver valores que não são de registro, um
erro será retornado.

Exemplo 1
Criar um registro combinado dos registros.

[Link]({
[CustomerID = 1, Name = "Bob"],
[Phone = "123-4567"]
})

C USTO M ERID 1

NOME Bob

T EL EF O N E 123-4567
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](record as record, field as text) as any

Sobre
Retorna o valor do field especificado no record . Se o campo não for encontrado, uma exceção será gerada.

Exemplo 1
Localizar o valor do campo " CustomerID " no registro.

[Link]([CustomerID = 1, Name = "Bob", Phone = "123-4567"], "CustomerID")

1
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](record as record) as number

Sobre
Retorna o número de campos no registro record .

Exemplo 1
Localizar o número de campos no registro.

[Link]([CustomerID = 1, Name = "Bob"])

2
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](record as record) as list

Sobre
Retorna os nomes dos campos no registro record como texto.

Exemplo 1
Localizar os nomes dos campos no registro.

[Link]([OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100.0])

OrderID

CustomerID

Item

Preço
[Link]
21/05/2020 • 2 minutes to read

Sintaxe
[Link](record as nullable record, field as text, optional defaultValue as any) as
any

Sobre
Retorna o valor do campo especificado field em um registro record . Se o campo não for encontrado, o
defaultValue opcional será retornado.

Exemplo 1
Localizar o valor do campo "Phone" no registro ou retornar nulo, caso não exista.

[Link]([CustomerID = 1, Name = "Bob"], "Phone")

null

Exemplo 2
Localizar o valor do campo "Phone" no registro ou retornar o padrão, caso não exista.

[Link]([CustomerID = 1, Name = "Bob"], "Phone", "123-4567")

"123-4567"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](record as record) as list

Sobre
Retorna uma lista dos valores de campo no registro record .

Exemplo 1
Localizar os valores de campo no registro.

[Link]([CustomerID = 1, Name = "Bob", Phone = "123-4567"])

Bob

123-4567
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, fields as any) as record

Sobre
Retorna um registro de acordo com uma list de valores de campos e um conjunto de campos. O fields pode
ser especificado por uma lista de valores de texto ou um tipo de registro. Um erro será gerado se os campos não
forem exclusivos.

Exemplo 1
Crie um registro com base em uma lista de valores de campos e uma lista de nomes de campos.

[Link]({1, "Bob", "123-4567"}, {"CustomerID", "Name", "Phone"})

C USTO M ERID 1

NOME Bob

T EL EF O N E 123-4567

Exemplo 2
Crie um registro com base em uma lista de valores de campos e um tipo de registro.

[Link]({1, "Bob", "123-4567"}, type [CustomerID = number, Name = text, Phone = number])

C USTO M ERID 1

NOME Bob

T EL EF O N E 123-4567
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table) as record

Sobre
Retorna um registro de uma tabela de registros table contendo nomes de campo e nomes de valores
{[Name = name, Value = value]} . Uma exceção será gerada se os nomes de campo não forem exclusivos.

Exemplo 1
Criar um registro da tabela no formato [Link]({[Name = "CustomerID", Value = 1], [Name = "Name",
Value = "Bob"], [Name = "Phone", Value = "123-4567"]}).

[Link](
[Link]({
[Name = "CustomerID", Value = 1],
[Name = "Name", Value = "Bob"],
[Name = "Phone", Value = "123-4567"]
})
)

C USTO M ERID 1

NOME Bob

T EL EF O N E 123-4567
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](record as record, fields as any) as logical

Sobre
Indica se o registro record tem os campos especificados em fields , retornando um valor lógico (true ou false).
Diversos valores de campo podem ser especificados usando uma lista.

Exemplo 1
Verificar se o registro tem o campo "CustomerID".

[Link]([CustomerID = 1, Name = "Bob", Phone = "123-4567"], "CustomerID")

true

Exemplo 2
Verificar se o registro tem os campos "CustomerID" e "Address".

[Link]([CustomerID = 1, Name = "Bob", Phone = "123-4567"], {"CustomerID", "Address"})

false
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](record as record, fields as any, optional missingField as nullable number) as
record

Sobre
Retorna um registro que remove todos os campos especificados na lista fields da entrada record . Se o campo
especificado não existir, uma exceção será gerada.

Exemplo 1
Remover o campo "Price" do registro.

[Link]([CustomerID = 1, Item = "Fishing rod", Price = 18.00], "Price")

C USTO M ERID 1

IT EM Vara de pescar

Exemplo 2
Remover os campos "Price" e "Item" do registro.

[Link]([CustomerID = 1, Item = "Fishing rod", Price = 18.00], {"Price", "Item"})

C USTO M ERID 1
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](record as record, renames as list, optional missingField as nullable number)
as record

Sobre
Retorna um registro após alterar o nome dos campos no record de entrada para os novos nomes de campo
especificados na lista renames . Para várias alterações de nome, uma lista aninhada pode ser usada ({ {old1, new1},
{old2, new2} }.

Exemplo 1
Renomear o campo "UnitPrice" para "Price" no registro.

[Link](
[OrderID = 1, CustomerID = 1, Item = "Fishing rod", UnitPrice = 100.0],
{"UnitPrice", "Price"}
)

O RDERID 1

C USTO M ERID 1

IT EM Vara de pescar

P REÇ O 100

Exemplo 2
Renomear o campo "UnitPrice" para "Price" e "OrderNum" para "OrderID" no registro.

[Link](
[OrderNum = 1, CustomerID = 1, Item = "Fishing rod", UnitPrice = 100.0],
{
{"UnitPrice", "Price"},
{"OrderNum", "OrderID"}
}
)

O RDERID 1

C USTO M ERID 1

IT EM Vara de pescar
P REÇ O 100
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](record as record, fieldOrder as list, optional missingField as nullable
number) as record

Sobre
Retorna um registro após reordenar os campos em record na ordem dos campos especificados na lista
fieldOrder . Os valores de campo são mantidos e os campos não listados no fieldOrder são deixados em sua
posição original.

Exemplo 1
Reordene alguns dos campos do registro.

[Link](
[CustomerID = 1, OrderID = 1, Item = "Fishing rod", Price = 100.0],
{"OrderID", "CustomerID"}
)

O RDERID 1

C USTO M ERID 1

IT EM Vara de pescar

P REÇ O 100
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](record as record, fields as any, optional missingField as nullable number) as
record

Sobre
Retorna um registro que inclui somente os campos especificados na lista fields da entrada record .

Exemplo 1
Selecionar os campos "Item" e "Price" no registro.

[Link](
[OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100.0],
{"Item", "Price"}
)

IT EM Vara de pescar

P REÇ O 100
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](record as record) as list

Sobre
Retorna uma lista de valores que contêm valores de campo da entrada record .

Exemplo 1
Extraia os valores de campo de um registro.

[Link]([A = 1, B = 2, C = 3])

3
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](record as record) as table

Sobre
Retorna uma tabela que contém as colunas Name e Value com uma linha para cada campo em record .

Exemplo 1
Retornar a tabela do registro.

[Link]([OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100.0])

NOME VA LO R

OrderID 1

CustomerID 1

Item Vara de pescar

Preço 100
[Link]
21/05/2020 • 2 minutes to read

Sintaxe
[Link](record as record, transformOperations as list, optional missingField as
nullable number) as record

Sobre
Retorna um registro após aplicar as transformações especificadas na lista transformOperations para record . Um
ou mais campos podem ser transformados em um determinado momento.
Caso um único campo esteja sendo transformado, espera-se que transformOperations seja uma lista com dois itens.
O primeiro item em transformOperations especifica um nome de campo e o segundo item em transformOperations
especifica a função a ser usada para a transformação. Por exemplo, {"Quantity", [Link]}
No caso de vários campos estarem sendo transformados, espera-se que transformOperations seja uma lista de listas,
em que cada lista interna é um par de nome de campo e operação de transformação. Por exemplo,
{{"Quantity",[Link]},{"UnitPrice", [Link]}}

Exemplo 1
Converte o campo "Price" em número.

[Link](
[OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = "100.0"],
{"Price", [Link]}
)

O RDERID 1

C USTO M ERID 1

IT EM Vara de pescar

P REÇ O 100

Exemplo 2
Converte os campos "OrderID" e "Price" em números.

[Link](
[OrderID = "1", CustomerID = 1, Item = "Fishing rod", Price = "100.0"],
{{"OrderID", [Link]}, {"Price", [Link]}}
)

O RDERID 1
C USTO M ERID 1

IT EM Vara de pescar

P REÇ O 100
Funções de substituto
08/05/2020 • 2 minutes to read

Essas funções são usadas por outras funções na biblioteca para substituir um determinado valor.

Substituto
F UN Ç Ã O DESC RIÇ Ã O

[Link] Essa função é fornecida para [Link] ou


[Link] para substituir valores de texto em valores
de lista e tabela, respectivamente.

[Link] Essa função é fornecida para [Link] ou


[Link] para substituir valores em valores de lista e
tabela, respectivamente.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, old as text, new as text) as nullable text

Sobre
Substitui o texto de old no original pelo texto de
text new . Essa função de substituto pode ser usada em
[Link] e [Link] .

Exemplo 1
Substitua o texto "oL" por "Ol" na cadeia de caracteres "oLá, mundo".

[Link]("hEllo world", "hE", "He")

"Hello world"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, old as any, new as any) as any

Sobre
Substitui o valor old no original pelo valor
value new . Essa função de substituto pode ser usada em
[Link] e [Link] .

Exemplo 1
Substitua o valor 11 pelo valor 10.

[Link](11, 11, 10)

10
Funções de divisor
08/05/2020 • 2 minutes to read

Essas funções dividem o texto.

Divisor
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna uma função que não oferece divisão, retornando seu
argumento como uma única lista de elementos.

[Link] Retorna uma função que divide o texto em uma lista de texto
de acordo com uma transição de um tipo de caractere para
outro.

[Link] Retorna uma função que divide o texto por qualquer


delimitador com suporte.

[Link] Retorna uma função que dividirá o texto de acordo com um


delimitador.

[Link] Retorna uma função que divide o texto por cada delimitador
por vez.

[Link] Retorna uma função que divide o texto de acordo com os


comprimentos especificados.

[Link] Retorna uma função que divide o texto de acordo com as


posições especificadas.

[Link] Retorna uma função que divide o texto de acordo com os


intervalos especificados.

[Link] Retorna uma função que divide o texto em uma lista de texto
após o comprimento especificado repetidamente.

[Link] Retorna uma função que divide o texto de acordo com o


espaço em branco.

VA LO RES DE PA RÂ M ET RO S DESC RIÇ Ã O

[Link] Caracteres de aspas indicam o início de uma cadeia de


caracteres entre aspas. Aspas aninhadas são indicadas por
dois caracteres de aspas.

[Link] Os caracteres de aspas não têm significado.


[Link]
09/05/2020 • 2 minutes to read

Sobre
Caracteres de aspas indicam o início de uma cadeia de caracteres entre aspas. Aspas aninhadas são indicadas por
dois caracteres de aspas.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Os caracteres de aspas não têm significado.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link]() as function

Sobre
Retorna uma função que não oferece divisão, retornando seu argumento como uma única lista de elementos.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](delimiters as list, optional quoteStyle as nullable number,
optional startAtEnd as nullable logical) as function

Sobre
Retorna uma função que divide o texto em uma lista de texto em qualquer delimitador especificado.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](before as anynonnull, after as anynonnull) as function

Sobre
Retorna uma função que divide o texto em uma lista de texto de acordo com uma transição de um tipo de caractere
para outro. Os parâmetros before e after podem ser uma lista de caracteres ou uma função que usa um
caractere e retorna true/false.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](delimiter as text, optional quoteStyle as nullable number) as
function

Sobre
Retorna uma função que divide o texto em uma lista de texto de acordo com o delimitador especificado.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](delimiters as list, optional quoteStyle as nullable number,
optional startAtEnd as nullable logical) as function

Sobre
Retorna uma função que divide o texto em uma lista de texto em cada delimitador especificado sequencialmente.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](lengths as list, optional startAtEnd as nullable logical) as function

Sobre
Retorna uma função que divide o texto em uma lista de texto por cada comprimento especificado.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](positions as list, optional startAtEnd as nullable logical) as
function

Sobre
Retorna uma função que divide o texto em uma lista de texto em cada posição especificada.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](ranges as list, optional startAtEnd as nullable logical) as function

Sobre
Retorna uma função que divide o texto em uma lista de texto de acordo com os deslocamentos e comprimentos
especificados.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](length as number, optional startAtEnd as nullable logical) as
function

Sobre
Retorna uma função que divide o texto em uma lista de texto após o comprimento especificado repetidamente.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](optional quoteStyle as nullable number) as function

Sobre
Retorna uma função que divide o texto em uma lista de texto em espaço em branco.
Funções de tabela
09/05/2020 • 27 minutes to read

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

Construção de tabela
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna o AST para o corpo de uma função.

[Link] Um nó AST que representa o item em uma expressão de item.

[Link] Retorna um AST que representa acesso a uma coluna em uma


expressão de linha.

[Link] Retorna o AST para o corpo de uma função.

[Link] Um nó AST representando a linha em uma expressão de linha.

[Link] Retorna uma tabela de uma lista contendo listas aninhadas


com os nomes e os valores de coluna.

[Link] Converte uma lista em tabela aplicando a função de divisão


especificada a cada item da lista.

[Link] Retorna uma tabela de uma lista de registros.

[Link] Cria uma tabela da lista em que cada elemento da lista é uma
lista que contém os valores de coluna para uma única linha.

[Link] Retorna uma tabela com uma coluna que contém o valor
fornecido ou a lista de valores.

[Link] Agrupa as linhas de uma tabela pelos valores com


correspondência difusa na coluna especificada para cada linha.

[Link] Une as linhas das duas tabelas com correspondência difusa


com base nas chaves fornecidas.

[Link] Executa uma junção difusa entre as tabelas nas colunas


fornecidas e insere o resultado da junção em uma nova
coluna.

[Link] Divide a tabela especificada em uma lista de tabelas usando o


tamanho da página especificado.

[Link] Cria ou estende uma tabela com manipuladores definidos pelo


usuário para operações de consulta e ação.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Cria uma função que pode ser interceptada por um


manipulador definido em uma exibição (por meio de
[Link] ).

Conversões
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna uma lista das listas aninhadas, cada uma


representando uma coluna de valores na tabela de entrada.

[Link] Retorna uma tabela em lista aplicando a função de


combinação especificada a cada linha de valores em uma
tabela.

[Link] Retorna uma lista de registros de uma tabela de entrada.

[Link] Retorna uma lista aninhada de valores de linha de uma tabela


de entrada.

Informações
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna o número de colunas em uma tabela.

[Link] Retornará true se a tabela não contiver nenhuma linha.

[Link] Retorna um perfil das colunas de uma tabela.

[Link] Retorna o número de linhas em uma tabela.

[Link] Retorna uma tabela contendo uma descrição das colunas (ou
seja, o esquema) da tabela especificada.

[Link] Retorna os relacionamentos entre um conjunto de tabelas.

Operações de linha
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna uma tabela que contém um padrão alternado das


linhas de uma tabela.

[Link] Retorna uma tabela que é o resultado da mesclagem de uma


lista de tabelas. Todas as tabelas devem ter a mesma estrutura
de tipo de linha.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna uma tabela que contém apenas as linhas com o texto
especificado dentro de uma de suas células ou de qualquer
parte dela.

[Link] Retorna a primeira linha de uma tabela.

[Link] Retorna as primeiras linhas de uma tabela, dependendo do


parâmetro countOrCondition.

[Link] Retorna a primeira coluna da primeira linha da tabela ou um


valor padrão especificado.

[Link] Retorna uma tabela que é o resultado da combinação de um


conjunto de tabelas particionadas em novas colunas. O tipo
da coluna pode, opcionalmente, ser especificado; o padrão é
Qualquer.

[Link] Retorna uma tabela com a lista de linhas inseridas na tabela


em um índice. Cada linha a ser inserida deve corresponder ao
tipo de linha da tabela.

[Link] Retorna a última linha de uma tabela.

[Link] Retorna as últimas linhas de uma tabela, dependendo do


parâmetro countOrCondition.

[Link] Retornará true se todas as linhas em uma tabela cumprirem


uma condição.

[Link] Retornará true se alguma das linhas em uma tabela


cumprirem uma condição.

[Link] Particiona a tabela em uma lista de grupos de número de


tabelas com base no valor da coluna de cada linha e uma
função de hash. A função de hash é aplicada ao valor da
coluna de uma linha para obter um valor de hash para a linha.
Os grupos de módulos de valor de hash determinam em quais
tabelas retornadas a linha será colocada.

[Link] Retorna o número especificado de linhas de uma tabela que


começa em um deslocamento.

[Link] Retorna uma tabela com o número especificado de linhas


removidas da tabela começando na primeira linha. O número
de linhas removidas depende do parâmetro opcional
countOrCondition.

[Link] Retorna uma tabela com o número especificado de linhas


removidas da tabela começando na última linha. O número de
linhas removidas depende do parâmetro opcional
countOrCondition.

[Link] Retorna uma tabela com o número especificado de linhas


removidas da tabela começando em um deslocamento.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna uma tabela com todas as linhas removidas da tabela


que contêm um erro em pelo menos uma das células em uma
linha.

[Link] Retorna uma tabela que contém as linhas da tabela repetidas


o número de vezes da contagem.

[Link] Retorna uma tabela na qual as linhas que começam em um


deslocamento e continuam para a contagem são substituídas
pelas linhas fornecidas.

[Link] Retorna uma tabela com as linhas na ordem inversa.

[Link] Retorna uma tabela que contém apenas as linhas que


correspondem a uma condição.

[Link] Retorna uma tabela apenas com as linhas da tabela que


contêm um erro em pelo menos uma das células em uma
linha.

[Link] Retorna uma única linha de uma tabela.

[Link] Retorna uma tabela que não contém a primeira linha ou as


primeiras linhas da tabela.

Operações de coluna
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna os valores de uma coluna em uma tabela.

[Link] Retorna os nomes das colunas de uma tabela.

[Link] Retorna uma lista com os nomes das colunas que


correspondem aos tipos especificados.

[Link] Rebaixa a linha de cabeçalho para a primeira linha de uma


tabela.

[Link] Duplica uma coluna com o nome especificado. Os valores e o


tipo são copiados da coluna de origem.

[Link] Retornará true se uma tabela tiver a coluna ou as colunas


especificadas.

[Link] Dada uma tabela e uma coluna de atributo contendo


pivotValues, cria novas colunas para cada um dos valores
dinâmicos e atribui a eles valores de valueColumn. Uma
aggregationFunction opcional pode ser fornecida para lidar
com várias ocorrências do mesmo valor de chave na coluna de
atributo.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna uma tabela em que todas as colunas sejam prefixadas


um valor de texto.

[Link] Promove a primeira linha da tabela em seus nomes de


cabeçalho ou coluna.

[Link] Retorna uma tabela sem uma ou mais colunas específicas.

[Link] Retorna uma tabela com colunas específicas em uma ordem


relativa umas às outras.

[Link] Retorna uma tabela com as colunas renomeadas conforme


especificado.

[Link] Retorna uma tabela que contém apenas colunas específicas.

[Link] Transforma nomes de colunas ao usar a função fornecida.

[Link] Dada uma lista de colunas de tabela, transforma essas colunas


em pares de atributo/valor.

[Link] Converte todas as colunas que não sejam um conjunto


especificado em pares de atributo/valor, combinados com o
restante dos valores em cada linha.

Parâmetros
VA LO RES DE PA RÂ M ET RO S DESC RIÇ Ã O

[Link] Um valor possível para o parâmetro opcional JoinKind no


[Link] . A tabela resultante de uma junção interna
contém uma linha para cada par de linhas das tabelas
especificadas que foram determinadas para correspondência
com base nas colunas de chave especificadas.

[Link] Um valor possível para o parâmetro opcional JoinKind no


[Link] . Uma junção externa esquerda garante que
todas as linhas da primeira tabela sejam exibidas no resultado.

[Link] Um valor possível para o parâmetro opcional JoinKind no


[Link] . Uma junção externa direita garante que todas
as linhas da segunda tabela sejam exibidas no resultado.

[Link] Um valor possível para o parâmetro opcional JoinKind no


[Link] . Uma junção externa completa garante que
todas as linhas de ambas as tabelas sejam exibidas no
resultado. As linhas que não tiveram uma correspondência na
outra tabela são unidas com uma linha padrão que contém
valores nulos para todas as colunas.
VA LO RES DE PA RÂ M ET RO S DESC RIÇ Ã O

[Link] Um valor possível para o parâmetro opcional JoinKind no


[Link] . Uma antijunção esquerda retorna todas as
linhas da primeira tabela que não têm uma correspondência
na segunda tabela.

[Link] Um valor possível para o parâmetro opcional JoinKind no


[Link] . Uma antijunção direita retorna todas as linhas
da segunda tabela que não têm uma correspondência na
primeira tabela.

[Link] Um parâmetro opcional nas funções de registro e de tabela


indicando que os campos ausentes devem resultar em erro.
(Esse é o valor do parâmetro padrão.)

[Link] Um parâmetro opcional nas funções de registro e de tabela


indicando que os campos ausentes serão ignorados.

[Link] Um parâmetro opcional nas funções de registro e de tabela


indicando que os campos ausentes serão incluídos como
valores nulos.

[Link] [Link]

[Link] [Link]

[Link] Se a função de divisor retornar mais colunas do que o


esperado pela tabela, elas serão coletadas em uma lista.

[Link] Se a função de divisor retornar mais colunas do que o


esperado pela tabela, elas serão ignoradas.

[Link] Se a função de divisor retornar mais colunas do que o


esperado pela tabela, um erro será gerado.

[Link] [Link]

[Link] [Link]

[Link] [Link]

[Link] [Link]

[Link] [Link]

[Link] [Link]

[Link] [Link]

[Link] Especifica a tabela à esquerda de uma junção.

[Link] Especifica a tabela à direita de uma junção.


Transformation
Parâmetros para opções de Grupo
[Link] = 0;
[Link] = 1;
Parâmetros para tipos de Junção
[Link] = 0;
[Link] = 1;
[Link] = 2;
[Link] = 3;
[Link] = 4;
[Link] = 5
Algoritmo de Junção
Os seguintes valores de JoinAlgorithm podem ser especificados para [Link]

[Link] 0,

[Link] 1,

[Link] 2,

[Link] 3,

[Link] 4,

[Link] 5,

[Link] 6,

VA LO RES DE PA RÂ M ET RO S DESC RIÇ Ã O

[Link] Especifica a tabela à esquerda de uma junção.

[Link] Especifica a tabela à direita de uma junção.

Dados de exemplo
Os exemplos nesta seção usam as tabelas a seguir.
Tabela de clientes

Customers = [Link]({

[CustomerID = 1, Name = "Bob", Phone = "123-4567"],

[CustomerID = 2, Name = "Jim", Phone = "987-6543"],

[CustomerID = 3, Name = "Paul", Phone = "543-7890"],

[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]

Tabela de pedidos

Orders = [Link]({

[OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100.0],

[OrderID = 2, CustomerID = 1, Item = "1 lb. worms", Price = 5.0],

[OrderID = 3, CustomerID = 2, Item = "Fishing net", Price = 25.0],

[OrderID = 4, CustomerID = 3, Item = "Fish tazer", Price = 200.0],

[OrderID = 5, CustomerID = 3, Item = "Bandaids", Price = 2.0],

[OrderID = 6, CustomerID = 1, Item = "Tackle box", Price = 20.0],

[OrderID = 7, CustomerID = 5, Item = "Bait", Price = 3.25],

[OrderID = 8, CustomerID = 5, Item = "Fishing Rod", Price = 100.0],

[OrderID = 9, CustomerID = 6, Item = "Bait", Price = 3.25]

})

F UN Ç Ã O DESC RIÇ Ã O

[Link] Adiciona uma coluna chamada newColumnName a uma


tabela.

[Link] Retorna uma tabela com uma nova coluna com um nome
específico que, para cada linha, contém um índice da linha na
tabela.

[Link] Executa uma junção aninhada entre table1 e table2 de colunas


específicas e produz o resultado de junção como uma coluna
newColumnName para cada linha da table1.

[Link] Adicione uma chave à tabela.

[Link] Agrega tabelas aninhadas em uma coluna específica em várias


colunas que contêm valores de agregação para essas tabelas.

[Link] [Link] mescla colunas usando uma função de


combinação para produzir uma nova coluna.
[Link] é o inverso de [Link].
F UN Ç Ã O DESC RIÇ Ã O

[Link] Dada uma coluna de listas em uma tabela, crie a cópia de uma
linha para cada valor na lista.

[Link] Expande uma coluna de registros em colunas com cada um


dos valores.

[Link] Expande uma coluna de registros ou uma coluna de tabelas


em várias colunas na tabela que as contém.

[Link] Substitui valores nulos na coluna ou nas colunas especificadas


da tabela com o valor não nulo mais recente na coluna.

[Link] Retorna uma tabela da tabela especificada em que o valor da


próxima célula é propagado para as células de valor nulo
acima na coluna especificada.

[Link]

[Link] Agrupa linhas de tabela pelos valores de colunas de chave


para cada linha.

[Link] Une as linhas da tabela1 com as linhas da tabela2 com base


na igualdade dos valores das colunas de chave selecionadas
por tabela1, chave1 e tabela2, chave2.

[Link] Retorna uma lista de nomes de coluna de chave de uma


tabela.

[Link] Une as linhas das tabelas com base na igualdade das chaves.
Os resultados são inseridos em uma nova coluna.

[Link] Substitui os valores de erro nas colunas especificadas com o


valor especificado correspondente.

[Link] Retorna uma nova tabela com o novo conjunto de


informações de chave no argumento keys.

[Link]

[Link] Substitui oldValue por newValue em colunas específicas de


uma tabela, usando a função de substituto fornecida, como
[Link] ou [Link].

[Link] Retorna um novo conjunto de colunas de uma única coluna


aplicando uma função de divisor a cada valor.

[Link] Transforma colunas de uma tabela usando uma função.

[Link] Transforma os tipos de coluna de uma tabela usando um tipo.

[Link] Transforma as linhas de uma tabela usando uma função de


transformação.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna uma tabela com colunas convertidas em linhas e


linhas convertidas em colunas da tabela de entrada.

Associação
Parâmetros para verificações de associação
Especificação de ocorrência

[Link] = 0

[Link] = 1

[Link] = 2

F UN Ç Ã O DESC RIÇ Ã O

[Link] Determina se o registro a aparece como uma linha na tabela.

[Link] Determina se todos os registros especificados serão exibidos


como linhas na tabela.

[Link] Determina se algum dos registros especificados será exibido


como linhas na tabela.

[Link] Remove linhas duplicadas de uma tabela, garantindo que


todas as linhas restantes sejam distintas.

[Link] Determina se uma tabela contém apenas linhas distintas.

[Link] Determina a posição ou as posições de uma linha em uma


tabela.

[Link] Determina uma ou mais posições de qualquer linha


especificada na tabela.

[Link] Remove todas as ocorrências de linhas de uma tabela.

[Link] Substitui linhas específicas de uma tabela pelas novas linhas.

Ordering
Dados de exemplo
Os exemplos nesta seção usam as tabelas a seguir.
Tabela Funcionários
Employees = [Link](

{[Name="Bill", Level=7, Salary=100000],

[Name="Barb", Level=8, Salary=150000],

[Name="Andrew", Level=6, Salary=85000],

[Name="Nikki", Level=5, Salary=75000],

[Name="Margo", Level=3, Salary=45000],

[Name="Jeff", Level=10, Salary=200000]},

type table [

Name = text,

Level = number,

Salary = number

])

F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna a maior linha ou as maiores linhas de uma tabela


usando um comparisonCriteria.

[Link] Retorna as N maiores linhas de uma tabela. Depois que as


linhas são classificadas, o parâmetro countOrCondition deve
ser especificado para filtrar melhor o resultado.

[Link] Retorna a menor linha ou as menores linhas de uma tabela


usando um comparisonCriteria.

[Link] Retorna as N menores linhas na tabela especificada. Depois


que as linhas são classificadas, o parâmetro countOrCondition
deve ser especificado para filtrar melhor o resultado.

[Link] Classifica as linhas em uma tabela usando um


comparisonCriteria ou uma ordenação padrão se uma não foi
especificada.

Outros
F UN Ç Ã O DESC RIÇ Ã O

[Link] Armazena uma tabela em buffer na memória, isentando-a de


alterações externas durante a avaliação.

Valores do parâmetro
Como dar nome a colunas de saída
Esse parâmetro é uma lista de valores de texto especificando os nomes de coluna da tabela resultante. Esse
parâmetro geralmente é usado nas funções de construção de tabela, como [Link] e [Link].
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. Confira ordem de classificação na seção
valores de parâmetro acima.
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. [Link] é um método que pode
ser usado para delegar essa lógica.
Para obter exemplos, confira a descrição de [Link].
Critérios de contagem ou condição
Geralmente, esses critérios são usados em operações de ordenação ou de linha. Eles determinam o número de
linhas retornadas na tabela e podem usar duas formas, um número ou uma condição:
Um número indica quantos valores retornar embutidos com a função apropriada
Se uma condição for especificada, as linhas que contêm valores que atendem inicialmente à condição serão
retornadas. Quando um valor falha na condição, não são considerados outros valores.
Confira [Link] ou [Link].
Manipulação de valores extras
Isso é usado para indicar como a função deve tratar valores adicionais em uma linha. Esse parâmetro é
especificado como um número, que é mapeado para as opções abaixo.

[Link] = 0

[Link] = 1

[Link] = 2

Para obter mais informações, confira [Link].


Manipulação de coluna ausente
Isso é usado para indicar como a função deve tratar colunas ausentes. Esse parâmetro é especificado como um
número, que é mapeado para as opções abaixo.

[Link] = 0;

[Link] = 1;

[Link] = 2;

Isso é usado em operações de coluna ou transformação. Para obter exemplos, confira [Link].
Ordem de classificação
Isso é usado para indicar como os resultados devem ser classificados. Esse parâmetro é especificado como um
número, que é mapeado para as opções abaixo.
[Link] = 0

[Link] = 1

Critérios de equação
Os critérios de equação para tabelas podem ser especificados como
Um valor de função que é
Um seletor de chave que determina a coluna na tabela a aplicar os critérios de igualdade ou
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.
Uma lista das colunas na tabela para aplicar os critérios de igualdade
Para obter exemplos, confira a descrição de [Link].
[Link]
09/05/2020 • 2 minutes to read

Sobre
Se a função de divisor retornar mais colunas do que o esperado pela tabela, um erro será gerado.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Se a função de divisor retornar mais colunas do que o esperado pela tabela, elas serão ignoradas.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Se a função de divisor retornar mais colunas do que o esperado pela tabela, elas serão coletadas em uma lista.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Sintaxe
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sobre
Sintaxe
[Link]

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](function as function) as record

Sobre
Retorna a AST do corpo de function , normalizado em uma expressão de item:
A função deve ser um lambda de 1 argumento.
Todas as referências ao parâmetro de função são substituídas por [Link] .
A AST será simplificada para conter apenas nós dos tipos:
Constant
Invocation
Unary
Binary
If
FieldAccess
NotImplemented

Um erro será gerado se uma AST de expressão de item não puder ser retornada para o corpo de function .

Exemplo 1
Retorna o AST do corpo da função each _ <> null

[Link](each _ <> null)

T IP O Binário

O P ERA DO R NotEquals

ESQ UERDA [Registro]

DIREITA [Registro]
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um nó AST que representa o item em uma expressão de item.
[Link]
09/05/2020 • 2 minutes to read

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um valor possível para o parâmetro opcional JoinKind no [Link] . Uma junção externa completa garante que
todas as linhas de ambas as tabelas sejam exibidas no resultado. As linhas que não tiveram uma correspondência
na outra tabela são unidas com uma linha padrão que contém valores nulos para todas as colunas.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um valor possível para o parâmetro opcional JoinKind no [Link] . A tabela resultante de uma junção interna
contém uma linha para cada par de linhas das tabelas especificadas que foram determinadas para correspondência
com base nas colunas de chave especificadas.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um valor possível para o parâmetro opcional JoinKind no [Link] . Uma antijunção esquerda retorna todas as
linhas da primeira tabela que não têm uma correspondência na segunda tabela.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um valor possível para o parâmetro opcional JoinKind no [Link] . Uma junção externa esquerda garante que
todas as linhas da primeira tabela sejam exibidas no resultado.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um valor possível para o parâmetro opcional JoinKind no [Link] . Uma antijunção direita retorna todas as
linhas da segunda tabela que não têm uma correspondência na primeira tabela.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um valor possível para o parâmetro opcional JoinKind no [Link] . Uma junção externa direita garante que
todas as linhas da segunda tabela sejam exibidas no resultado.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Especifica a tabela à esquerda de uma junção.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Especifica a tabela à direita de uma junção.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Uma lista de posições de todas as ocorrências dos valores encontrados é retornada.
[Link]
09/05/2020 • 2 minutes to read

Sobre
A posição da primeira ocorrência do valor encontrado é retornada.
[Link]
09/05/2020 • 2 minutes to read

Sobre
A posição da última ocorrência do valor encontrado é retornada.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Tipo de função que classifica a lista em ordem crescente.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Tipo de função que classifica a lista em ordem decrescente.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](columnName as text) as record

Sobre
Retorna um AST que representa acesso à coluna columnName da linha em uma expressão de linha.
Exemplo 1
Cria um AST representando o acesso da coluna "CustomerName".

[Link]("CustomerName")

T IP O FieldAccess

EXP RESSÃ O [Registro]

M EM B ERN A M E CustomerName
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](function as function) as record

Sobre
Retorna a AST do corpo de function , normalizado em uma expressão de linha:
A função deve ser um lambda de 1 argumento.
Todas as referências ao parâmetro de função são substituídas por [Link] .
Todas as referências a colunas são substituídas por [Link](columnName) .
A AST será simplificada para conter apenas nós dos tipos:
Constant
Invocation
Unary
Binary
If
FieldAccess
NotImplemented

Um erro será gerado se uma AST de expressão de linha não puder ser retornada para o corpo de function .
Exemplo 1
Retorna o AST para o corpo da função each [CustomerID] = "ALFKI"

[Link](each [CustomerName] = "ALFKI")

T IP O Binário

O P ERA DO R Igual a

ESQ UERDA [Registro]

DIREITA [Registro]
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um nó AST representando a linha em uma expressão de linha.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, newColumnName as text, columnGenerator as function, optional
columnType as nullable type) as table

Sobre
Adiciona uma coluna denominada newColumnName à tabela table . Os valores da coluna são computados por meio
da função de seleção especificada columnGenerator com cada linha assumida como entrada.

Exemplo 1
Adicionar uma coluna denominada "TotalPrice" à tabela, com cada valor sendo a soma da coluna [Price] e da coluna
[Shipping].

[Link](
[Link]({
[OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100.0, Shipping = 10.00],
[OrderID = 2, CustomerID = 1, Item = "1 lb. worms", Price = 5.0, Shipping = 15.00],
[OrderID = 3, CustomerID = 2, Item = "Fishing net", Price = 25.0, Shipping = 10.00]
}),
"TotalPrice",
each [Price] + [Shipping]
)

O RDERID C USTO M ERID IT EM P REÇ O REM ESSA TOTA L P RIC E

1 1 Vara de pescar 100 10 110

2 1 1 lb de minhocas 5 15 20

3 2 Rede de pesca 25 10 35
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, newColumnName as text, optional initialValue as nullable
number, optional increment as nullable number) as table

Sobre
Anexa uma coluna chamada newColumnName à table com valores de posição explícitos. Um valor opcional,
initialValue , o valor do índice inicial. Um valor opcional, increment , especifica o quanto incrementar cada valor
de índice.

Exemplo 1
Adicionar uma coluna de índice denominada "Index" à tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
"Index"
)

C USTO M ERID NOME T EL EF O N E ÍN DIC E

1 Bob 123-4567 0

2 Jim 987-6543 1

3 Paul 543-7890 2

4 Ringo 232-1550 3

Exemplo 2
Adicionar uma coluna de índice denominada "Index", que começa no valor 10 e incrementando em 5, à tabela.
[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
"Index",
10,
5
)

C USTO M ERID NOME T EL EF O N E ÍN DIC E

1 Bob 123-4567 10

2 Jim 987-6543 15

3 Paul 543-7890 20

4 Ringo 232-1550 25
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table1 as table, key1 as any, table2 as function, key2 as any, newColumnName
as text) as table

Sobre
Une as linhas de table1 com as linhas de table2 com base na igualdade dos valores das colunas de chave
selecionadas por key1 (para table1 ) e key2 (para table2 ). Os resultados são inseridos na coluna chamada
newColumnName . Essa função se comporta de forma semelhante à [Link] com um JoinKind de LeftOuter, exceto
que os resultados da junção são apresentados em um modo aninhado, e não nivelado.

Exemplo 1
Adicione uma coluna de junção a ({[saleID = 1, item = "Shirt"], [saleID = 2, item = "Hat"]}) denominada
"preço/estoque" da tabela ({[saleID = 1, price = 20], [saleID = 2, price = 10]}) associada em [saleID].

[Link](
[Link]({
[saleID = 1, item = "Shirt"],
[saleID = 2, item = "Hat"]
}),
"saleID",
() => [Link]({
[saleID = 1, price = 20, stock = 1234],
[saleID = 2, price = 10, stock = 5643]
}),
"saleID",
"price"
)

SA L EID IT EM P REÇ O

1 Camiseta [Tabela]

2 Hat [Tabela]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, columns as list, isPrimary as logical) as table

Sobre
Adicione uma chave a table , considerando que columns é o subconjunto dos nomes de coluna de table que
define a chave e isPrimary especifica se a chave é primária.

Exemplo 1
Adicione uma chave a {[Id = 1, Name = "Hello There"], [Id = 2, Name = "Good Bye"]} composta por {"Id"} e torne-a
primária.

let
tableType = type table [Id = [Link], Name = text],
table = [Link]({
[Id = 1, Name = "Hello There"],
[Id = 2, Name = "Good Bye"]
}),
resultTable = [Link](table, {"Id"}, true)
in
resultTable

ID NOME

1 Olá

2 Até logo
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, column as text, aggregations as list) as table

Sobre
Agrega tabelas na table [ column ] em várias colunas que contêm valores de agregação para as tabelas.
aggregations é usado para especificar as colunas que contêm as tabelas a serem agregadas, as funções de
agregação a serem aplicadas às tabelas para gerar seus valores e os nomes das colunas de agregação a serem
criadas.

Exemplo 1
As colunas de tabela de agregação em [t] na tabela {[t = {[a=1, b=2, c=3], [a=2,b=4,c=6]}, b = 2]} na soma
de [t.a] , o mínimo e o máximo de [t.b] e a contagem de valores em [t.a] .

[Link](
[Link](
{
[
t = [Link]({
[a = 1, b = 2, c = 3],
[a = 2, b = 4, c = 6]
}),
b = 2
]
},
type table [t = table [a = number, b = number, c = number], b = number]
),
"t",
{
{"a", [Link], "sum of t.a"},
{"b", [Link], "min of t.b"},
{"b", [Link], "max of t.b"},
{"a", [Link], "count of t.a"}
}
)

SO M A DE T. A M ÍN IM O DE T. B M Á XIM O DE T. B C O N TA GEM DE T. A B

3 2 4 2 2
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, offset as number, skip as number, take as number) as table

Sobre
Mantém o deslocamento inicial e alterna o uso e não uso das linhas a seguir.
table : A tabela de entrada.
offset : O número de linhas a serem mantidas antes de iniciar as iterações.
skip : O número de linhas a serem removidas em cada iteração.
take : O número de linhas a serem mantidas em cada iteração.

Exemplo 1
Retornar uma tabela com base na tabela que, começando na primeira linha, ignora 1 valor e depois mantém 1
valor.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"]
}),
1,
1,
1
)

C USTO M ERID NOME T EL EF O N E

1 Bob 123-4567

3 Paul 543-7890
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table) as table

Sobre
Armazena uma tabela em buffer na memória, isentando-a de alterações externas durante a avaliação.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, column as text) as list

Sobre
Retorna a coluna de dados especificada por column da tabela table como uma lista.

Exemplo 1
Retornar os valores da coluna [Name] da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
"Name"
)

Bob

Jim

Paul

Ringo
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table) as number

Sobre
Retorna o número de colunas na tabela table .

Exemplo 1
Localizar o número de colunas na tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"]
})
)

3
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table) as list

Sobre
Retorna os nomes de coluna na tabela table como uma lista de texto.

Exemplo 1
Localizar os nomes de coluna da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
})
)

CustomerID

Nome

Telefone
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, listOfTypes as list) as list

Sobre
Retorna uma lista com os nomes das colunas na tabela table que correspondem aos tipos especificados no
listOfTypes .

Exemplo 1
Retornar os nomes de colunas do tipo [Link] da tabela.

[Link](
[Link](
{[a = 1, b = "hello"]},
type table[a = [Link], b = [Link]]
),
{type number}
)

um
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](tables as list, optional columns as any) as table

Sobre
Retorna uma tabela que é o resultado da mesclagem de uma lista de tabelas, tables . A tabela resultante terá uma
estrutura de tipo de linha definida por columns ou por uma União dos tipos de entrada se columns não for
especificado.

Exemplo 1
Mesclar as três tabelas.

[Link]({
[Link]({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
[Link]({[CustomerID = 2, Name = "Jim", Phone = "987-6543"]}),
[Link]({[CustomerID = 3, Name = "Paul", Phone = "543-7890"]})
})

C USTO M ERID NOME T EL EF O N E

1 Bob 123-4567

2 Jim 987-6543

3 Paul 543-7890

Exemplo 2
Mescle três tabelas com estruturas diferentes.

[Link]({
[Link]({[Name = "Bob", Phone = "123-4567"]}),
[Link]({[Fax = "987-6543", Phone = "838-7171"]}),
[Link]({[Cell = "543-7890"]})
})

NOME T EL EF O N E FA X C ÉL UL A

Bob 123-4567

838-7171 987-6543

543-7890
Exemplo 3
Mescle duas tabelas e o projeto para o tipo fornecido.

[Link](
{
[Link]({[Name = "Bob", Phone = "123-4567"]}),
[Link]({[Fax = "987-6543", Phone = "838-7171"]}),
[Link]({[Cell = "543-7890"]})
},
{"CustomerID", "Name"}
)

C USTO M ERID NOME

Bob
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, sourceColumns as list, combiner as function, column as text)
as table

Sobre
Combina as colunas especificadas em uma nova coluna usando a função de combinação especificada.
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, row as record, optional equationCriteria as any) as logical

Sobre
Indica se o registro especificado, row , é exibido como uma linha na table . Um parâmetro equationCriteria
opcional pode ser especificado para controlar a comparação entre as linhas da tabela.

Exemplo 1
Determinar se a tabela contém a linha.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
[Name = "Bob"]
)

true

Exemplo 2
Determinar se a tabela contém a linha.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
[Name = "Ted"]
)

false

Exemplo 3
Determinar se a tabela contém a linha comparando apenas a coluna [Name].
[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
[CustomerID = 4, Name = "Bob"],
"Name"
)

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, rows as list, optional equationCriteria as any) as logical

Sobre
Indica se todos os registros especificados na lista de registros rows aparecem como linhas na table . Um
parâmetro equationCriteria opcional pode ser especificado para controlar a comparação entre as linhas da tabela.

Exemplo 1
Determinar se a tabela contém todas as linhas comparando apenas a coluna [CustomerID].

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
{
[CustomerID = 1, Name = "Bill"],
[CustomerID = 2, Name = "Fred"]
},
"CustomerID"
)

true

Exemplo 2
Determinar se a tabela contém todas as linhas.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
{
[CustomerID = 1, Name = "Bill"],
[CustomerID = 2, Name = "Fred"]
}
)

false
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, rows as list, optional equationCriteria as any) as logical

Sobre
Indica se algum dos registros especificados na lista de registros rows aparece como linhas na table . Um
parâmetro equationCriteria opcional pode ser especificado para controlar a comparação entre as linhas da tabela.

Exemplo 1
Determine se a tabela ({[a = 1, b = 2], [a = 3, b = 4]}) contém as linhas [a = 1, b = 2] e [a = 3, b = 5] .

[Link](
[Link]({
[a = 1, b = 2],
[a = 3, b = 4]
}),
{
[a = 1, b = 2],
[a = 3, b = 5]
}
)

true

Exemplo 2
Determine se a tabela ({[a = 1, b = 2], [a = 3, b = 4]}) contém as linhas [a = 1, b = 3] e [a = 3, b = 5] .

[Link](
[Link]({
[a = 1, b = 2],
[a = 3, b = 4]
}),
{
[a = 1, b = 3],
[a = 3, b = 5]
}
)

false

Exemplo 3
Determine se a tabela ([Link]({[a = 1, b = 2], [a = 3, b = 4]})) contém as linhas [a = 1, b = 3] ou
[a = 3, b = 5] comparando apenas a coluna [a].
[Link](
[Link]({
[a = 1, b = 2],
[a = 3, b = 4]
}),
{
[a = 1, b = 3],
[a = 3, b = 5]
},
"a"
)

true
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table) as table

Sobre
Rebaixa os cabeçalhos de coluna (ou seja, nomes de coluna) para a primeira linha de valores. Os nomes de coluna
padrão são "Coluna1", "Coluna2" e assim por diante.

Exemplo 1
Rebaixar a primeira linha de valores da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"]
})
)

C O L UN A 1 C O L UN A 2 C O L UM N 3

CustomerID Nome Telefone

1 Bob 123-4567

2 Jim 987-6543
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, optional equationCriteria as any) as table

Sobre
Remove linhas duplicadas da tabela table . Um parâmetro opcional, equationCriteria , especifica quais colunas
da tabela são testadas para duplicação. Se equationCriteria não for especificado, todas as colunas serão testadas.

Exemplo 1
Remover as linhas duplicadas da tabela.

[Link](
[Link]({
[a = "A", b = "a"],
[a = "B", b = "b"],
[a = "A", b = "a"]
})
)

UM B

A um

B b

Exemplo 2
Remova as linhas duplicadas da coluna [b] na tabela
({[a = "A", b = "a"], [a = "B", b = "a"], [a = "A", b = "b"]}) .

[Link](
[Link]({
[a = "A", b = "a"],
[a = "B", b = "a"],
[a = "A", b = "b"]
}),
"b"
)

UM B

A um

A b
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, columnName as text, newColumnName as text, optional
columnType as nullable type) as table

Sobre
Duplique a coluna denominada columnName para a tabela table . Os valores e o tipo da coluna newColumnName são
copiados da coluna columnName .

Exemplo
Duplique a coluna "a" para uma coluna denominada "copied column" na tabela
({[a = 1, b = 2], [a = 3, b = 4]}) .

[Link](
[Link]({
[a = 1, b = 2],
[a = 3, b = 4]
}),
"a",
"copied column"
)

UM B C O L UN A C O P IA DA

1 2 1

3 4 3
[Link]
21/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, column as text) as table

Sobre
Dado um table , em que um column é uma lista de valores, divide a lista em uma linha para cada valor. Os valores
nas outras colunas são duplicados em cada nova linha criada.

Exemplo 1
Dividir a coluna de lista [Name] na tabela.

[Link](
[Link]({[Name = {"Bob", "Jim", "Paul"}, Discount = .15]}),
"Name"
)

NOME DESC O N TO

Bob 0,15

Jim 0,15

Paul 0,15
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, column as text, fieldNames as list, optional
newColumnNames as nullable list) as table

Sobre
Devido à column de registros na entrada table , cria uma tabela com uma coluna para cada campo no registro.
Opcionalmente, newColumnNames pode ser especificado para garantir nomes exclusivos para as colunas na nova
tabela.
table : A tabela original com a coluna de registro a ser expandida.
column : A coluna a ser expandida.
fieldNames : A lista de campos a serem expandidos em colunas na tabela.
newColumnNames : A lista de nomes de coluna para dar às novas colunas. Os novos nomes de coluna não podem
duplicar nenhuma coluna na nova tabela.

Exemplo 1
Expanda a coluna [a] na tabela ({[a = [aa = 1, bb = 2, cc = 3], b = 2]}) em 3 colunas "aa", "bb" e "cc".

[Link](
[Link]({
[
a = [aa = 1, bb = 2, cc = 3],
b = 2
]
}),
"a",
{"aa", "bb", "cc"}
)

AA BB CC B

1 2 3 2
[Link]
21/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, column as text, columnNames as list, optional
newColumnNames as nullable list) as table

Sobre
Expande tabelas no table [ column ] em várias linhas e colunas. columnNames é usado para selecionar as colunas a
serem expandidas da tabela interna. Especifique newColumnNames para evitar conflitos entre colunas existentes e
novas colunas.

Exemplo 1
Expanda colunas de tabela em [a] na tabela ({[t = {[a=1, b=2, c=3], [a=2,b=4,c=6]}, b = 2]}) em três colunas
[t.a] , [t.b] e [t.c] .

[Link](
[Link]({
[
t = [Link]({
[a = 1, b = 2, c = 3],
[a = 2, b = 4, c = 6]
}),
b = 2
]
}),
"t",
{"a", "b", "c"},
{"t.a", "t.b", "t.c"}
)

T. A T. B T. C B

1 2 3 2

2 4 6 2
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, columns as list) as table

Sobre
Retorna uma tabela do table especificado em que o valor de uma célula anterior é propagado para as células de
valor nulo abaixo no columns especificado.

Exemplo 1
Retornar uma tabela com os valores nulos da coluna [Place] preenchidos com o valor acima deles na tabela.

[Link](
[Link]({
[Place = 1, Name = "Bob"],
[Place = null, Name = "John"],
[Place = 2, Name = "Brad"],
[Place = 3, Name = "Mark"],
[Place = null, Name = "Tom"],
[Place = null, Name = "Adam"]
}),
{"Place"}
)

LO C A L NOME

1 Bob

1 John

2 Brad

3 Marcar

3 Tom

3 Luís
[Link]
21/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, columns as list) as table

Sobre
Retorna uma tabela do table especificado em que o valor da próxima célula é propagado para as células de valor
nulo acima no columns especificado.

Exemplo 1
Retornar uma tabela com os valores nulos da coluna [Column2] preenchidos com o valor abaixo deles na tabela.

[Link](
[Link]({
[Column1 = 1, Column2 = 2],
[Column1 = 3, Column2 = null],
[Column1 = 5, Column2 = 3]
}),
{"Column2"}
)

C O L UN A 1 C O L UN A 2

1 2

3 3

5 3
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](**table** as table, **dataTableIdentifier** as text) as any

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, text as text) as table

Sobre
Retorna as linhas na tabela table que contêm o texto text . Se o texto não for encontrado, uma tabela vazia será
retornada.

Exemplo 1
Localizar as linhas da tabela que contém "Bob".

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
"Bob"
)

C USTO M ERID NOME T EL EF O N E

1 Bob 123-4567
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, optional default as any) as any

Sobre
Retorna a primeira linha da table ou um valor padrão default opcional, se a tabela está vazia.

Exemplo 1
Localizar a primeira linha da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"]
})
)

C USTO M ERID 1

NOME Bob

T EL EF O N E 123-4567

Exemplo 2
Localize a primeira linha da tabela ({}) ou retorne [a = 0, b = 0] se ela estiver vazia.

[Link]([Link]({}), [a = 0, b = 0])

UM 0

B 0
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, countOrCondition as any) as table

Sobre
Retorna as primeiras linhas da tabela table , dependendo do valor de countOrCondition :
Se countOrCondition for um número, serão retornadas muitas linhas (começando na parte superior).
Se countOrCondition for uma condição, as linhas que atendem à condição serão retornadas até que uma linha
não atenda à condição.

Exemplo 1
Localizar as duas primeiras linhas da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"]
}),
2
)

C USTO M ERID NOME T EL EF O N E

1 Bob 123-4567

2 Jim 987-6543

Exemplo 2
Localizar as primeiras linhas em que [a] > 0 na tabela.

[Link](
[Link]({
[a = 1, b = 2],
[a = 3, b = 4],
[a = -5, b = -6]
}),
each [a] > 0
)

UM B

1 2
3 4
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, optional default as any) as any

Sobre
Retorna a primeira coluna da primeira linha da tabela table ou um valor padrão especificado.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](lists as list, optional columns as any) as table

Sobre
Cria uma tabela do tipo columns de uma lista lists contendo listas aninhadas com os nomes e os valores de
coluna. Se algumas colunas tiverem mais valores que outras, os valores ausentes serão preenchidos com o valor
padrão, 'null', se as colunas forem anuláveis.

Exemplo 1
Retornar uma tabela de uma lista de nomes de clientes em uma lista. Cada valor no item de lista de clientes torna-
se um valor de linha e cada lista torna-se uma coluna.

[Link]({
{1, "Bob", "123-4567"},
{2, "Jim", "987-6543"},
{3, "Paul", "543-7890"}
})

C O L UN A 1 C O L UN A 2 C O L UM N 3

1 2 3

Bob Jim Paul

123-4567 987-6543 543-7890

Exemplo 2
Crie uma tabela com base em uma lista de colunas especificada e de uma lista de nomes de coluna.

[Link](
{
{1, "Bob", "123-4567"},
{2, "Jim", "987-6543"},
{3, "Paul", "543-7890"}
},
{"CustomerID", "Name", "Phone"}
)

C USTO M ERID NOME T EL EF O N E

1 2 3
Bob Jim Paul

123-4567 987-6543 543-7890

Exemplo 3
Crie uma tabela com um número diferente de colunas por linha. O valor da linha ausente é nulo.

[Link](
{
{1, 2, 3},
{4, 5},
{6, 7, 8, 9}
},
{"column1", "column2", "column3"}
)

C O L UM N 1 C O L UM N 2 C O L UM N 3

1 4 6

2 5 7

3 8

9
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](list as list, optional splitter as nullable function, optional columns as any,
optional default as any, optional extraValues as nullable number) as table

Sobre
Converte uma lista, list , em tabela aplicando a função de divisão opcional, splitter , a cada item da lista. Por
padrão, a lista é considerada uma lista de valores de texto dividida por vírgulas. O columns opcional pode ser o
número de colunas, uma lista de colunas ou um TableType. Também é possível especificar default e extraValues
opcionais.

Exemplo 1
Criar uma tabela com base na lista com uma coluna chamada "Letters" usando o divisor padrão.

[Link]({"a", "b", "c", "d"}, null, {"Letters"})

L ET RA S

um

Exemplo 2
Criar uma tabela com base na lista usando o divisor [Link] em que a tabela resultante tem
"CustomerID" e "Name" como nomes de coluna.

[Link](
{
[CustomerID = 1, Name = "Bob"],
[CustomerID = 2, Name = "Jim"]
},
[Link],
{"CustomerID", "Name"}
)

C USTO M ERID NOME

1 Bob
2 Jim
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](partitionColumn as text, partitions as list, optional partitionColumnType as
nullable type) as table

Sobre
Retorna uma tabela que é o resultado da combinação de um conjunto de tabelas particionadas, partitions .
partitionColumn é o nome da coluna a ser adicionada. O tipo da coluna é padronizado para any , mas pode ser
especificado por partitionColumnType .

Exemplo 1
Encontre o tipo de item na lista {number} .

[Link](
"Year",
{
{
1994,
[Link](
"Month",
{
{
"Jan",
[Link](
"Day",
{
{1, #table({"Foo"}, {{"Bar"}})},
{2, #table({"Foo"}, {{"Bar"}})}
}
)
},
{
"Feb",
[Link](
"Day",
{
{3, #table({"Foo"}, {{"Bar"}})},
{4, #table({"Foo"}, {{"Bar"}})}
}
)
}
}
)
}
}
)

FOO DIA M ÊS ANO

Barras 1 Jan 1994


Barras 2 Jan 1994

Barras 3 Fev 1994

Barras 4 Fev 1994


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](records as list, optional columns as any, optional missingField as nullable
number) as table

Sobre
Converte records , uma lista de registros, em uma tabela.

Exemplo 1
Cria uma tabela com base nos registros usando os nomes de campo dos registros como nomes de coluna.

[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"]
})

C USTO M ERID NOME T EL EF O N E

1 Bob 123-4567

2 Jim 987-6543

3 Paul 543-7890

Exemplo 2
Cria uma tabela com base nos registros com colunas de tipo e seleciona as colunas de número.

[Link](
[Link](
{[CustomerID = 1, Name = "Bob"]},
type table[CustomerID = [Link], Name = [Link]]
),
{type number}
)

CustomerID
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](rows as list, optional columns as any) as table

Sobre
Cria uma tabela da lista rows em que cada elemento da lista é uma lista interna que contém os valores de coluna
para uma única linha. Uma lista opcional de nomes de coluna, um tipo de tabela ou um número de colunas pode
ser fornecida para columns .

Exemplo 1
Retornar uma tabela com a coluna [CustomerID] com valores {1, 2}, a coluna [Name] com valores {"Bob", "Jim"} e a
coluna [Phone] com valores {"123-4567", "987-6543"}.

[Link](
{
{1, "Bob", "123-4567"},
{2, "Jim", "987-6543"}
},
{"CustomerID", "Name", "Phone"}

C USTO M ERID NOME T EL EF O N E

1 Bob 123-4567

2 Jim 987-6543

Exemplo 2
Retornar uma tabela com a coluna [CustomerID] com valores {1, 2}, a coluna [Name] com valores {"Bob", "Jim"} e a
coluna [Phone] com valores {"123-4567", "987-6543"}, em que [CustomerID] é um tipo de número e [Name] e
[Phone] são tipos de texto.

[Link](
{
{1, "Bob", "123-4567"},
{2, "Jim", "987-6543"}
},
type table [CustomerID = number, Name = text, Phone = text]
)

C USTO M ERID NOME T EL EF O N E

1 Bob 123-4567
2 Jim 987-6543
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional options as nullable record) as table

Sobre
Cria uma tabela com uma coluna que contém o valor fornecido ou a lista de valores, value . Um parâmetro de
registro opcional, options , pode ser especificado para controlar as seguintes opções:
DefaultColumnName : O nome da coluna usada ao construir uma tabela com base em uma lista ou em um valor
escalar.

Exemplo 1
Crie uma tabela a com base no valor 1.

[Link](1)

VA LO R

Exemplo 2
Criar uma tabela com base na lista.

[Link]({1, "Bob", "123-4567"})

VA LO R

Bob

123-4567

Exemplo 3
Criar uma coluna do valor 1, com um nome de coluna personalizado.

[Link](1, [DefaultColumnName = "MyValue"])

M Y VA L UE
1
[Link]
08/05/2020 • 4 minutes to read

Sintaxe
[Link](table as table, key as any, aggregatedColumns as list, optional options as
nullable record) as table

Sobre
Agrupa as linhas de table pelos valores com correspondência difusa na coluna especificada, key , para cada linha.
Para cada grupo, é construído um registro contendo as colunas de chave (e seus valores) com as colunas
agregadas especificadas por aggregatedColumns . Essa função não pode garantir o retorno de uma ordem fixa de
linhas.
Um conjunto opcional de options pode ser incluído para especificar como comparar as colunas de chave. As
opções incluem:
Culture
IgnoreCase
IgnoreSpace
Threshold
TransformationTable

A tabela a seguir fornece mais detalhes sobre as opções avançadas.

O P Ç Ã O AVA N Ç A DA PA DRÃ O P ERM IT IDO DESC RIÇ Ã O

Cultura Cultura neutra Um nome de cultura válido A opção Culture permite


combinar registros com base
em regras específicas de
cultura.
Por exemplo, uma opção
Culture igual a 'ja-JP'
corresponde a registros com
base no idioma japonês.

IgnoreCase verdadeiro true ou false A opção IgnoreCase permite


o agrupamento de chaves,
independentemente do uso
de maiúsculas e minúsculas
no texto.
Por exemplo, 'Uvas' (letra
inicial maiúscula) será
agrupado com 'uvas' (todas
as letras minúsculas) se a
opção IgnoreCase estiver
definida como true.
O P Ç Ã O AVA N Ç A DA PA DRÃ O P ERM IT IDO DESC RIÇ Ã O

IgnoreSpace verdadeiro true ou false A opção IgnoreSpace


permite combinar partes de
texto para localizar
correspondências.
Por exemplo, 'Micro Soft'
será agrupado com
'Microsoft' se a opção
IgnoreSpace estiver definida
como true.

Limite 0.80 Entre 0,00 e 1,00 A opção Threshold de


similaridade permite
combinar registros acima de
uma determinada pontuação
de similaridade. Um limite de
1,00 é o mesmo que
especificar um critério de
correspondência exato.
Por exemplo, 'Uvas' e 'Uva'
(sem o 's') serão agrupados
somente se o limite estiver
definido como inferior a
0,90.

TransformationTable Uma tabela válida com pelo A opção TransformationTable


menos duas colunas permite combinar registros
denominadas 'From' e 'To'. com base em mapeamentos
de valor personalizados.
Por exemplo, 'Uvas'
combinará com 'Passas' se
uma tabela de
transformação for fornecida
com a coluna 'From'
contendo 'Uvas' e a coluna
'To' contendo 'Passas'.
Observe que a
transformação será aplicada
a todas as ocorrências do
texto na tabela de
transformação. Por exemplo,
com a tabela de
transformação acima a frase
'Uvas são doce' também será
correspondida com a frase
'Uvas-passas são doce'.

Exemplo
Agrupe a tabela adicionando uma coluna de agregação [Count] que contém o número de funcionários em cada
local ( each [Link](_) ).
[Link](
[Link](
{
[EmployeeID = 1, Location = "Seattle"],
[EmployeeID = 2, Location = "seattl"],
[EmployeeID = 3, Location = "Vancouver"],
[EmployeeID = 4, Location = "Seatle"],
[EmployeeID = 5, Location = "vancover"],
[EmployeeID = 6, Location = "Seattle"],
[EmployeeID = 7, Location = "Vancouver"]
},
type table [EmployeeID = nullable number, Location = nullable text]
),
"Location",
{"Count", each [Link](_)},
[IgnoreCase = true, IgnoreSpace = true]
)

LO C A L IZ A Ç Ã O C O N TA GEM

Seattle 4

Vancouver 3
[Link]
08/05/2020 • 4 minutes to read

Sintaxe
[Link](table1 as table, key1 as any, table2 as table, key2 as any, optional joinKind as
nullable number, optional joinOptions as nullable record) as table

Sobre
Une as linhas de `table1` com as linhas de `table2` com base na correspondência difusa dos valores das colunas de
chave selecionadas por `key1` (para `table1`) e `key2` (para `table2`).
A correspondência difusa é uma comparação baseada na similaridade de texto, em vez de igualdade de texto.
Por padrão, uma junção interna é executada, no entanto, um `joinKind` opcional pode ser incluído para especificar o
tipo de junção. As opções incluem:
[Link]
[Link]
[Link]
[Link]
[Link]
[Link]

Um conjunto opcional de joinOptions pode ser incluído para especificar como comparar as colunas de chave. As
opções incluem:
ConcurrentRequests
Culture
IgnoreCase
IgnoreSpace
NumberOfMatches
Threshold
TransformationTable

A tabela a seguir fornece mais detalhes sobre as opções avançadas.

O P Ç Ã O AVA N Ç A DA PA DRÃ O P ERM IT IDO DESC RIÇ Ã O

ConcurrentRequests 1 Entre 1 e 8 A opção ConcurrentRequests


dá suporte à paralelização
da operação join
especificando o número de
threads paralelos a serem
usados.
Cultura Cultura neutra Um nome de cultura válido A opção Culture permite
combinar registros com base
em regras específicas de
cultura.
Por exemplo, uma opção
Culture de 'ja-JP'
corresponde a registros com
base no idioma japonês.

IgnoreCase verdadeiro true ou false A opção IgnoreCase permite


registros correspondentes,
independentemente do uso
de maiúsculas e minúsculas
no texto.
Por exemplo, "Uvas"
(maiúsculas e minúsculas de
frase) corresponde a "uvas"
(minúsculas) se a opção
IgnoreCase está definida
como true.

IgnoreSpace verdadeiro true ou false A opção IgnoreSpace


permite combinar partes de
texto para localizar
correspondências.
Por exemplo, "Micro Soft"
corresponde tanto a
"Microsoft" quanto a "Micro
soft" se a opção IgnoreSpace
está definida como true.

NumberOfMatches 2147483647 Entre 0 e 2147483647 A opção NumberOfMatches


especifica o número máximo
de linhas correspondentes
que podem ser retornadas.

Limite 0.80 Entre 0,00 e 1,00 A opção Threshold de


similaridade permite
combinar registros acima de
uma determinada pontuação
de similaridade. Um limite de
1,00 é o mesmo que
especificar um critério de
correspondência exato.
Por exemplo, 'Uvas'
corresponderá a 'Uva ' ('s'
faltando) somente se o limite
estiver definido como menos
de 0,90.

TransformationTable Uma tabela válida com pelo A opção TransformationTable


menos duas colunas permite combinar registros
denominadas 'From' e 'To'. com base em mapeamentos
de valor personalizados.
Por exemplo, 'Uvas'
combinará com 'Passas' se
uma tabela de
transformação for fornecida
com a coluna 'From'
contendo 'Uvas' e a coluna
'To' contendo 'Passas'.
Exemplo
Junção difusa interna esquerda das duas tabelas com base em [FirstName]

[Link](
[Link](
{
[CustomerID = 1, FirstName1 = "Bob", Phone = "555-1234"],
[CustomerID = 2, FirstName1 = "Robert", Phone = "555-4567"]
},
type table [CustomerID = nullable number, FirstName1 = nullable text, Phone = nullable text]
),
{"FirstName1"},
[Link](
{
[CustomerStateID = 1, FirstName2 = "Bob", State = "TX"],
[CustomerStateID = 2, FirstName2 = "bOB", State = "CA"]
},
type table [CustomerStateID = nullable number, FirstName2 = nullable text, State = nullable text]
),
{"FirstName2"},
[Link],
[IgnoreCase = true, IgnoreSpace = false]
)

C USTO M ERID F IRST N A M E1 T EL EF O N E C USTO M ERSTAT EI F IRST N A M E2 ESTA DO


D

1 Bob 555-1234 1 Bob TX

1 Bob 555-1234 2 bOB AC

2 Robert 555-4567
[Link]
08/05/2020 • 4 minutes to read

Sintaxe
[Link](table1 as table, key1 as any, table2 as table, key2 as any, newColumnName as
text, optional joinKind as nullable number, optional joinOptions as nullable record) as table

Sobre
Une as linhas de table1 com as linhas de table2 com base na correspondência difusa dos valores das colunas de
chave selecionadas por key1 (para table1 ) e key2 (para table2 ). Os resultados são retornados em uma nova
coluna chamada newColumnName .
A correspondência difusa é uma comparação baseada na similaridade de texto, em vez de igualdade de texto.
O joinKind opcional especifica o tipo de junção a ser executada. Por padrão, uma junção externa esquerda será
executada se uma joinKind não for especificada. As opções incluem:
[Link]
[Link]
[Link]
[Link]
[Link]
[Link]

Um conjunto opcional de joinOptions pode ser incluído para especificar como comparar as colunas de chave. As
opções incluem:
ConcurrentRequests
Culture
IgnoreCase
IgnoreSpace
NumberOfMatches
Threshold
TransformationTable

A tabela a seguir fornece mais detalhes sobre as opções avançadas.

O P Ç Ã O AVA N Ç A DA PA DRÃ O P ERM IT IDO DESC RIÇ Ã O

ConcurrentRequests 1 Entre 1 e 8 A opção ConcurrentRequests


dá suporte à paralelização
da operação join
especificando o número de
threads paralelos a serem
usados.
Cultura Cultura neutra Um nome de cultura válido A opção Culture permite
combinar registros com base
em regras específicas de
cultura.
Por exemplo, uma opção
Culture de 'ja-JP'
corresponde a registros com
base no idioma japonês.

IgnoreCase verdadeiro true ou false A opção IgnoreCase permite


registros correspondentes,
independentemente do uso
de maiúsculas e minúsculas
no texto.
Por exemplo, "Uvas"
(maiúsculas e minúsculas de
frase) corresponde a "uvas"
(minúsculas) se a opção
IgnoreCase está definida
como true.

IgnoreSpace verdadeiro true ou false A opção IgnoreSpace


permite combinar partes de
texto para localizar
correspondências.
Por exemplo, "Micro Soft"
corresponde a "Microsoft" se
a opção IgnoreSpace está
definida como true.

NumberOfMatches 2147483647 Entre 0 e 2147483647 A opção NumberOfMatches


especifica o número máximo
de linhas correspondentes
que podem ser retornadas.

Limite 0.80 Entre 0,00 e 1,00 A opção Threshold de


similaridade permite
combinar registros acima de
uma determinada pontuação
de similaridade. Um limite de
1,00 é o mesmo que
especificar um critério de
correspondência exato.
Por exemplo, 'Uvas'
corresponderá a 'Uva ' ('s'
faltando) somente se o limite
estiver definido como menos
de 0,90.

TransformationTable Uma tabela válida com pelo A opção TransformationTable


menos duas colunas permite combinar registros
denominadas 'From' e 'To'. com base em mapeamentos
de valor personalizados.
Por exemplo, 'Uvas'
combinará com 'Passas' se
uma tabela de
transformação for fornecida
com a coluna 'From'
contendo 'Uvas' e a coluna
'To' contendo 'Passas'.
Exemplo
Junção difusa interna esquerda das duas tabelas com base em [FirstName]

[Link](
[Link](
{
[CustomerID = 1, FirstName1 = "Bob", Phone = "555-1234"],
[CustomerID = 2, FirstName1 = "Robert", Phone = "555-4567"]
},
type table [CustomerID = nullable number, FirstName1 = nullable text, Phone = nullable text]
),
{"FirstName1"},
[Link](
{
[CustomerStateID = 1, FirstName2 = "Bob", State = "TX"],
[CustomerStateID = 2, FirstName2 = "bOB", State = "CA"]
},
type table [CustomerStateID = nullable number, FirstName2 = nullable text, State = nullable text]
),
{"FirstName2"},
"NestedTable",
[Link],
[IgnoreCase = true, IgnoreSpace = false]
)

C USTO M ERID F IRST N A M E1 T EL EF O N E N EST EDTA B L E

1 Bob 555-1234 [Tabela]

2 Robert 555-4567 [Tabela]


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, key as any, aggregatedColumns as list, optional groupKind as nullable
number, optional comparer as nullable function) as table

Sobre
Agrupa as linhas de table pelos valores na coluna especificada, key , para cada linha. Para cada grupo, é
construído um registro contendo as colunas de chave (e seus valores) com as colunas agregadas especificadas por
aggregatedColumns . Observe que, se várias chaves corresponderem ao comparador, chaves diferentes poderão ser
retornadas. Essa função não pode garantir o retorno de uma ordem fixa de linhas. Opcionalmente, também é
possível especificar groupKind e comparer .

Exemplo 1
Agrupar a tabela adicionando uma coluna agregada [total] que contém a soma de preços ("each [Link]([price])").

[Link](
[Link]({
[CustomerID = 1, price = 20],
[CustomerID = 2, price = 10],
[CustomerID = 2, price = 20],
[CustomerID = 1, price = 10],
[CustomerID = 3, price = 20],
[CustomerID = 3, price = 5]
}),
"CustomerID",
{"total", each [Link]([price])}
)

C USTO M ERID TOTA L

1 30

2 30

3 25
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, columns as any) as logical

Sobre
indica se o table contém as colunas especificadas, columns . Retorna true se a tabela contém as colunas; caso
contrário, false .

Exemplo 1
Determine se a tabela tem a coluna [Name].

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
"Name"
)

true

Exemplo 2
Descubra se a tabela tem a coluna [Name] e [PhoneNumber].

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
{"Name", "PhoneNumber"}
)

false
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, offset as number, rows as list) as table

Sobre
Retorna uma tabela com a lista de linhas, rows , inserida no table na posição especificada, offset . Cada coluna
na linha a ser inserida deve corresponder aos tipos de coluna da tabela.

Exemplo 1
Inserir a linha na tabela na posição 1.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"]
}),
1,
{[CustomerID = 3, Name = "Paul", Phone = "543-7890"]}
)

C USTO M ERID NOME T EL EF O N E

1 Bob 123-4567

3 Paul 543-7890

2 Jim 987-6543

Exemplo 2
Inserir duas linhas na tabela na posição 1.

[Link](
[Link]({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
1,
{
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"]
}
)

C USTO M ERID NOME T EL EF O N E

1 Bob 123-4567
2 Jim 987-6543

3 Paul 543-7890
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, optional comparisonCriteria as any) as logical

Sobre
Indica se a table contém somente linhas distintas (sem duplicatas). Retorna true se as linhas são distintas; caso
contrário, false . Um parâmetro opcional, comparisonCriteria , especifica quais colunas da tabela são testadas
para duplicação. Se comparisonCriteria não for especificado, todas as colunas serão testadas.

Exemplo 1
Determine se a tabela é distinta.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
})
)

true

Exemplo 2
Determine se a tabela é distinta na coluna.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 5, Name = "Bob", Phone = "232-1550"]
}),
"Name"
)

false
[Link]
21/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table) as logical

Sobre
Indica se table contém linhas. Retorna true se não há linhas (ou seja, a tabela está vazia); caso contrário, false .

Exemplo 1
Determine se a tabela está vazia.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"]
})
)

false

Exemplo 2
Determine se a tabela ({}) está vazia.

[Link]([Link]({}))

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table1 as table, key1 as any, table2 as table, key2 as any, optional joinKind as
nullable number, optional joinAlgorithm as nullable number, optional keyEqualityComparers as
nullable list) as table

Sobre
Une as linhas de table1 com as linhas de table2 com base na igualdade dos valores das colunas de chave
selecionadas por key1 (para table1 ) e key2 (para table2 ).
Por padrão, uma junção interna é executada, no entanto, um joinKind opcional pode ser incluído para especificar
o tipo de junção. As opções incluem:
[Link]
[Link]
[Link]
[Link]
[Link]
[Link]

Um conjunto opcional de keyEqualityComparers pode ser incluído para especificar como comparar as colunas de
chave.

Exemplo 1
Junção interna das duas tabelas em [CustomerID]

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
"CustomerID",
[Link]({
[OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100.0],
[OrderID = 2, CustomerID = 1, Item = "1 lb. worms", Price = 5.0],
[OrderID = 3, CustomerID = 2, Item = "Fishing net", Price = 25.0],
[OrderID = 4, CustomerID = 3, Item = "Fish tazer", Price = 200.0],
[OrderID = 5, CustomerID = 3, Item = "Bandaids", Price = 2.0],
[OrderID = 6, CustomerID = 1, Item = "Tackle box", Price = 20.0],
[OrderID = 7, CustomerID = 5, Item = "Bait", Price = 3.25]
}),
"CustomerID"
)

C USTO M ERID NOME T EL EF O N E O RDERID IT EM P REÇ O


1 Bob 123-4567 1 Vara de pescar 100

1 Bob 123-4567 2 1 lb de minhocas 5

2 Jim 987-6543 3 Rede de pesca 25

3 Paul 543-7890 4 Taser de peixe 200

3 Paul 543-7890 5 Bandaids 2

1 Bob 123-4567 6 Caixa de material 20


de pesca
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table) as list

Sobre
[Link]
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, optional default as any) as any

Sobre
Retorna a última linha da table ou um valor padrão default opcional, se a tabela está vazia.

Exemplo 1
Localize a última linha da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"]
})
)

C USTO M ERID 3

NOME Paul

T EL EF O N E 543-7890

Exemplo 2
Localize a última linha da tabela ({}) ou retorne [a = 0, b = 0] se ela estiver vazia.

[Link]([Link]({}), [a = 0, b = 0])

UM 0

B 0
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, countOrCondition as any) as table

Sobre
Retorna as últimas linhas da tabela, table , dependendo do valor de countOrCondition :
Se countOrCondition for um número, essa quantidade de linhas será retornada começando na posição (final -
countOrCondition ).
Se countOrCondition for uma condição, as linhas que atendem à condição serão retornadas na posição
crescente até que uma linha não atenda à condição.

Exemplo 1
Localizar as duas últimas linhas da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"]
}),
2
)

C USTO M ERID NOME T EL EF O N E

2 Jim 987-6543

3 Paul 543-7890

Exemplo 2
Localizar as últimas linhas em que [a] > 0 na tabela.

[Link](
[Link]({
[a = -1, b = -2],
[a = 3, b = 4],
[a = 5, b = 6]
}),
each _ [a] > 0

UM B
3 4

5 6
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, condition as function) as logical

Sobre
Indica se todas as linhas na table atendem à condition especificada. Retorna true se todas as linhas
correspondem; caso contrário, false .

Exemplo 1
Determinar se todos os valores de linha na coluna [a] são pares na tabela.

[Link](
[Link]({
[a = 2, b = 4],
[a = 6, b = 8]
}),
each [Link]([a], 2) = 0
)

true

Exemplo 2
Localize se todos os valores de linha são [a = 1, b = 2], na tabela ({[a = 1, b = 2], [a = 3, b = 4]}) .

[Link](
[Link]({
[a = 1, b = 2],
[a = -3, b = 4]
}),
each _ = [a = 1, b = 2]
)

false
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, condition as function) as logical

Sobre
Indica se alguma das linhas na table atende à condition especificada. Retorna true se alguma das linhas
corresponde; caso contrário, false .

Exemplo 1
Determinar se algum dos valores de linha na coluna [a] são pares na tabela ({[a = 2, b = 4], [a = 6, b = 8]}) .

[Link](
[Link]({
[a = 1, b = 4],
[a = 3, b = 8]
}),
each [Link]([a], 2) = 0
)

false

Exemplo 2
Determinar se algum dos valores de linha são [a = 1, b = 2] na tabela ({[a = 1, b = 2], [a = 3, b = 4]}) .

[Link](
[Link]({
[a = 1, b = 2],
[a = -3, b = 4]
}),
each _ = [a = 1, b = 2]
)

true
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, comparisonCriteria as any, optional default as any) as any

Sobre
Retorna a maior linha do table , dado o comparisonCriteria . Se a tabela estiver vazia, o valor opcional de default
será retornado.

Exemplo 1
Localize a linha com o maior valor na coluna [a] da tabela ({[a = 2, b = 4], [a = 6, b = 8]}) .

[Link](
[Link]({
[a = 2, b = 4],
[a = 6, b = 8]
}),
"a"
)

UM 6

B 8

Exemplo 2
Localize a linha com o maior valor na coluna [a] da tabela ({}) . Retornará -1 se estiver vazia.

[Link](#table({"a"}, {}), "a", -1)

-1
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, comparisonCriteria as any, countOrCondition as any) as table

Sobre
Retorna a maior linha do table , dado o comparisonCriteria . Depois que as linhas são classificadas, o parâmetro
countOrCondition deve ser especificado para filtrar melhor o resultado. Observe que o algoritmo de classificação
não pode garantir um resultado de classificação fixo. O parâmetro countOrCondition pode assumir várias formas:
Se um número for especificado, uma lista de até countOrCondition itens em ordem crescente será retornada.
Se uma condição for especificada, uma lista de itens que atendam inicialmente à condição será retornada.
Quando um item falha na condição, nenhum outro item é considerado.

Exemplo 1
Localizar a linha com o maior valor na coluna [a] com a condição [a] > 0 na tabela. As linhas são classificadas antes
da aplicação do filtro.

[Link](
[Link]({
[a = 2, b = 4],
[a = 0, b = 0],
[a = 6, b = 2]
}),
"a",
each [a] > 0
)

UM B

6 2

2 4

Exemplo 2
Localizar a linha com o maior valor na coluna [a] com a condição [b] > 0 na tabela. As linhas são classificadas
antes da aplicação do filtro.
[Link](
[Link]({
[a = 2, b = 4],
[a = 8, b = 0],
[a = 6, b = 2]
}),
"a",
each [b] > 0
)
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, comparisonCriteria as any, optional default as any) as any

Sobre
Retorna a menor linha do table , dado o comparisonCriteria . Se a tabela estiver vazia, o valor opcional de
default será retornado.

Exemplo 1
Localizar a linha com o menor valor na coluna [a] da tabela.

[Link](
[Link]({
[a = 2, b = 4],
[a = 6, b = 8]
}),
"a"
)

UM 2

B 4

Exemplo 2
Localizar a linha com o menor valor na coluna [a] da tabela. Retornará -1 se estiver vazia.

[Link](#table({"a"}, {}), "a", -1)

-1
[Link]
21/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, comparisonCriteria as any, countOrCondition as any) as table

Sobre
Retorna as menores linhas do table , dado o comparisonCriteria . Depois que as linhas são classificadas, o
parâmetro countOrCondition deve ser especificado para filtrar melhor o resultado. Observe que o algoritmo de
classificação não pode garantir um resultado de classificação fixo. O parâmetro countOrCondition pode assumir
várias formas:
Se um número for especificado, uma lista de até countOrCondition itens em ordem crescente será retornada.
Se uma condição for especificada, uma lista de itens que atendam inicialmente à condição será retornada.
Quando um item falha na condição, nenhum outro item é considerado.

Exemplo 1
Localizar a linha com o menor valor na coluna [a] com a condição [a] < 3 na tabela. As linhas são classificadas
antes da aplicação do filtro.

[Link](
[Link]({
[a = 2, b = 4],
[a = 0, b = 0],
[a = 6, b = 4]
}),
"a",
each [a] < 3
)

UM B

0 0

2 4

Exemplo 2
Localizar a linha com o menor valor na coluna [a] com a condição [a] < 0 da tabela. As linhas são classificadas
antes da aplicação do filtro.
[Link](
[Link]({
[a = 2, b = 4],
[a = 8, b = 0],
[a = 6, b = 2]
}),
"a",
each [b] < 0
)
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table1 as table, key1 as any, table2 as any, key2 as any, newColumnName as text,
optional joinKind as nullable number, optional keyEqualityComparers as nullable list) as table

Sobre
Une as linhas de table1 com as linhas de table2 com base na igualdade dos valores das colunas de chave
selecionadas por key1 (para table1 ) e key2 (para table2 ). Os resultados são inseridos na coluna chamada
newColumnName .

O joinKind opcional especifica o tipo de junção a ser executada. Por padrão, uma junção externa esquerda será
executada se uma joinKind não for especificada.
Um conjunto opcional de keyEqualityComparers pode ser incluído para especificar como comparar as colunas de
chave.
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, column as text, groups as number, hash as function) as list

Sobre
Particiona table em uma lista de números groups de tabelas, com base no valor da column e uma função hash .
A função hash é aplicada ao valor da linha column para obter um valor de hash para a linha. O módulo de valor
de hash groups determina em qual das tabelas retornadas a linha será colocada.
table : a tabela a ser particionada.
column : a coluna cujo hash será efetuado para determinar em qual tabela retornada a linha está.
groups : o número de tabelas nas quais a tabela de entrada será particionada.
hash : a função aplicada para obter um valor de hash.

Exemplo
Particione a tabela ({[a = 2, b = 4], [a = 6, b = 8], [a = 2, b = 4], [a = 1, b = 4]}) em duas tabelas na coluna
[a], usando o valor das colunas como função de hash.

[Link](
[Link]({
[a = 2, b = 4],
[a = 1, b = 4],
[a = 2, b = 4],
[a = 1, b = 4]
}),
"a",
2,
each _
)

{
[Link]({
[a = 2, b = 4],
[a = 2, b = 4]
}),
[Link]({
[a = 1, b = 4],
[a = 1, b = 4]
})
}
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, column as text, groups as number, hash as function) as list

Sobre
Particiona table em uma lista de números groups de tabelas, com base no valor da column e uma função hash .
A função hash é aplicada ao valor da linha column para obter um valor de hash para a linha. O módulo de valor
de hash groups determina em qual das tabelas retornadas a linha será colocada.
table : a tabela a ser particionada.
column : a coluna cujo hash será efetuado para determinar em qual tabela retornada a linha está.
groups : o número de tabelas nas quais a tabela de entrada será particionada.
hash : a função aplicada para obter um valor de hash.

Exemplo 1
Particione a tabela ({[a = 2, b = 4], [a = 6, b = 8], [a = 2, b = 4], [a = 1, b = 4]}) em duas tabelas na coluna
[a], usando o valor das colunas como função de hash.

[Link]([Link]({[a = 2, b = 4], [a = 1, b = 4], [a = 2, b = 4], [a = 1, b = 4]}), "a", 2,


each _)

[Tabela]

[Tabela]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, pivotValues as list, attributeColumn as text, valueColumn as text,
optional aggregationFunction as nullable function) as table

Sobre
Dado um par de colunas que representam pares de atributo/valor, gira os dados na coluna de atributo para um
título de coluna.

Exemplo 1
Pegue os valores "a", "b" e "c" na coluna de atributo da tabela
({ [ key = "x", attribute = "a", value = 1 ], [ key = "x", attribute = "c", value = 3 ], [ key = "y", attribute
= "a", value = 2 ], [ key = "y", attribute = "b", value = 4 ] })
e dinamize-os em sua própria coluna.

[Link](
[Link]({
[key = "x", attribute = "a", value = 1],
[key = "x", attribute = "c", value = 3],
[key = "y", attribute = "a", value = 2],
[key = "y", attribute = "b", value = 4]
}),
{"a", "b", "c"},
"attribute",
"value"
)

C H AVE UM B C

x 1 3

a 2 4

Exemplo 2
Pegue os valores "a", "b" e "c" na coluna de atributo da tabela
({ [ key = "x", attribute = "a", value = 1 ], [ key = "x", attribute = "c", value = 3 ], [ key = "x", attribute
= "c", value = 5 ], [ key = "y", attribute = "a", value = 2 ], [ key = "y", attribute = "b", value = 4 ] })
e dinamize-os em sua própria coluna. O atributo "c" para a chave "x" tem vários valores associados a ele. Portanto,
use a função [Link] para resolver o conflito.
[Link](
[Link]({
[key = "x", attribute = "a", value = 1],
[key = "x", attribute = "c", value = 3],
[key = "x", attribute = "c", value = 5],
[key = "y", attribute = "a", value = 2],
[key = "y", attribute = "b", value = 4]
}),
{"a", "b", "c"},
"attribute",
"value",
[Link]
)

C H AVE UM B C

x 1 5

a 2 4
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, row as record, optional occurrence as any, optional
equationCriteria as any) as any

Sobre
Retorna a posição da linha da primeira ocorrência do row no table especificado. Retornará -1 se nenhuma
ocorrência for encontrada.
table : A tabela de entrada.
row : A linha na tabela cuja posição será localizada.
occurrence : [Opcional] Especifica as ocorrências da linha a retornar.
equationCriteria : [Opcional] Controla a comparação entre as linhas da tabela.

Exemplo 1
Localize a posição da primeira ocorrência de [a = 2, b = 4] na tabela
({[a = 2, b = 4], [a = 6, b = 8], [a = 2, b = 4], [a = 1, b = 4]}) .

[Link](
[Link]({
[a = 2, b = 4],
[a = 1, b = 4],
[a = 2, b = 4],
[a = 1, b = 4]
}),
[a = 2, b = 4]
)

Exemplo 2
Localize a posição da segunda ocorrência de [a = 2, b = 4] na tabela
({[a = 2, b = 4], [a = 6, b = 8], [a = 2, b = 4], [a = 1, b = 4]}) .

[Link](
[Link]({
[a = 2, b = 4],
[a = 1, b = 4],
[a = 2, b = 4],
[a = 1, b = 4]
}),
[a = 2, b = 4],
1
)
2

Exemplo 3
Localize a posição de todas as ocorrências de [a = 2, b = 4] na tabela
({[a = 2, b = 4], [a = 6, b = 8], [a = 2, b = 4], [a = 1, b = 4]}) .

[Link](
[Link]({
[a = 2, b = 4],
[a = 1, b = 4],
[a = 2, b = 4],
[a = 1, b = 4]
}),
[a = 2, b = 4],
[Link]
)

2
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, rows as list, optional occurrence as nullable number, optional
equationCriteria as any) as any

Sobre
Retorna as posições das linhas da table da primeira ocorrência da lista de rows . Retornará -1 se nenhuma
ocorrência for encontrada.
table : A tabela de entrada.
rows : A lista de linhas na tabela cujas posições deverão ser encontradas.
occurrence : [Opcional] Especifica as ocorrências da linha a retornar.
equationCriteria : [Opcional] Controla a comparação entre as linhas da tabela.

Exemplo 1
Localize a posição da primeira ocorrência de [a = 2, b = 4] ou [a = 6, b = 8] na tabela
({[a = 2, b = 4], [a = 6, b = 8], [a = 2, b = 4], [a = 1, b = 4]}) .

[Link](
[Link]({
[a = 2, b = 4],
[a = 1, b = 4],
[a = 2, b = 4],
[a = 1, b = 4]
}),
{
[a = 2, b = 4],
[a = 6, b = 8]
}
)

Exemplo 2
Localize a posição de todas as ocorrências de [a = 2, b = 4] ou [a = 6, b = 8] na tabela
({[a = 2, b = 4], [a = 6, b = 8], [a = 2, b = 4], [a = 1, b = 4]} .
[Link](
[Link]({
[a = 2, b = 4],
[a = 6, b = 8],
[a = 2, b = 4],
[a = 1, b = 4]
}),
{
[a = 2, b = 4],
[a = 6, b = 8]
},
[Link]
)

2
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, prefix as text) as table

Sobre
Retorna uma tabela em que todos os nomes de coluna da table fornecida são prefixados com o texto fornecido,
prefix , mais um ponto no formulário prefix .ColumnName .

Exemplo 1
Prefixe as colunas com "MyTable" na tabela.

[Link](
[Link]({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
"MyTable"
)

M Y TA B L E. C USTO M ERID M Y TA B L E. N A M E M Y TA B L E. P H O N E

1 Bob 123-4567
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, optional additionalAggregates as nullable list) as table

Sobre
Retorna um perfil para as colunas em table .
As informações a seguir são retornadas para cada coluna (quando aplicável):
mínimo
máximo
média
desvio padrão
contagem
contagem de nulos
contagem distinta
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, optional options as nullable record) as table

Sobre
Promove a primeira linha de valores como novos cabeçalhos de coluna (por exemplo, nomes de coluna). Por
padrão, apenas valores de texto ou número são promovidos para cabeçalhos. Opções válidas:
PromoteAllScalars : Se definido como true , todos os valores escalares na primeira linha serão promovidos para os
cabeçalhos usando a Culture , se especificado (ou a localidade do documento atual). Para valores que não podem ser
convertidos em texto, será usado um nome da coluna padrão.
Culture : Um nome de cultura especificando a cultura dos dados.

Exemplo 1
Promover a primeira linha de valores na tabela.

[Link](
[Link]({
[Column1 = "CustomerID", Column2 = "Name", Column3 = #date(1980, 1, 1)],
[Column1 = 1, Column2 = "Bob", Column3 = #date(1980, 1, 1)]
})
)

C USTO M ERID NOME C O L UM N 3

1 Bob 1/1/1980 12:00:00 AM

Exemplo 2
Promova todos os escalares na primeira linha da tabela a cabeçalhos.

[Link](
[Link]({
[Rank = 1, Name = "Name", Date = #date(1980, 1, 1)],
[Rank = 1, Name = "Bob", Date = #date(1980, 1, 1)]}
),
[PromoteAllScalars = true, Culture = "en-US"]
)

1 NOME 1/ 1/ 1980

1 Bob 1/1/1980 12:00:00 AM


[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, offset as number, optional count as nullable number) as table

Sobre
Retorna as linhas da table começando no offset especificado. Um parâmetro opcional, count , especifica
quantas linhas retornar. Por padrão, todas as linhas após o deslocamento são retornadas.

Exemplo 1
Retornar todas as linhas que começam no deslocamento 1 da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
1
)

C USTO M ERID NOME T EL EF O N E

2 Jim 987-6543

3 Paul 543-7890

4 Ringo 232-1550

Exemplo 2
Retornar uma linha que começa no deslocamento 1 da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
1,
1
)

C USTO M ERID NOME T EL EF O N E


2 Jim 987-6543
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, columns as any, optional missingField as nullable number) as
table

Sobre
Remove o columns especificado do table fornecido. Se a coluna não existir, uma exceção será gerada, a menos
que o parâmetro opcional missingField especifique uma alternativa (por exemplo, [Link] ou
[Link] ).

Exemplo 1
Remova a coluna [Phone] da tabela.

[Link](
[Link]({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
"Phone"

C USTO M ERID NOME

1 Bob

Exemplo 2
Remova a coluna [Address] da tabela. Gera um erro se ele não existe.

[Link](
[Link]({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
"Address"
)

[[Link]] The field 'Address' of the record was not found.


[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, optional countOrCondition as any) as table

Sobre
Retorna uma tabela que não contém o primeiro número especificado de linhas, countOrCondition , da tabela table
. O número de linhas removidas depende do parâmetro opcional countOrCondition .
Se countOrCondition for omitido, somente a primeira linha será removida.
Se countOrCondition for um número, serão removidas muitas linhas (começando na parte superior).
Se countOrCondition for uma condição, as linhas que atendem à condição serão removidas até que uma linha
não atenda à condição.

Exemplo 1
Remover a primeira linha da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
1
)

C USTO M ERID NOME T EL EF O N E

2 Jim 987-6543

3 Paul 543-7890

4 Ringo 232-1550

Exemplo 2
Remover as duas primeiras linhas da tabela.
[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
2
)

C USTO M ERID NOME T EL EF O N E

3 Paul 543-7890

4 Ringo 232-1550

Exemplo 3
Remover da tabela as primeiras linhas em que [CustomerID] <=2.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"] ,
[CustomerID = 3, Name = "Paul", Phone = "543-7890"] ,
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
each [CustomerID] <= 2
)

C USTO M ERID NOME T EL EF O N E

3 Paul 543-7890

4 Ringo 232-1550
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, optional countOrCondition as any) as table

Sobre
Retorna uma tabela que não contém as countOrCondition últimas linhas da tabela table . O número de linhas
removidas depende do parâmetro opcional countOrCondition .
Se countOrCondition for omitido, somente a última linha será removida.
Se countOrCondition for um número, essa quantidade de linhas (começando na parte inferior) será removida.
Se countOrCondition for uma condição, as linhas que atendem à condição serão removidas até que uma linha
não atenda à condição.

Exemplo 1
Remover a última linha da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
1
)

C USTO M ERID NOME T EL EF O N E

1 Bob 123-4567

2 Jim 987-6543

3 Paul 543-7890

Exemplo 2
Remover da tabela as últimas linhas em que [CustomerID] > 2.
[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
each [CustomerID] >= 2
)

C USTO M ERID NOME T EL EF O N E

1 Bob 123-4567
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, rows as list, optional equationCriteria as any) as table

Sobre
Remove todas as ocorrências das rows especificadas da table . Um parâmetro equationCriteria opcional pode
ser especificado para controlar a comparação entre as linhas da tabela.

Exemplo 1
Remova todas as linhas em que [a = 1] da tabela ({[a = 1, b = 2], [a = 3, b = 4], [a = 1, b = 6]}) .

[Link](
[Link]({
[a = 1, b = 2],
[a = 3, b = 4],
[a = 1, b = 6]
}),
{[a = 1]},
"a"
)

UM B

3 4
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, offset as number, optional count as nullable number) as table

Sobre
Remove count de linhas do início do table , começando pelo offset especificado. Uma contagem padrão de 1
será usada se o parâmetro count não for fornecido.

Exemplo 1
Remover a primeira linha da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
0
)

C USTO M ERID NOME T EL EF O N E

2 Jim 987-6543

3 Paul 543-7890

4 Ringo 232-1550

Exemplo 2
Remover a linha na posição 1 da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
1
)

C USTO M ERID NOME T EL EF O N E


1 Bob 123-4567

3 Paul 543-7890

4 Ringo 232-1550

Exemplo 3
Remover duas linhas começando na posição 1 da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
1,
2
)

C USTO M ERID NOME T EL EF O N E

1 Bob 123-4567

4 Ringo 232-1550
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, optional columns as nullable list) as table

Sobre
Retorna uma tabela com as linhas removidas da tabela de entrada que contêm um erro em pelo menos uma das
células. Se uma lista de colunas for especificada, somente as células nas colunas especificadas serão inspecionadas
quanto a erros.

Exemplo 1
Remove um valor de erro da primeira linha.

[Link](
[Link]({
[Column1 = ...],
[Column1 = 2],
[Column1 = 3]
})
)

C O L UN A 1

3
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, renames as list, optional missingField as nullable number) as
table

Sobre
Executa os renomeações fornecidas para as colunas na tabela table . Uma operação de substituição renames
consiste em uma lista de dois valores, o nome de coluna antigo e o novo, fornecidos em uma lista. Se a coluna não
existir, uma exceção será gerada, a menos que o parâmetro opcional missingField especifique uma alternativa
(por exemplo, [Link] ou [Link] ).

Exemplo 1
Substituir o nome de coluna "CustomerNum" por "CustomerID" na tabela.

[Link](
[Link]({[CustomerNum = 1, Name = "Bob", Phone = "123-4567"]}),
{"CustomerNum", "CustomerID"}
)

C USTO M ERID NOME T EL EF O N E

1 Bob 123-4567

Exemplo 2
Substituir o nome de coluna "CustomerNum" por "CustomerID" e "PhoneNum" por "Phone" na tabela.

[Link](
[Link]({[CustomerNum = 1, Name = "Bob", PhoneNum = "123-4567"]}),
{
{"CustomerNum", "CustomerID"},
{"PhoneNum", "Phone"}
}
)

C USTO M ERID NOME T EL EF O N E

1 Bob 123-4567

Exemplo 3
Substituir o nome de coluna "NewCol" por "NewColumn" na tabela e ignorar se a coluna não existir.
[Link](
[Link]({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
{"NewCol", "NewColumn"},
[Link]
)

C USTO M ERID NOME T EL EF O N E

1 Bob 123-4567
[Link]
21/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, columnOrder as list, optional missingField as nullable
number) as table

Sobre
Retorna uma tabela da entrada table , com as colunas na ordem especificada por columnOrder . As colunas que
não forem especificadas na lista não serão reordenadas. Se a coluna não existir, uma exceção será gerada, a menos
que o parâmetro opcional missingField especifique uma alternativa (por exemplo, [Link] ou
[Link] ).

Exemplo 1
Alternar a ordem das colunas [Phone] e [Name] na tabela.

[Link](
[Link]({[CustomerID = 1, Phone = "123-4567", Name = "Bob"]}),
{"Name", "Phone"}
)

C USTO M ERID NOME T EL EF O N E

1 Bob 123-4567

Exemplo 2
Alterne a ordem das colunas [Phone] e [Address] ou use "[Link]" na tabela. Ele não altera a tabela
porque a coluna [Address] não existe.

[Link](
[Link]({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
{"Phone", "Address"},
[Link]
)

C USTO M ERID NOME T EL EF O N E

1 Bob 123-4567
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, count as number) as table

Sobre
Retorna uma tabela com as linhas da entrada table repetidas as count vezes especificadas.

Exemplo 1
Repetir as linhas da tabela duas vezes.

[Link](
[Link]({
[a = 1, b = "hello"],
[a = 3, b = "world"]
}),
2

UM B

1 olá

3 mundo

1 olá

3 mundo
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, errorReplacement as list) as table

Sobre
Substitui os valores de erro nas colunas especificadas do table pelos novos valores na lista errorReplacement . O
formato da lista é {{coluna1, valor1},...}. Pode haver apenas um valor de substituição por coluna; especificar a coluna
mais de uma vez resultará em um erro.

Exemplo 1
Substituir o valor de erro pelo texto "mundo" na tabela.

[Link](
[Link]({{1, "hello"}, {3, ...}}, {"A", "B"}),
{"B", "world"}
)

A B

1 olá

3 mundo

Exemplo 2
Substituir o valor de erro na coluna A pelo texto "olá" e na coluna B pelo texto "mundo" na tabela.

[Link](
[Link]({{..., ...}, {1, 2}}, {"A", "B"}),
{{"A", "hello"}, {"B", "world"}}
)

A B

olá mundo

1 2
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, keys as list) as table

Sobre
[Link]
[Link]
21/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, replacements as list, optional equationCriteria as any)
as table

Sobre
Substitui todas as linhas especificadas na table pelas linhas fornecidas. As linhas a serem substituídas e as
substituições são especificadas em replacements , usando a formatação {old, new}. Um parâmetro
equationCriteria opcional pode ser especificado para controlar a comparação entre as linhas da tabela.

Exemplo 1
Substituir as linhas [a = 1, b = 2] e [a = 2, b = 3] por [a = -1, b = -2],[a = -2, b = -3] na tabela.

[Link](
[Link]({
[a = 1, b = 2],
[a = 2, b = 3],
[a = 3, b = 4],
[a = 1, b = 2]
}),
{
{[a = 1, b = 2], [a = -1, b = -2]},
{[a = 2, b = 3], [a = -2, b = -3]}
}
)

UM B

-1 -2

-2 -3

3 4

-1 -2
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, identity as text) as any

Sobre
[Link]
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, offset as number, count as number, rows as list) as table

Sobre
Substitui um número especificado de linhas, count , no table de entrada pelo rows especificado, começando
após o offset . O parâmetro rows é uma lista de registros.
table : A tabela em que a substituição é executada.
offset : O número de linhas a serem ignoradas antes de fazer a substituição.
count : Número de linhas a ser substituídas.
rows : A lista de registros de linha a serem inseridos no table na localização especificada pelo offset .

Exemplo 1
Começando na posição 1, substituir 3 linhas.

[Link](
[Link]({
[Column1 = 1],
[Column1 = 2],
[Column1 = 3],
[Column1 = 4],
[Column1 = 5]
}),
1,
3,
{[Column1 = 6], [Column1 = 7]}
)

C O L UN A 1

5
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, oldValue as any, newValue as any, replacer as function,
columnsToSearch as list) as table

Sobre
Substitui oldValue por newValue nas colunas especificadas da table .

Exemplo 1
Substituir o texto "adeus" pelo texto "mundo" na tabela.

[Link](
[Link]({
[a = 1, b = "hello"],
[a = 3, b = "goodbye"]
}),
"goodbye",
"world",
[Link],
{"b"}
)

UM B

1 olá

3 mundo

Exemplo 2
Substitua o texto "uo" pelo texto "ou" na tabela.

[Link](
[Link]({
[a = 1, b = "hello"],
[a = 3, b = "wurld"]
}),
"ur",
"or",
[Link],
{"b"}
)

UM B

1 olá
3 mundo
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text) as nullable text

Sobre
Inverte o text fornecido.

Exemplo 1
Inverta o texto "123".

[Link]("123")

"321"
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table) as table

Sobre
Retorna uma tabela com as linhas da entrada table na ordem inversa.

Exemplo 1
Inverter as linhas da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
})
)

C USTO M ERID NOME T EL EF O N E

4 Ringo 232-1550

3 Paul 543-7890

2 Jim 987-6543

1 Bob 123-4567
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table) as number

Sobre
Retorna o número de linhas na table .

Exemplo 1
Encontre o número de linhas da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"]
})
)

3
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table) as table

Sobre
Retorna uma tabela que descreve as colunas de table .
Cada linha na tabela descreve as propriedades de uma coluna de table :

Nome de coluna Descrição

Name O nome da coluna.

Position A posição baseada em 0 da coluna em table .

TypeName O nome do tipo da coluna.

Kind A espécie de tipo da coluna.

IsNullable Se a coluna pode conter valores null .

NumericPrecisionBase A base numérica (por exemplo, base-2, base-10) dos campos


NumericPrecision e NumericScale .

NumericPrecision A precisão de uma coluna numérica na base especificada por


NumericPrecisionBase . Este é o número máximo de dígitos
que podem ser representados por um valor desse tipo
(incluindo dígitos fracionários).

NumericScale A escala de uma coluna numérica na base especificada por


NumericPrecisionBase . Esse é o número de dígitos na parte
fracionária de um valor desse tipo. Um valor de 0 indica uma
escala fixa sem dígitos fracionários. Um valor de null indica
que a escala não é conhecida (seja porque é flutuante ou não
está definida).

DateTimePrecision O número máximo de dígitos fracionários com suporte na


parte de segundos de um valor de data ou hora.

MaxLength O número máximo de caracteres permitidos em uma coluna


text ou o número máximo de bytes permitidos em uma
coluna binary .

IsVariableLength Indica se essa coluna pode variar de comprimento (até


MaxLength ) ou se é de tamanho fixo.
NativeTypeName O nome do tipo da coluna no sistema de tipos nativo da fonte
(por exemplo, nvarchar para SQL Server).

NativeDefaultExpression A expressão padrão para um valor dessa coluna na linguagem


de expressão nativa da fonte (por exemplo, 42 ou newid()
para SQL Server).

Description A descrição da coluna.


[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, columns as any, optional missingField as nullable number) as
table

Sobre
Retorna o table apenas com o columns especificado.
table : A tabela fornecida.
columns : A lista de colunas da tabela table a ser retornada. As colunas na tabela retornada estão na ordem
listada em columns .
missingField : (Opcional) o que fazer se a coluna não existir. Exemplo: [Link] ou
[Link] .

Exemplo 1
Inclui apenas a coluna [Name].

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
"Name"
)

NOME

Bob

Jim

Paul

Ringo

Exemplo 2
Inclui apenas as colunas [CustomerID] e [Name].
[Link](
[Link]({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
{"CustomerID", "Name"}
)

C USTO M ERID NOME

1 Bob

Exemplo 3
Se a coluna incluída não sair, o resultado padrão será um erro.

[Link](
[Link]({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
"NewColumn"
)

[[Link]] The field 'NewColumn' of the record wasn't found.

Exemplo 4
Se a coluna incluída não sair, a opção [Link] criará uma coluna de valores nulos.

[Link](
[Link]({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
{"CustomerID", "NewColumn"},
[Link]
)

C USTO M ERID N O VA C O L UN A

1
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, condition as function) as table

Sobre
Retorna uma tabela de linhas da table que corresponde à seleção condition .

Exemplo 1
Seleciona as linhas da tabela em que os valores da coluna [CustomerID] são maiores que 2.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
each [CustomerID] > 2
)

C USTO M ERID NOME T EL EF O N E

3 Paul 543-7890

4 Ringo 232-1550

Exemplo 2
Seleciona as linhas da tabela em que os nomes não contêm um "B".

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
each not [Link]([Name], "B")
)

C USTO M ERID NOME T EL EF O N E

2 Jim 987-6543

3 Paul 543-7890
4 Ringo 232-1550
[Link]
21/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, optional columns as nullable list) as table

Sobre
Retorna uma tabela apenas com as linhas da tabela de entrada que contêm um erro em pelo menos uma das
células. Se uma lista de colunas for especificada, somente as células nas colunas especificadas serão inspecionadas
quanto a erros.

Exemplo 1
Seleciona os nomes de clientes com erros nas linhas.

[Link](
[Link]({
[CustomerID = ..., Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
})
)[Name]

Bob
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table) as record

Sobre
Retorna a única linha da linha table . Se table tiver mais de uma linha, uma exceção será lançada.

Exemplo 1
Retornar a única linha da tabela.

[Link]([Link]({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}))

C USTO M ERID 1

NOME Bob

T EL EF O N E 123-4567
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, optional countOrCondition as any) as table

Sobre
Retorna uma tabela que não contém o primeiro número especificado de linhas, countOrCondition , da tabela table
. O número de linhas ignoradas depende do parâmetro opcional countOrCondition .
Se countOrCondition for omitido, somente a primeira linha será ignorada.
Se countOrCondition for um número, serão ignoradas muitas linhas (começando na parte superior).
Se countOrCondition for uma condição, as linhas que atendem à condição serão ignoradas até que uma linha
não atenda à condição.

Exemplo 1
Ignorar a primeira linha da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
1
)

C USTO M ERID NOME T EL EF O N E

2 Jim 987-6543

3 Paul 543-7890

4 Ringo 232-1550

Exemplo 2
Ignorar as duas primeiras linhas da tabela.
[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
}),
2
)

C USTO M ERID NOME T EL EF O N E

3 Paul 543-7890

4 Ringo 232-1550

Exemplo 3
Ignorar as primeiras linhas em que [Price] > 25 na tabela.

[Link](
[Link]({
[OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100.0],
[OrderID = 2, CustomerID = 1, Item = "1 lb. worms", Price = 5.0],
[OrderID = 3, CustomerID = 2, Item = "Fishing net", Price = 25.0],
[OrderID = 4, CustomerID = 3, Item = "Fish tazer", Price = 200.0],
[OrderID = 5, CustomerID = 3, Item = "Bandaids", Price = 2.0],
[OrderID = 6, CustomerID = 1, Item = "Tackle box", Price = 20.0],
[OrderID = 7, CustomerID = 5, Item = "Bait", Price = 3.25],
[OrderID = 8, CustomerID = 5, Item = "Fishing Rod", Price = 100.0],
[OrderID = 9, CustomerID = 6, Item = "Bait", Price = 3.25]
}),
each [Price] > 25
)

O RDERID C USTO M ERID IT EM P REÇ O

2 1 1 lb de minhocas 5

3 2 Rede de pesca 25

4 3 Taser de peixe 200

5 3 Bandaids 2

6 1 Caixa de material de pesca 20

7 5 Isca 3,25

8 5 Vara de pescar 100

9 6 Isca 3,25
[Link]
08/05/2020 • 4 minutes to read

Sintaxe
[Link](table as table, comparisonCriteria as any) as table

Sobre
Classifica a table usando a lista de um ou mais nomes de coluna e o comparisonCriteria opcional no formato {{
{{ col1, comparisonCriteria }}, {{col2}} }}.

Exemplo 1
Classificar a tabela na coluna "OrderID".

[Link](
[Link]({
[OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100.0],
[OrderID = 2, CustomerID = 1, Item = "1 lb. worms", Price = 5.0],
[OrderID = 3, CustomerID = 2, Item = "Fishing net", Price = 25.0],
[OrderID = 4, CustomerID = 3, Item = "Fish tazer", Price = 200.0],
[OrderID = 5, CustomerID = 3, Item = "Bandaids", Price = 2.0],
[OrderID = 6, CustomerID = 1, Item = "Tackle box", Price = 20.0],
[OrderID = 7, CustomerID = 5, Item = "Bait", Price = 3.25],
[OrderID = 8, CustomerID = 5, Item = "Fishing Rod", Price = 100.0],
[OrderID = 9, CustomerID = 6, Item = "Bait", Price = 3.25]
}),
{"OrderID"}
)

O RDERID C USTO M ERID IT EM P REÇ O

1 1 Vara de pescar 100

2 1 1 lb de minhocas 5

3 2 Rede de pesca 25

4 3 Taser de peixe 200

5 3 Bandaids 2

6 1 Caixa de material de pesca 20

7 5 Isca 3,25

8 5 Vara de pescar 100

9 6 Isca 3,25
Exemplo 2
Classificar a tabela na coluna "OrderID" em ordem decrescente.

[Link](
[Link]({
[OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100.0],
[OrderID = 2, CustomerID = 1, Item = "1 lb. worms", Price = 5.0],
[OrderID = 3, CustomerID = 2, Item = "Fishing net", Price = 25.0],
[OrderID = 4, CustomerID = 3, Item = "Fish tazer", Price = 200.0],
[OrderID = 5, CustomerID = 3, Item = "Bandaids", Price = 2.0],
[OrderID = 6, CustomerID = 1, Item = "Tackle box", Price = 20.0],
[OrderID = 7, CustomerID = 5, Item = "Bait", Price = 3.25],
[OrderID = 8, CustomerID = 5, Item = "Fishing Rod", Price = 100.0],
[OrderID = 9, CustomerID = 6, Item = "Bait", Price = 3.25]
}),
{"OrderID", [Link]}
)

O RDERID C USTO M ERID IT EM P REÇ O

9 6 Isca 3,25

8 5 Vara de pescar 100

7 5 Isca 3,25

6 1 Caixa de material de pesca 20

5 3 Bandaids 2

4 3 Taser de peixe 200

3 2 Rede de pesca 25

2 1 1 lb de minhocas 5

1 1 Vara de pescar 100

Exemplo 3
Classificar a tabela na coluna "CustomerID" e depois em "OrderID", com "CustomerID" em ordem crescente.
[Link](
[Link]({
[OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100.0],
[OrderID = 2, CustomerID = 1, Item = "1 lb. worms", Price = 5.0],
[OrderID = 3, CustomerID = 2, Item = "Fishing net", Price = 25.0],
[OrderID = 4, CustomerID = 3, Item = "Fish tazer", Price = 200.0],
[OrderID = 5, CustomerID = 3, Item = "Bandaids", Price = 2.0],
[OrderID = 6, CustomerID = 1, Item = "Tackle box", Price = 20.0],
[OrderID = 7, CustomerID = 5, Item = "Bait", Price = 3.25],
[OrderID = 8, CustomerID = 5, Item = "Fishing Rod", Price = 100.0],
[OrderID = 9, CustomerID = 6, Item = "Bait", Price = 3.25]
}),
{
{"CustomerID", [Link]},
"OrderID"
}
)

O RDERID C USTO M ERID IT EM P REÇ O

1 1 Vara de pescar 100

2 1 1 lb de minhocas 5

6 1 Caixa de material de pesca 20

3 2 Rede de pesca 25

4 3 Taser de peixe 200

5 3 Bandaids 2

7 5 Isca 3,25

8 5 Vara de pescar 100

9 6 Isca 3,25
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, pageSize as number) as list

Sobre
Divide o table em uma lista de tabelas em que o primeiro elemento da lista é uma tabela que contém as
primeiras pageSize linhas da tabela de origem, o próximo elemento da lista é uma tabela que contém as próximas
pageSize linhas da tabela de origem etc.

Exemplo 1
Divida uma tabela de cinco registros em tabelas com dois registros cada.

let
Customers = [Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Cristina", Phone = "232-1550"],
[CustomerID = 5, Name = "Anita", Phone = "530-1459"]
})
in
[Link](Customers, 2)

[Tabela]

[Tabela]

[Tabela]
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, sourceColumn as text, splitter as function, optional
columnNamesOrNumber as any, optional default as any, optional extraColumns as any) as table

Sobre
Divide as colunas especificadas em um conjunto de colunas adicionais usando a função de divisão especificada.

Exemplo 1
Divida a coluna [Name] em duas na posição do "i"

let
Customers = [Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"],
[CustomerID = 4, Name = "Cristina", Phone = "232-1550"]
})
in
[Link](Customers, "Name", [Link]("i"), 2

C USTO M ERID N A M E. 1 N A M E. 2 T EL EF O N E

1 Bob 123-4567

2 J m 987-6543

3 Paul 543-7890

4 Cr ST 232-1550
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table) as list

Sobre
Cria uma lista de listas aninhadas da tabela, table . Cada item de lista é uma lista interna que contém os valores de
coluna.

Exemplo
Criar uma lista dos valores de coluna da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"]
})
)

[Lista]

[Lista]

[Lista]
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, optional combiner as nullable function) as list

Sobre
Converte uma tabela em lista aplicando a função de combinação especificada a cada linha de valores na tabela.

Exemplo 1
Combina o texto de todas as linhas com uma vírgula.

[Link](
[Link]({
{[Link](1), "Bob", "123-4567"},
{[Link](2), "Jim", "987-6543"},
{[Link](3), "Paul", "543-7890"}
}),
[Link](",")
)

1,Bob,123-4567

2,Jim,987-6543

3,Paul,543-7890
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table) as list

Sobre
Converte uma tabela, table , em uma lista de registros.

Exemplo
Converta a tabela em uma lista de registros.

[Link](
[Link](
{
{1, "Bob", "123-4567"},
{2, "Jim", "987-6543"},
{3, "Paul", "543-7890"}
},
{"CustomerID", "Name", "Phone"}
)
)

[Registro]

[Registro]

[Registro]
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table) as list

Sobre
Cria uma lista de listas aninhadas da tabela, table . Cada item de lista é uma lista interna que contém os valores de
linha.

Exemplo
Crie uma lista dos valores de linha da tabela.

[Link](
[Link]({
[CustomerID = 1, Name = "Bob", Phone = "123-4567"],
[CustomerID = 2, Name = "Jim", Phone = "987-6543"],
[CustomerID = 3, Name = "Paul", Phone = "543-7890"]
})
)

[Lista]

[Lista]

[Lista]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, nameGenerator as function, optional options as nullable
record) as table

Sobre
Transforma nomes de colunas ao usar a função nameGenerator fornecida. Opções válidas:
MaxLength especifica o comprimento máximo de novos nomes de coluna. Se a função fornecida resultar em um nome
de coluna maior, o nome longo será cortado.
Comparer é usado para controlar a comparação ao gerar novos nomes de coluna. Os comparadores podem ser usados
para fornecer comparações com detecção de localidade e cultura ou sem diferenciação de maiúsculas e minúsculas.
Os seguintes comparadores internos estão disponíveis na linguagem da fórmula:
[Link] : Usado para executar uma comparação ordinal exata
[Link] : Usado para executar uma comparação ordinal exata sem diferenciação de
maiúsculas e minúsculas
[Link] : Usado para executar uma comparação com detecção de cultura

Exemplo 1
Remover o caractere de #(tab) dos nomes de coluna

[Link]([Link]({[#"Col#(tab)umn" = 1]}), [Link])

C O L UN A

Exemplo 2
Transforme nomes de coluna para gerar nomes de comprimento 6 sem diferenciação de maiúsculas e minúsculas.

[Link](
[Link]({[ColumnNum = 1, cOlumnnum = 2, coLumnNUM = 3]}),
[Link],
[MaxLength = 6, Comparer = [Link]]
)

C O L UN A C O L UM 1 C O L UM 2

1 2 3
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, transformOperations as list, optional defaultTransformation
as nullable function, optional missingField as nullable number) as table

Sobre
Retorna uma tabela da entrada table aplicando a operação de transformação às colunas especificadas no
parâmetro transformOperations (cujo formato é { nome da coluna, transformação}). Se a coluna não existir, uma
exceção será gerada, a menos que o parâmetro opcional defaultTransformation especifique uma alternativa (por
exemplo, [Link] ou [Link] ).

Exemplo 1
Transforma os valores numéricos da coluna [A] em valores numéricos.

[Link](
[Link]({
[A = "1", B = 2],
[A = "5", B = 10]
}),
{"A", [Link]}
)

A B

1 2

5 10

Exemplo 2
Transforma os valores numéricos da coluna ausente [X] em valores de texto, ignorando colunas inexistentes.

[Link](
[Link]({
[A = "1", B = 2],
[A = "5", B = 10]
}),
{"X", [Link]},
null,
[Link]
)

A B

1 2
5 10

Exemplo 3
Transforma os valores numéricos da coluna ausente [X] em valores de texto, usando nulo como padrão em
colunas inexistentes.

[Link](
[Link]({
[A = "1", B = 2],
[A = "5", B = 10]
}),
{"X", [Link]},
null,
[Link]
)

A B X

1 2

5 10

Exemplo 4
Transforma os valores numéricos da coluna ausente [X] em valores de texto, retornando um erro em colunas
inexistentes.

[Link](
[Link]({
[A = "1", B = 2],
[A = "5", B = 10]
}),
{"X", [Link]}
)

[[Link]] The column 'X' of the table wasn't found.


[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, typeTransformations as list, optional culture as
nullable text) as table

Sobre
Retorna uma tabela da entrada table aplicando a operação de transformação às colunas especificadas no
parâmetro typeTransformations (em que formato é {nome da coluna, nome do tipo}), usando a cultura especificada
no parâmetro opcional culture (por exemplo, "pt-BR"). Se a coluna não existir, uma exceção será gerada.

Exemplo 1
Transforme os valores numéricos da coluna [a] em valores de texto da tabela ({[a = 1, b = 2], [a = 3, b = 4]}) .

[Link](
[Link]({
[a = 1, b = 2],
[a = 3, b = 4]
}),
{"a", type text},
"en-US"
)

UM B

1 2

3 4
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, transform as function) as list

Sobre
Cria uma tabela de table aplicando a operação transform às linhas. Se o tipo de retorno da função transform for
especificado, o resultado será uma tabela com esse tipo de linha. Em todos os outros casos, o resultado dessa
função será uma lista com um tipo de item do tipo de retorno da função de transformação.

Exemplo 1
Transforme as linhas em uma lista de números com base na tabela
({[A = 1], [A = 2], [A = 3], [A = 4], [A = 5]}) .

[Link](
[Link]({
[a = 1],
[a = 2],
[a = 3],
[a = 4],
[a = 5]
}),
each [a]
)

Exemplo 2
Transforme as linhas da coluna [A] em valores de texto em uma coluna [B] com base na tabela
({[A = 1], [A = 2], [A = 3], [A = 4], [A = 5]) .
[Link](
[Link]({
[a = 1],
[a = 2],
[a = 3],
[a = 4],
[a = 5]
}),
(row) as record => [B = [Link](row[a])]
)

[Registro]

[Registro]

[Registro]

[Registro]

[Registro]
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, optional columns as any) as table

Sobre
Transforma colunas em linhas e linhas em colunas.

Exemplo 1
Transforme as linhas da tabela de pares de nome/valor em colunas.

[Link](
[Link]({
[Name = "Full Name", Value = "Fred"],
[Name = "Age", Value = 42],
[Name = "Country", Value = "UK"]
})
)

C O L UN A 1 C O L UN A 2 C O L UM N 3

Nome completo Idade País

Fred 42 REINO UNIDO


[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, pivotColumns as list, attributeColumn as text, valueColumn as text)
as table

Sobre
Converte um conjunto de colunas de uma tabela em pares de atributo/valor, combinados com o restante dos
valores em cada linha.

Exemplo 1
Transforme as colunas "a", "b" e "c" da tabela
({[ key = "x", a = 1, b = null, c = 3 ], [ key = "y", a = 2, b = 4, c = null ]}) em pares de atributo/valor.

[Link](
[Link]({
[key = "x", a = 1, b = null, c = 3],
[key = "y", a = 2, b = 4, c = null]
}),
{"a", "b", "c"},
"attribute",
"value"
)

C H AVE AT RIB UTO VA LO R

x um 1

x c 3

a um 2

a b 4
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](table as table, pivotColumns as list, attributeColumn as text,
valueColumn as text) as table

Sobre
Converte todas as colunas que não sejam um conjunto especificado em pares de atributo/valor, combinados com o
restante dos valores em cada linha.

Exemplo 1
Converte todas as colunas que não sejam um conjunto especificado em pares de atributo/valor, combinados com o
restante dos valores em cada linha.

[Link](
[Link]({
[key = "key1", attribute1 = 1, attribute2 = 2, attribute3 = 3],
[key = "key2", attribute1 = 4, attribute2 = 5, attribute3 = 6]
}),
{"key"},
"column1",
"column2"
)

C H AVE C O L UM N 1 C O L UM N 2

key1 attribute1 1

key1 attribute2 2

key1 attribute3 3

key2 attribute1 4

key2 attribute2 5

key2 attribute3 6
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as nullable table, handlers as record) as table

Sobre
Retorna uma exibição de table em que as funções especificadas em handlers são usadas no lugar do
comportamento padrão de uma operação quando a operação é aplicada à exibição. Funções de manipulador são
opcionais. Se uma função de manipulador não for especificada para uma operação, o comportamento padrão da
operação será aplicado a table em vez disso (exceto no caso de GetExpression ).
As funções de manipulador devem retornar um valor que seja semanticamente equivalente ao resultado da
aplicação da operação em relação a table (ou à exibição resultante, no caso de GetExpression ).
Se uma função de manipulador gerar um erro, o comportamento padrão da operação será aplicado à exibição.
[Link] pode ser usado para implementar a dobragem em uma fonte de dados – a conversão de consultas M
em consultas específicas da fonte (por exemplo, para criar instruções T-SQL com base em consultas M).
Confira a documentação publicada para obter uma descrição mais completa de [Link] .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](function as function) as function

Sobre
Cria uma função de exibição baseada em function que pode ser manipulada em uma exibição criada por
[Link] .

O manipulador de OnInvoke de [Link] pode ser usado para definir um manipulador para a função de
exibição.
Assim como os manipuladores para operações internas, se nenhum manipulador de OnInvoke for especificado, se
ele não tratar a função de exibição ou se um erro for gerado pelo manipulador, function será aplicado na parte
superior da exibição.
Confira a documentação publicada para obter uma descrição mais completa das funções de [Link] e de
exibição personalizada.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](tables as table, optional dataColumn as nullable text) as table

Sobre
Obtém os relacionamentos entre um conjunto de tabelas. Presume-se que o conjunto tables tenha uma estrutura
semelhante à de uma tabela de navegação. A coluna definida por dataColumn contém as tabelas de dados reais.
#table
08/05/2020 • 2 minutes to read

Sintaxe
#table(columns as any, rows as any) as any

Sobre
Cria um valor de tabela de colunas columns e a lista rows em que cada elemento da lista é uma lista interna que
contém os valores de coluna para uma única linha. columns pode ser uma lista de nomes de coluna, um tipo de
tabela, um número de colunas ou nulo.
Funções de texto
08/05/2020 • 8 minutes to read

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

Texto
Informações
F UN Ç Ã O DESC RIÇ Ã O

[Link] Infere o tipo de número granular ([Link], [Link]


etc.) de text usando culture .

[Link] Retorna o número de caracteres em um valor de texto.

Comparações de texto
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna um número para seu valor de caractere.

[Link] Retorna um caractere para seu valor numérico.

[Link] Retorna um valor [Link] do value especificado.

[Link] Produz uma representação JSON de um determinado valor.

[Link] Retorna a representação de texto de um valor de número,


data, time, datetime, datetimezone, lógico, duração ou binário.
Se um valor for nulo, [Link] retornará nulo. O parâmetro
opcional Culture é usado para formatar o valor de texto de
acordo com a cultura fornecida.

[Link] Decodifica dados de um valor binário para um valor de texto


usando uma codificação.

[Link] Retorna um valor Guid como um valor de texto.

[Link] Codifica um valor de texto em um valor binário usando uma


codificação.

[Link] Retorna uma lista de caracteres de um valor de texto.

[Link] Decodifica um valor de uma representação textual, um valor e


o interpreta como um valor com tipo apropriado.
[Link] usa um valor de texto e retorna um número,
um valor lógico, um valor nulo, um valor DateTime, um valor
Duration ou um valor de texto. O valor de texto vazio é
interpretado como um valor nulo.

Extrair
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna um caractere que começa em um deslocamento de


base zero.

[Link] Retorna a substring até um comprimento específico.

[Link] Retorna um número de caracteres de um valor de texto


começando em um deslocamento de base zero e também
para o número de contagem de caracteres.

[Link] Retorna a contagem de caracteres do início de um valor de


texto.

F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna o número de caracteres do final de um valor de texto.

Modificado
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna um valor de texto com newValue inserido em um


valor de texto começando em um deslocamento de base zero.

[Link] Remove todas as ocorrências de um caractere ou de uma lista


de caracteres de um valor de texto. O parâmetro removeChars
pode ser um valor de caractere ou uma lista de valores de
caracteres.

[Link] Remove caracteres de contagem em um deslocamento de


base zero de um valor de texto.

[Link] Substitui todas as ocorrências de uma substring por um novo


valor de texto.

[Link] Substitui caracteres de comprimento em um valor de texto


que começa em um deslocamento de base zero com o novo
valor de texto.

[Link] Seleciona todas as ocorrências do caractere especificado ou da


lista de caracteres do valor de texto de entrada.

Associação
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna true se uma substring de valor de texto foi


encontrada em uma substring de valor de texto; caso
contrário, false.

[Link] Retorna um valor lógico que indica se uma substring de valor


de texto foi encontrada no final de uma cadeia de caracteres.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna a primeira ocorrência de substring em uma cadeia de


caracteres e retorna sua posição começando em startOffset.

[Link] Retorna a primeira ocorrência de um valor de texto na lista e


retorna sua posição começando em startOffset.

[Link] Retorna um valor lógico que indica se uma substring de valor


de texto foi encontrada no início de uma cadeia de caracteres.

Transformações
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna a parte do texto que está após o delimitador


especificado.

[Link] Retorna a parte do texto que está antes do delimitador


especificado.

[Link] Retorna a parte do texto que está entre o startDelimiter e o


endDelimiter especificados.

[Link] Retorna o valor de texto original com os caracteres não


imprimíveis removidos.

[Link] Retorna um valor de texto que é o resultado da junção de


todos os valores de texto com cada valor separado por um
separador.

[Link] Retorna um valor de texto em minúsculas.

[Link] Retorna um valor de texto preenchido no final com o pad para


que ele fique no comprimento mínimo de caracteres.

[Link] Retorna um valor de texto preenchido no início com o pad


para que ele fique no comprimento mínimo de caracteres. Se o
pad não for especificado, será usado o espaço em branco.

[Link] Retorna um valor de texto com as primeiras letras de todas as


palavras convertidas em maiúsculas.

[Link] Retorna um valor de texto composto pelo valor de texto de


entrada repetido várias vezes.

[Link] Reverte o texto fornecido.

[Link] Retorna uma lista contendo partes de um valor de texto


delimitadas por um valor de texto separador.

[Link] Retorna uma lista contendo partes de um valor de texto


delimitadas por quaisquer valores de texto separadores.
F UN Ç Ã O DESC RIÇ Ã O

[Link] Remove todas as ocorrências de caracteres em trimChars do


texto.

[Link] Remove todas as ocorrências dos caracteres especificados em


trimChars do final do valor de texto original.

[Link] Remove todas as ocorrências dos caracteres em trimChars do


início do valor de texto original.

[Link] Retorna um valor de texto em maiúsculas.

Parâmetros
VA LO RES DE PA RÂ M ET RO S DESC RIÇ Ã O

[Link] Uma lista de posições de todas as ocorrências dos valores


encontrados é retornada.

[Link] A posição da primeira ocorrência do valor encontrado é


retornada.

[Link] A posição da última ocorrência do valor encontrado é


retornada.

[Link] Indica que a indexação deve ser feita desde o final da entrada.

[Link] Indica que a indexação deve ser feita desde o início da


entrada.

[Link] Use para escolher o formato binário ASCII.

[Link] Use para escolher o formato binário UTF16 big endian.

[Link] Use para escolher o formato binário UTF16 little endian.

TextEncoding.Utf8 Use para escolher o formato binário UTF8.

TextEncoding.Utf16 Use para escolher o formato binário UTF16 little endian.

[Link] Use para escolher o formato binário do Windows.


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](number as nullable number) as nullable text

Sobre
Retorna o equivalente de caracteres do número.

Exemplo 1
Dado o número 9, localize o valor de caractere.

[Link](9)

"#(tab)"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](character as nullable text) as nullable number

Sobre
Retorna o equivalente numérico do caractere character .

Exemplo 1
Dado o caractere "#(tab)" 9, localize o valor numérico.

[Link]("#(tab)")

9
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as nullable text) as nullable text

Sobre
Retorna um valor [Link] do value especificado. Se o value fornecido for null , [Link] retornará null .
Uma verificação será executada para ver se o value fornecido está em um formato aceitável. Formatos aceitáveis
fornecidos nos exemplos.

Exemplo 1
O GUID pode ser fornecido como 32 dígitos hexadecimais contíguos.

[Link]("05FE1DADC8C24F3BA4C2D194116B4967")

"05fe1dad-c8c2-4f3b-a4c2-d194116b4967"

Exemplo 2
O GUID pode ser fornecido como 32 dígitos hexadecimais separados por hífen em blocos de 8-4-4-4-12.

[Link]("05FE1DAD-C8C2-4F3B-A4C2-D194116B4967")

"05fe1dad-c8c2-4f3b-a4c2-d194116b4967"

Exemplo 3
O GUID pode ser fornecido como 32 dígitos hexadecimais separados por hífen e delimitados por chaves.

[Link]("{05FE1DAD-C8C2-4F3B-A4C2-D194116B4967}")

"05fe1dad-c8c2-4f3b-a4c2-d194116b4967"

Exemplo 4
O GUID pode ser fornecido como 32 dígitos hexadecimais separados por hífen e delimitados por parênteses.

[Link]("(05FE1DAD-C8C2-4F3B-A4C2-D194116B4967)")

"05fe1dad-c8c2-4f3b-a4c2-d194116b4967"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional encoding as nullable number) as binary

Sobre
Produz uma representação JSON de um valor especificado value com uma codificação de texto especificada por
encoding . Se encoding for omitido, UTF8 será usado. Os valores são representados da seguinte maneira:

Valores nulos, lógicos e de texto são representados como os tipos JSON correspondentes
Os números são representados como números em JSON, exceto que #infinity , -#infinity e #nan são
convertidos em NULL
As listas são representadas como matrizes JSON
Os registros são representados como objetos JSON
As tabelas são representadas como uma matriz de objetos
Datas, horas, data e hora, fusos horários e durações são representados como texto ISO-8601
Os valores binários são representados como texto codificado em base64
Tipos e funções produzem um erro

Exemplo 1
Converter um valor complexo em JSON.

[Link]([Link]([A = {1, true, "3"}, B = #date(2012, 3, 25)]))

"{""A"":[1,true,""3""],""B"":""2012-03-25""}"
[Link]
08/05/2020 • 2 minutes to read

Sobre
Indica que a indexação deve ser feita desde o final da entrada.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Indica que a indexação deve ser feita desde o início da entrada.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, delimiter as text, optional index as any) as any

Sobre
Retorna a parte de text que está após o delimiter especificado. Um index numérico opcional indica qual
ocorrência do delimiter deve ser considerada. Uma lista opcional index indica qual ocorrência do delimiter
deve ser considerada, bem como se a indexação deve ser feita do início ou do fim da entrada.

Exemplo 1
Obtenha a porção de "111-222-333" depois do (primeiro) hífen.

[Link]("111-222-333", "-")

"222-333"

Exemplo 2
Obtenha a porção de "111-222-333" depois do segundo hífen.

[Link]("111-222-333", "-", 1)

"333"

Exemplo 3
Obtenha a porção de "111-222-333" depois do segundo hífen do fim.

[Link]("111-222-333", "-", {1, [Link]})

"222-333"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, index as number) as nullable text

Sobre
Retorna o caractere no valor de texto text na posição index . O primeiro caractere no texto está na posição 0.

Exemplo 1
Localize o caractere na posição 4 na cadeia de caracteres "Olá, Mundo".

[Link]("Hello, World", 4)

"o"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, delimiter as text, optional index as any) as any

Sobre
Retorna a parte de text antes do delimiter especificado. Um index numérico opcional indica qual ocorrência
do delimiter deve ser considerada. Uma lista opcional index indica qual ocorrência do delimiter deve ser
considerada, bem como se a indexação deve ser feita do início ou do fim da entrada.

Exemplo 1
Obtenha a porção de "111-222-333" antes do (primeiro) hífen.

[Link]("111-222-333", "-")

"111"

Exemplo 2
Obtenha a porção de "111-222-333" antes do segundo hífen.

[Link]("111-222-333", "-", 1)

"111-222"

Exemplo 3
Obtenha a porção de "111-222-333" antes do segundo hífen do fim.

[Link]("111-222-333", "-", {1, [Link]})

"111"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, startDelimiter as text, endDelimiter as text,
optional startIndex as any, optional endIndex as any) as any

Sobre
Retorna a parte de text entre o startDelimiter especificado e o endDelimiter . Um startIndex numérico
opcional indica qual ocorrência do startDelimiter deve ser considerada. Uma lista opcional startIndex indica
qual ocorrência do startDelimiter deve ser considerada, bem como se a indexação deve ser feita do início ou do
fim da entrada. O endIndex é semelhante, exceto que a indexação é feita com relação a startIndex .

Exemplo 1
Obtenha a porção de "111 (222) 333 (444)" entre o (primeiro) parêntese de abertura e o (primeiro) parêntese de
fechamento que o segue.

[Link]("111 (222) 333 (444)", "(", ")")

"222"

Exemplo 2
Obtenha a porção de "111 (222) 333 (444)" entre o segundo parêntese de abertura e o primeiro parêntese de
fechamento que o segue.

[Link]("111 (222) 333 (444)", "(", ")", 1, 0)

"444"

Exemplo 3
Obtenha a porção de "111 (222) 333 (444)" entre o segundo parêntese de abertura do final e o segundo parêntese
de fechamento que o segue.

[Link]("111 (222) 333 (444)", "(", ")", {1, [Link]}, {1,


[Link]})

"222) 333 (444"


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text) as nullable text

Sobre
Retorna um valor de texto com todos os caracteres não imprimíveis de text removidos.

Exemplo 1
Remova os feeds de linha e outros caracteres não imprimíveis de um valor de texto.

[Link]("ABC#(lf)D")

"ABCD"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](texts as list, optional separator as nullable text) as text

Sobre
Retorna o resultado da combinação da lista de valores de texto, texts , em um único valor de texto. Um separador
opcional usado no texto combinado final pode ser especificado, separator .

Exemplo 1
Combine os valores "Seattle" e "WA".

[Link]({"Seattle", "WA"})

"SeattleWA"

Exemplo 2
Combine os valores de texto "Seattle" e "WA" separados por uma vírgula e um espaço, ", ".

[Link]({"Seattle", "WA"}, ", ")

"Seattle, WA"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, substring as text, optional comparer as nullable function) as
nullable logical

Sobre
Detecta se o texto text contém o texto substring . Retornará true se o texto for encontrado.
comparer é um Comparer usado para controlar a comparação. Os comparadores podem ser usados para fornecer
comparações com detecção de localidade e cultura ou sem diferenciação de maiúsculas e minúsculas.
Os seguintes comparadores internos estão disponíveis na linguagem da fórmula:
[Link] : Usado para executar uma comparação ordinal exata
[Link] : Usado para executar uma comparação ordinal exata sem diferenciação de
maiúsculas e minúsculas
[Link] : Usado para executar uma comparação com detecção de cultura

Exemplo 1
Descubra se o texto "Olá, Mundo" contém "Olá".

[Link]("Hello World", "Hello")

true

Exemplo 2
Descubra se o texto "Olá, Mundo" contém "olá".

[Link]("Hello World", "hello")

false
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, count as number) as nullable text

Sobre
Retorna um valor text , que é composto pelos últimos count caracteres do valor text``text .

Exemplo 1
Obtenha os cinco últimos caracteres do texto "Olá, Mundo".

[Link]("Hello, World", 5)

"World"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, substring as text, optional comparer as nullable function) as
nullable logical

Sobre
Indica se o texto fornecido, text , termina com o valor especificado, substring . A indicação diferencia maiúsculas
de minúsculas.
comparer é um Comparer usado para controlar a comparação. Os comparadores podem ser usados para fornecer
comparações com detecção de localidade e cultura ou sem diferenciação de maiúsculas e minúsculas.
Os seguintes comparadores internos estão disponíveis na linguagem da fórmula:
[Link] : Usado para executar uma comparação ordinal exata
[Link] : Usado para executar uma comparação ordinal exata sem diferenciação de
maiúsculas e minúsculas
[Link] : Usado para executar uma comparação com detecção de cultura

Exemplo 1
Verifique se "Olá, Mundo" termina com "mundo".

[Link]("Hello, World", "world")

false

Exemplo 2
Verifique se "Olá, Mundo" termina com "Mundo".

[Link]("Hello, World", "World")

true
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](formatString as text, arguments as any, optional culture as nullable text) as text

Sobre
Retorna o texto formatado criado aplicando arguments de uma lista ou registro a uma cadeia de caracteres de
formato formatString . Uma culture opcional também pode ser fornecida (por exemplo, "pt-BR").

Exemplo 1
Formata uma lista de números.

[Link]("#{0}, #{1}, and #{2}.", {17, 7, 22})

"17, 7, and 22."

Exemplo 2
Formata diferentes tipos de dados de um registro de acordo com a cultura do inglês (Estados Unidos).

[Link](
"The time for the #[distance] km run held in #[city] on #[date] was #[duration].",
[
city = "Seattle",
date = #date(2015, 3, 10),
duration = #duration(0, 0, 54, 40),
distance = 10
],
"en-US"

"The time for the 10 km run held in Seattle on 3/10/2015 was 00:54:40."
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional culture as nullable text) as nullable text

Sobre
Retorna a representação de texto de value . O value pode ser um valor number , date , time , datetime ,
datetimezone , logical , duration ou binary . Se o valor fornecido for nulo, [Link] retornará nulo. Uma
culture opcional também pode ser fornecida (por exemplo, "pt-BR").

Exemplo 1
Crie um valor de texto com base no número 3.

[Link](3)

"3"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](binary as nullable binary, optional encoding as nullable number) as nullable text

Sobre
Decodifica os dados, binary , de um valor binário em valor de texto, usando o tipo encoding .
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](text as text, optional culture as nullable text) as type

Sobre
Infere o tipo de número granular ([Link], [Link] etc.) de text . Um erro será gerado se text não for um
número. Uma culture opcional também pode ser fornecida (por exemplo, "pt-BR").
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, offset as number, newText as text) as nullable text

Sobre
Retorna o resultado da inserção do valor de texto newText no valor de texto text na posição offset . As posições
começam no número 0.

Exemplo 1
Insira "C" entre "B" e "D" em "ABD".

[Link]("ABD", 2, "C")

"ABCD"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text) as nullable number

Sobre
Retorna o número de caracteres no texto text .

Exemplo 1
Localize quantos caracteres existem no texto "Olá, Mundo".

[Link]("Hello World")

11
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, optional culture as nullable text) as nullable text

Sobre
Retorna o resultado da conversão de todos os caracteres de text em minúsculas. Uma culture opcional também
pode ser fornecida (por exemplo, "pt-BR").

Exemplo 1
Obtenha a versão minúscula de "AbCd".

[Link]("AbCd")

"abcd"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, start as number, optional count as nullable number) as nullable
text

Sobre
Retorna count caracteres ou até o final de text ; no deslocamento start .

Exemplo 1
Encontre a substring no texto "Olá, Mundo" iniciando no índice 6 abrangendo 5 caracteres.

[Link]("Hello World", 6, 5)

"World"

Exemplo 2
Encontre a substring no texto "Olá, Mundo" iniciando no índice 6 até o final.

[Link]("Hello World", 6, 20)

"World"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link]() as text

Sobre
Retorna um novo identificador global exclusivo (GUID) aleatório.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, count as number, optional character as nullable text) as
nullable text

Sobre
Retorna um valor de text preenchido para comprimento count inserindo espaços no fim do valor de texto text .
Um caractere opcional character pode ser usado para especificar o caractere de preenchimento. O caractere de
preenchimento padrão é um espaço.

Exemplo 1
Preencha o final de um valor de texto para que tenha 10 caracteres.

[Link]("Name", 10)

"Name "

Exemplo 2
Preencha o final de um valor de texto com "|" para que tenha 10 caracteres.

[Link]("Name", 10, "|")

"Name||||||"
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, count as number, optional character as nullable text) as
nullable text

Sobre
Retorna um valor de text preenchido para comprimento count inserindo espaços no início do valor de texto
text . Um caractere opcional character pode ser usado para especificar o caractere de preenchimento. O
caractere de preenchimento padrão é um espaço.

Exemplo 1
Preencha o início de um valor de texto para que tenha 10 caracteres.

[Link]("Name", 10)

" Name"

Exemplo 2
Preencha o início de um valor de texto com "|" para que tenha 10 caracteres.

[Link]("Name", 10, "|")

"||||||Name"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as text, substring as text, optional occurrence as nullable number, optional
comparer as nullable function) as any

Sobre
Retorna a posição da ocorrência especificada do valor de texto substring encontrado em text . Um parâmetro
opcional occurrence pode ser usado para especificar qual posição de ocorrência deve ser retornada (primeira
ocorrência por padrão). Retorna -1 se substring não foi encontrado.
comparer é um Comparer usado para controlar a comparação. Os comparadores podem ser usados para fornecer
comparações com detecção de localidade e cultura ou sem diferenciação de maiúsculas e minúsculas.
Os seguintes comparadores internos estão disponíveis na linguagem da fórmula:
[Link] : Usado para executar uma comparação ordinal exata
[Link] : Usado para executar uma comparação ordinal exata sem diferenciação de
maiúsculas e minúsculas
[Link] : Usado para executar uma comparação com detecção de cultura

Exemplo 1
Obtenha a posição da primeira ocorrência de "Mundo" no texto "Olá, Mundo! Olá, Mundo!".

[Link]("Hello, World! Hello, World!", "World")

Exemplo 2
Obtenha a posição da última ocorrência de "Mundo" no texto "Olá, Mundo! Olá, Mundo!".

[Link]("Hello, World! Hello, World!", "World", [Link])

21
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as text, characters as list, optional occurrence as nullable number) as
any

Sobre
Retorna a posição da primeira ocorrência de qualquer um dos caracteres na lista de caracteres text encontrada
no valor de texto characters . Um parâmetro opcional occurrence pode ser usado para especificar qual posição de
ocorrência deve ser retornada.

Exemplo 1
Localize a posição do "M" no texto "Olá, Mundo!".

[Link]("Hello, World!", {"W"})

Exemplo 2
Localize a posição do "M" ou do "O" no texto "Olá, Mundo!".

[Link]("Hello, World!", {"H", "W"})

0
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, optional culture as nullable text) as nullable text

Sobre
Retorna o resultado do uso de maiúsculas somente da primeira letra de cada palavra no valor de texto text . Todas
as outras letras são retornadas em minúsculas. Uma culture opcional também pode ser fornecida (por exemplo,
"pt-BR").

Exemplo 1
Use [Link] em uma frase simples.

[Link]("the QUICK BrOWn fOx jUmPs oVER tHe LAzy DoG")

"The Quick Brown Fox Jumps Over The Lazy Dog"


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, offset as number, optional count as nullable number) as nullable
text

Sobre
Retorna a substring do texto text encontrado no deslocamento offset . Um parâmetro opcional, count , pode
ser incluído para especificar quantos caracteres serão retornados. Gerará um erro se não houver caracteres
suficientes.

Exemplo 1
Localize a substring no texto "Olá, Mundo", começando no índice. 6.

[Link]("Hello World", 6)

"World"

Exemplo 2
Localize a substring no texto "Olá, Mundo, Olá", começando no índice 6 e abrangendo 5 caracteres.

[Link]("Hello World Hello", 6, 5)

"World"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, removeChars as any) as nullable text

Sobre
Retorna uma cópia do valor de texto text com todos os caracteres de removeChars removidos.

Exemplo 1
Remova os caracteres , e ; do valor de texto.

[Link]("a,b;c", {",",";"})

"abc"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, offset as number, optional count as nullable number) as
nullable text

Sobre
Retorna uma cópia do valor de texto text com todos os caracteres da posição offset removidos. Um parâmetro
opcional, count , pode ser usado para especificar o número de caracteres a serem removidos. O valor padrão de
count é 1. Os valores de posição começam em 0.

Exemplo 1
Remova um caractere do valor de texto "ABEFC" na posição 2.

[Link]("ABEFC", 2)

"ABFC"

Exemplo 2
Remova dois caracteres do valor de texto "ABEFC" começando na posição 2.

[Link]("ABEFC", 2, 2)

"ABC"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, count as number) as nullable text

Sobre
Retorna um valor de texto composto pelo texto de entrada text repetido count vezes.

Exemplo 1
Repita o texto "a" cinco vezes.

[Link]("a", 5)

"aaaaa"

Exemplo 2
Repita o texto "olámundo" três vezes.

[Link]("helloworld.", 3)

"[Link]."
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, old as text, new as text) as nullable text

Sobre
Retorna o resultado da substituição de todas as ocorrências do valor de texto old no valor de texto text pelo
valor de texto new . Essa função diferencia maiúsculas de minúsculas.

Exemplo 1
Substitua cada ocorrência de "the" em uma frase por "a".

[Link]("the quick brown fox jumps over the lazy dog", "the", "a")

"a quick brown fox jumps over a lazy dog"


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, offset as number, count as number, newText as text) as
nullable text

Sobre
Retorna o resultado da remoção de um número de caracteres, count , do valor de texto text começando na
posição offset e inserindo o valor de texto newText na mesma posição em text .

Exemplo 1
Substitua um único caractere na posição 2 do valor de texto "ABGF" pelo novo valor de texto "CDE".

[Link]("ABGF", 2, 1, "CDE")

"ABCDEF"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text) as nullable text

Sobre
Inverte o text fornecido.

Exemplo 1
Inverta o texto "123".

[Link]("123")

"321"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, selectChars as any) as nullable text

Sobre
Retorna uma cópia do valor de texto text com todos os caracteres que não estão na selectChars removida.

Exemplo 1
Selecione todos os caracteres no intervalo de 'a' a 'z' no valor de texto.

[Link]("a,b;c", {"a".."z"})

"abc"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as text, separator as text) as list

Sobre
Retorna uma lista de valores de texto resultantes da divisão de um valor de texto text com base no delimitador
especificado, separator .

Exemplo 1
Crie uma lista com base no valor de texto delimitado por "|", "Name|Address|PhoneNumber".

[Link]("Name|Address|PhoneNumber", "|")

Nome

Endereço

PhoneNumber
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as text, separators as text) as list

Sobre
Retorna uma lista de valores de texto resultantes da divisão de um valor de texto text com base em qualquer
caractere no delimitador especificado, separators .

Exemplo 1
Crie uma lista com base no valor de texto "Jamie|Campbell|Admin|Adventure Works| [Link]".

[Link]("Jamie|Campbell|Admin|Adventure Works|[Link]", "|")

Jamie

Campbell

Administrador

Adventure Works

[Link]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, count as number) as nullable text

Sobre
Retorna os count primeiros caracteres de text como um valor de texto.

Exemplo 1
Obtenha os cinco primeiros caracteres de "Olá, Mundo".

[Link]("Hello, World", 5)

"Hello"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, substring as text, optional comparer as nullable function)
as nullable logical

Sobre
Retornará true se o valor de texto text começar com o valor de texto substring .
text: Um valor text que deve ser pesquisado
substring : Um valor de text que é a substring a ser pesquisada em substring
comparer : [opcional] Um Comparer usado para controlar a comparação. Por exemplo,
[Link] pode ser usado para executar pesquisas que não diferenciam maiúsculas de
minúsculas
comparer é um Comparer usado para controlar a comparação. Os comparadores podem ser usados para fornecer
comparações com detecção de localidade e cultura ou sem diferenciação de maiúsculas e minúsculas.
Os seguintes comparadores internos estão disponíveis na linguagem da fórmula:
[Link] : Usado para executar uma comparação ordinal exata
[Link] : Usado para executar uma comparação ordinal exata sem diferenciação de
maiúsculas e minúsculas
[Link] : Usado para executar uma comparação com detecção de cultura

Exemplo 1
Verifique se o texto "Olá, Mundo" começa com o texto "olá".

[Link]("Hello, World", "hello")

false

Exemplo 2
Verifique se o texto "Olá, Mundo" começa com o texto "Olá".

[Link]("Hello, World", "Hello")

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, optional encoding as nullable number, optional
includeByteOrderMark as nullable logical) as nullable binary

Sobre
Codifica o valor de texto especificado, text , em um valor binário usando o encoding especificado.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as text) as list

Sobre
Retorna uma lista de valores de caractere do valor de texto text especificado.

Exemplo 1
Crie uma lista de valores de caractere do texto "Olá, Mundo".

[Link]("Hello World")

d
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, optional trim as any) as nullable text

Sobre
Retorna o resultado da remoção de todos os espaços em branco à esquerda e à direita do valor de texto text .

Exemplo 1
Remova o espaço em branco à esquerda e à direita de "a b c d".

[Link](" a b c d ")

"a b c d"
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, optional trim as any) as nullable text

Sobre
Retorna o resultado da remoção de todos os espaços em branco à direita do valor de texto text .

Exemplo 1
Remova o espaço em branco à direita de "a b c d".

[Link](" a b c d ")

" a b c d"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, optional trim as any) as nullable text

Sobre
Retorna o resultado da remoção de todos os espaços em branco à esquerda do valor de texto text .

Exemplo 1
Remova o espaço em branco à esquerda de "a b c d".

[Link](" a b c d ")

"a b c d "
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, optional culture as nullable text) as nullable text

Sobre
Retorna o resultado da conversão de todos os caracteres de text em maiúsculas. Uma culture opcional também
pode ser fornecida (por exemplo, "pt-BR").

Exemplo 1
Obtenha a versão em letras maiúsculas de "\aBcD".

[Link]("aBcD")

"ABCD"
[Link]
09/05/2020 • 2 minutes to read

Sobre
Use para escolher o formato binário ASCII.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Use para escolher o formato binário UTF16 big endian.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Use para escolher o formato binário UTF16 little endian.
TextEncoding.Utf8
09/05/2020 • 2 minutes to read

Sobre
Use para escolher o formato binário UTF8.
TextEncoding.Utf16
09/05/2020 • 2 minutes to read

Sobre
Use para escolher o formato binário UTF16 little endian.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Use para escolher o formato binário do Windows.
Funções de hora
08/05/2020 • 2 minutes to read

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

Time
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna um valor de DateTime do fim da hora.

[Link] Retorna um valor temporal de um valor.

[Link] Retorna um valor temporal de um conjunto de formatos de


data.

[Link] Retorna o valor de hora de um valor de DateTime.

[Link] Retorna o valor de minuto de um valor de DateTime.

[Link] Retorna o valor de segundo de um valor de DateTime

[Link] Retorna o primeiro valor da hora de um valor temporal.

[Link] Retorna um registro que contém partes de valor de Date.

[Link] Retorna um valor de texto de um valor temporal.

#time Cria um valor temporal usando hora, minuto e segundo.


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as any

Sobre
Retorna um valor time , datetime ou datetimezone que representa o fim da hora em dateTime , incluindo
segundos fracionários. As informações de fuso horário são preservadas.
dateTime : Um valor time , datetime ou datetimezone do qual o fim da fora é calculado.

Exemplo 1
Obtenha o fim da hora de 14/5/2011 05:00: 00 PM.

[Link](#datetime(2011, 5, 14, 17, 0, 0))

#datetime(2011, 5, 14, 17, 59, 59.9999999)

Exemplo 2
Obtenha o fim da hora de 17/5/2011 05:00: 00 PM -7:00.

[Link](#datetimezone(2011, 5, 17, 5, 0, 0, -7, 0))

#datetimezone(2011, 5, 17, 5, 59, 59.9999999, -7, 0)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional culture as nullable text) as nullable time

Sobre
Retorna um valor time do value especificado. Uma culture opcional também pode ser fornecida (por exemplo,
"pt-BR"). Se o value fornecido for null , [Link] retornará null . Se o value fornecido for time , value será
retornado. Os valores dos seguintes tipos podem ser convertidos em um valor time :
text : Um valor time da representação textual. Confira [Link] para obter detalhes.
datetime : O componente de hora do value .
datetimezone : O componente de hora do equivalente de datetime local de value .
number : Um time equivalente ao número de dias fracionários expressos por value . Se value for negativo ou
maior ou igual a 1, um erro será retornado.
Se value for de qualquer outro tipo, um erro será retornado.

Exemplo 1
Converter 0.7575 em um valor time .

[Link](0.7575)

#time(18, 10, 48)

Exemplo 2
Converter #datetime(1899, 12, 30, 06, 45, 12) em um valor time .

[Link](#datetime(1899, 12, 30, 06, 45, 12))

#time(06, 45, 12)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as nullable text, optional culture as nullable text) as nullable time

Sobre
Cria um valor de time com base em uma representação textual, text , seguindo o padrão de formato ISO 8601.
Uma culture opcional também pode ser fornecida (por exemplo, "pt-BR").
[Link]("12:34:12") // Hora, hh:mm:ss
[Link]("12:34:12.1254425") // hh:mm:[Link]

Exemplo 1
Converta "10:12:31am" em um valor temporal.

[Link]("10:12:31am")

#time(10, 12, 31)

Exemplo 2
Converta "1012" em um valor temporal.

[Link]("1012")

#time(10, 12, 00)

Exemplo 3
Converta "10" em um valor temporal.

[Link]("10")

#time(10, 00, 00)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable number

Sobre
Retorna o componente de hora do valor de time , datetime ou datetimezone fornecido, dateTime .

Exemplo 1
Localize a hora em #datetime (2011, 12, 31, 9, 15, 36).

[Link](#datetime(2011, 12, 31, 9, 15, 36))

9
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable number

Sobre
Retorna o componente de minuto do valor time , datetime ou datetimezone fornecido, dateTime .

Exemplo 1
Localize o minuto em #datetime (2011, 12, 31, 9, 15, 36).

[Link](#datetime(2011, 12, 31, 9, 15, 36))

15
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as nullable number`

Sobre
Retorna o componente de segundo do valor de time , datetime ou datetimezone fornecido, dateTime .

Exemplo 1
Localize o segundo valor por meio de um valor de datetime.

[Link](#datetime(2011, 12, 31, 9, 15, 36.5))

36.5
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](dateTime as any) as any

Sobre
Retorna o primeiro valor da hora dado um tipo time , datetime ou datetimezone .

Exemplo 1
Localizar o início da hora de 10 de outubro de 2011, 8h10min32 ( #datetime(2011, 10, 10, 8, 10, 32) ).

[Link](#datetime(2011, 10, 10, 8, 10, 32))

#datetime(2011, 10, 10, 8, 0, 0)


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](time as time) as record

Sobre
Retorna um registro que contém as partes do valor temporal especificado, time .
time : Um valor time com base no qual o registro das partes deve ser calculado.

Exemplo 1
Converta o valor de #time(11, 56, 2) em um registro contendo valores de Hora.

[Link](#time(11, 56, 2))

H O RA 11

M IN UT E 56

SEC O N D 2
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](time as nullable time, optional format as nullable text, optional culture as nullable
text) as nullable text

Sobre
Retorna uma representação textual de time , o valor temporal, time . Essa função usa um parâmetro de formato
opcional format . Para ver uma lista completa dos formatos compatíveis, confira o documento de especificação da
biblioteca. Uma culture opcional também pode ser fornecida (por exemplo, "pt-BR").

Exemplo 1
Obtenha uma representação textual #time(11, 56, 2).

[Link](#time(11, 56, 2))

"11:56 AM"

Exemplo 2
Obtenha uma representação textual de #time(11, 56, 2) com opção de formato.

[Link](#time(11, 56, 2), "hh:mm")

"11:56"
#time
09/05/2020 • 2 minutes to read

Sintaxe
#time(hour as number, minute as number, second as number) as time

Sobre
Cria um valor temporal usando números inteiros de hora hour , minuto minute e segundo (fracionário) second .
Gera um erro se isto não é verdadeiro:
0 ≤ hora ≤ 24
0 ≤ minuto ≤ 59
0 ≤ segundo ≤ 59
se a hora for 24, o minuto e o segundo deverão ser 0
Funções de tipo
08/05/2020 • 2 minutes to read

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

Tipo
F UN Ç Ã O DESC RIÇ Ã O

[Link] Adicione uma chave a um tipo de tabela.

[Link] O tipo fornecido deve ser um tipo de registro que retorna


uma versão fechada do tipo de registro determinado (ou do
mesmo tipo, se já está fechado)

[Link] Retorna as facetas de um tipo.

[Link] Cria um tipo de função com base no valor especificado de .

[Link] Retorna um tipo de Registro de um registro de campos.

[Link] Retorna um registro com valores de campo definidos para o


nome dos parâmetros de um tipo de função e seus valores
definidos para seus tipos correspondentes.

[Link] Retorna um número que indica o número mínimo de


parâmetros necessários para invocar um tipo de função.

[Link] Retorna um tipo retornado por um tipo de função.

[Link] [Link]

[Link] Retorna true se um tipo é um tipo que permite valor nulo;


caso contrário, false.

[Link] Retorna se um tipo de registro for aberto.

[Link] Retorna um tipo de item de um tipo de lista.

[Link] Retorna o tipo que não permite valor nulo de um tipo.

[Link] Retorna uma versão aberta de um tipo de registro (ou do


mesmo tipo, se já está aberto).

[Link] Retorna um registro descrevendo os campos de um tipo de


registro com cada campo do tipo de registro retornado tendo
um nome correspondente e um valor que é o registro do
formulário [ Tipo = tipo, Opcional = lógico].

[Link] Substitui as facetas de um tipo.


F UN Ç Ã O DESC RIÇ Ã O

[Link] Substitui as chaves em um tipo de tabela.

[Link] Retorna o tipo de uma coluna em uma tabela.

[Link] Retorna chaves de um tipo de tabela.

[Link] Retorna um tipo de linha de um tipo de tabela.

[Link] Retorna uma tabela que contém uma descrição das colunas
([Link]., o esquema) do tipo de tabela especificado.

[Link] Retorna a união de uma lista de tipos.


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as type, columns as list, isPrimary as logical) as type

Sobre
Adiciona uma chave ao tipo de tabela especificado.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](type as type) as type

Sobre
Retorna uma versão fechada do record type fornecido (ou do mesmo tipo, se já está fechado).

Exemplo 1
Crie uma versão fechada de type [ A = number,…] .

[Link](type [A = number, ...])

type [A = number]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](type as type) as record

Sobre
Retorna um registro contendo as facetas de type
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](signature as record, min as number) as type

Sobre
Cria um function type de signature , um registro de ReturnType e Parameters e min , o número mínimo de
argumentos necessários para invocar a função.

Exemplo 1
Cria o tipo para uma função que aceita um parâmetro de número denominado X e retorna um número.

[Link]([ReturnType = type number, Parameters = [X = type number]], 1)

type function (X as number) as number


[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](fields as record, open as logical) as type

Sobre
Retorna um tipo que representa registros com restrições de tipo específicas em campos.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](type as type) as record

Sobre
Retorna um registro com valores de campo definidos para o nome dos parâmetros de type , e seus valores
definidos para seus tipos correspondentes.

Exemplo
Localize os tipos dos parâmetros para a função (x as number, y as text) .

[Link](type function (x as number, y as text) as any)

X [Type]

A [Type]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](type as type) as number

Sobre
Retorna um número que indica o número mínimo de parâmetros necessários para invocar a entrada type da
função.

Exemplo 1
Localize o número de parâmetros necessários para a função (x as number, optional y as text) .

[Link](type function (x as number, optional y as text) as any)

1
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](type as type) as type

Sobre
Retorna um tipo retornado por uma função type .

Exemplo 1
Localize o tipo de retorno de () as any) .

[Link](type function () as any)

type any
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](type1 as type, type2 as type) as logical

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](type as type) as logical

Sobre
Retorna true se um tipo é nullable ; caso contrário, false .

Exemplo 1
Determine se number é anulável.

[Link](type number)

false

Exemplo 2
Determine se type nullable number é anulável.

[Link](type nullable number)

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](type as type) as logical

Sobre
Retorna um logical indicando se um registro type está aberto.

Exemplo 1
Determine se o registro type [ A = number, ...] está aberto.

[Link](type [A = number, ...])

true
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](type as type) as type

Sobre
Retorna um tipo de item de uma lista type .

Exemplo 1
Encontre o tipo de item na lista {number} .

[Link](type {number})

type number
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](type as type) as type

Sobre
Retorna o tipo não nullable do type .

Exemplo 1
Retornar o tipo que não permite valor nulo de type nullable number .

[Link](type nullable number)

type number
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](type as type) as type

Sobre
Retorna uma versão aberta do record type fornecido (ou do mesmo tipo, se já está aberto).

Exemplo 1
Crie uma versão aberta de type [ A = number] .

[Link](type [A = number])

type [A = number, ...]


[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](type as type) as record

Sobre
Retorna um registro que descreve os campos de um registro type . Cada campo do tipo de registro retornado tem
um nome e um valor correspondentes na forma de um registro [ Type = type, Optional = logical ] .

Exemplo
Localize o nome e o valor do registro [ A = number, optional B = any] .

[Link](type [A = number, optional B = any])

A [Registro]

B [Registro]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](type as type, facets as record) as type

Sobre
Substitui as facetas de type pelas facetas contidas no registro facets .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](tableType as type, keys as list) as type

Sobre
Retorna um novo tipo de tabela com todas as chaves substituídas pela lista de chaves especificada.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](tableType as type, column as text) as type

Sobre
Retorna o tipo da coluna column no tipo de tabela tableType .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](tableType as type) as list

Sobre
Retorna a lista de chaves possivelmente vazias do tipo de tabela especificado.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](table as type) as type

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](tableType as type) as table

Sobre
Retorna uma tabela que descreve as colunas de tableType .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](types as list) as type

Sobre
Retorna a união dos tipos em types .
Funções de URI
08/05/2020 • 2 minutes to read

Essas funções criam e manipulam cadeias de caracteres de consulta de URI.

Uri
F UN Ç Ã O DESC RIÇ Ã O

[Link] Monte um registro em uma cadeia de caracteres de consulta


da URI.

[Link] Retorna um URI com base na combinação das partes base e


relativa.

[Link] Codifica caracteres especiais de acordo com o RFC 3986.

[Link] Retorna um valor de registro com os campos definidos como


as partes de um valor de texto do URI.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](query as record) as text

Sobre
Monte o registro query em uma cadeia de caracteres de consulta da URI, efetuando o escape dos caracteres
conforme necessário.

Exemplo
Codifique uma cadeia de caracteres de consulta que contém alguns caracteres especiais.

[Link]([a = "1", b = "+$"])

"a=1&b=%2B%24"
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](baseUri as text, relativeUri as text) as text

Sobre
Retorna um URI absoluto que é a combinação da entrada baseUri e relativeUri .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](data as text) as text

Sobre
Codifica caracteres especiais na entrada data de acordo com as regras do RFC 3986.

Exemplo
Codifique os caracteres especiais em "+money$".

[Link]("+money$")

"%2Bmoney%24"
[Link]
08/05/2020 • 2 minutes to read

Sintaxe
[Link](absoluteUri as text) as record

Sobre
Retorna as partes do absoluteUri de entrada como um registro, contendo valores como Scheme, Host, Port, Path,
Query, Fragment, UserName e Password.

Exemplo 1
Localize as partes do URI absoluto "[Link]".

[Link]("[Link]")

SC H EM E http

H O ST [Link]

P O RTA 80

C A M IN H O /

C O N SULTA R [Registro]

F RA GM EN T

USERN A M E

SEN H A

Exemplo 2
Decodifique uma cadeia de caracteres codificada por percentual.

let
UriUnescapeDataString = (data as text) as text => [Link]("[Link] & data)[Query][a]
in
UriUnescapeDataString("%2Bmoney%24")

"+money$"
Funções de valor
08/05/2020 • 4 minutes to read

Essas funções avaliam e executam operações em valores.

Valores
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna 1, 0 ou -1 com base em value1 ser maior que, igual a


ou menor que value2. Uma função de comparador opcional
pode ser fornecida.

[Link] Especifica se os dois valores são iguais.

[Link] Avalia uma consulta em relação a um destino.

[Link] Retorna um valor lógico ou nulo com base em dois valores.

[Link] Retorna o tipo do valor especificado.

Operações aritméticas
F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna a soma dos dois valores.

[Link] Retorna o resultado da divisão do primeiro valor pelo


segundo.

[Link] Retorna o produto dos dois valores.

[Link] Retorna a diferença dos dois valores.

Parâmetros aritméticos
F UN Ç Ã O DESC RIÇ Ã O

[Link] Um parâmetro opcional para que os operadores aritméticos


internos especifiquem a precisão dupla.

[Link] Um parâmetro opcional para que os operadores aritméticos


internos especifiquem a precisão decimal.

Tipos de parâmetro
T IP O DESC RIÇ Ã O
T IP O DESC RIÇ Ã O

[Link] [Link] é a função correspondente ao operador as na


linguagem de fórmula. O valor da expressão como tipo declara
que o valor de um argumento de valor é compatível com o
tipo, de acordo com o operador is. Se não for compatível, um
erro será gerado.

[Link] [Link] é a função correspondente ao operador is na


linguagem de fórmula. O valor da expressão é tipo e retornará
true se o tipo de valor atribuído for compatível com o tipo e
retornará false se o tipo de valor atribuído for incompatível
com o tipo.

[Link] Um tipo pode ser atribuído a um valor usando


[Link]. [Link] retorna um novo valor
com o tipo atribuído ou gera um erro se o novo tipo for
incompatível com o tipo primitivo nativo do valor. Em
particular, a função gera um erro quando é feita uma tentativa
de atribuir um tipo abstrato, como any. Ao substituir o tipo de
um registro, o novo tipo deve ter o mesmo número de
campos e os novos campos substituem os campos antigos
pela posição ordinal, não pelo nome. Da mesma forma, ao
substituir o tipo de uma tabela, o novo tipo deve ter o mesmo
número de colunas e as novas colunas substituem as colunas
antigas pela posição ordinal.

IM P L EM EN TA Ç Ã O DESC RIÇ Ã O

[Link] [Link]

[Link] Acessa um valor por nome em um mashup inserido.

[Link] [Link]

[Link] [Link]

[Link] [Link]

[Link] [Link]

Metadados

F UN Ç Ã O DESC RIÇ Ã O

[Link] Retorna um registro contendo os metadados da entrada.

[Link] Remove os metadados do valor e retorna o valor original.

[Link] Substitui os metadados em um valor pelo novo registro de


metadados fornecido e retorna o valor original com os novos
metadados anexados.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any) as table

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, path as text) as any

Sobre
Acessa um valor por nome em um mashup inserido.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um parâmetro opcional para que os operadores aritméticos internos especifiquem a precisão decimal.
[Link]
09/05/2020 • 2 minutes to read

Sobre
Um parâmetro opcional para que os operadores aritméticos internos especifiquem a precisão dupla.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](schema as any) as any

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](sql as text, environment as record) as text

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value1 as any, value2 as any, optional precision as nullable number) as any

Sobre
Retorna a soma de value1 e value2 . Um parâmetro precision opcional pode ser especificado. Por padrão,
[Link] é usado.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, type as type) as any

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value1 as any, value2 as any, optional precision as nullable number) as number

Sobre
Retorna -1, 0 ou 1, dependendo da condição do primeiro valor: se ele é menor que, igual a ou maior que o
segundo.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value1 as any, value2 as any, optional precision as nullable number) as any

Sobre
Retorna o Resultado da divisão de value1 por value2 . Um parâmetro precision opcional pode ser especificado.
Por padrão, [Link] é usado.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value1 as any, value2 as any, optional precision as nullable number) as logical

Sobre
Retornará true se o valor value1 for igual ao valor value2 ; do contrário, false será retornado.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](key as text) as any

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](text as any, optional culture as nullable text) as any

Sobre
Decodifica um valor de uma representação textual, de um text e o interpreta como um valor com tipo
apropriado. [Link] usa um valor de texto e retorna um número, um valor lógico, um valor nulo, um valor
de data/hora, um valor de duração ou um valor de texto. O valor de texto vazio é interpretado como um valor nulo.
Uma culture opcional também pode ser fornecida (por exemplo, "pt-BR").
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, type as type) as logical

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any) as any

Sobre
Retorna um registro contendo os metadados da entrada.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value1 as any, value2 as any, optional precision as nullable number) as any

Sobre
Retorna o produto da multiplicação de value1 por value2 . Um parâmetro precision opcional pode ser
especificado. Por padrão, [Link] é usado.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](target as any, query as text, optional parameters as any, optional options as
nullable record) as any

Sobre
Avalia query em relação a target usando os parâmetros especificados em parameters e as opções especificadas
em options .
A saída da consulta é definida por target .
target fornece o contexto para a operação descrita por query .
query descreve a consulta a ser executada em target . query é expresso de maneira específica para target (por
exemplo, uma instrução T-SQL).
O valor opcional de parameters pode conter uma lista ou um registro, conforme apropriado, para fornecer os
valores de parâmetro esperados por query .
O registro de options opcional pode conter opções que afetam o comportamento de avaliação de query em
relação a target . Essas opções são específicas de target .
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value1 as any, value2 as any, optional precision as nullable number) as
nullable logical

Sobre
Retornará nulo se um argumento value1 , value2 for nulo, caso contrário, equivalente a [Link].
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, optional metaValue as any) as any

Sobre
Remove a entrada dos metadados.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, metaValue as any) as any

Sobre
Substitui as informações de metadados da entrada.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any, type as type) as any

Sobre
[Link]
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value1 as any, value2 as any, optional precision as nullable number) as any

Sobre
Retorna a diferença de value1 e value2 . Um parâmetro precision opcional pode ser especificado. Por padrão,
[Link] é usado.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](value as any) as type

Sobre
Retorna o tipo do valor especificado.
[Link]
09/05/2020 • 2 minutes to read

Sintaxe
[Link](identifier as text) as any

Sobre
[Link]

Você também pode gostar