Funções M

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 : um lógico (true/false) que define se as propriedades de navegação devem ser geradas nos valores retornados (o padrão é falso). NavigationPropertyNameGenerator : uma função usada para a criação de nomes para propriedades de navegação. O parâmetro de registro é especificado como [option1 = value1, option2 = value2...], por exemplo. Last updated on 22/11/2025

Usando o especificado identityProvider , converte a condition lista de identidades para as quais condition retornaria true em todos os contextos identityProvider de autorização 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 grupo para tomar uma decisão. Observe que a lista de identidades representa as identidades à medida que aparecem condition e nenhuma normalização (como expansão de grupo) é executada nelas. Last updated on 22/11/2025

Essa função destina-se apenas ao uso interno. Last updated on 22/11/2025

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. Last updated on 16/09/2025

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 : um lógico (true/false) que define se as tabelas agrupadas por seus nomes de esquema (o padrão é falso). 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 tentativas de repetição. O valor padrão é 1 segundo. Implementation : especifica a versão da API do Adobe Analytics. Os valores válidos são: "2.0". O padrão usa a API versão 1.4. Last updated on 22/11/2025

Retorna a coleção de esquemas para a fonte de dados ADO.NET com o nome providerName do provedor e a cadeia de connectionString conexão. connectionString pode ser texto ou um registro de pares de valor de propriedade. Os valores da 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 por quanto tempo a consulta do lado do servidor tem permissão para ser executada antes de ser cancelada. O valor padrão é dez minutos. SqlCompatibleWindowsAuth : uma lógica (true/false) que determina se as opções de cadeia de conexão compatíveis com o SQL Server devem ser produzidas para autenticação do Windows. O valor padrão é true. TypeMap Last updated on 22/11/2025

Retorna o resultado da execução query com a cadeia de conexão connectionString usando o provedor providerName de ADO.NET. connectionString pode ser texto ou um registro de pares de valor de propriedade. Os valores da 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 por quanto tempo a consulta do lado do servidor tem permissão para ser executada antes de ser cancelada. O valor padrão é dez minutos. SqlCompatibleWindowsAuth : uma lógica (true/false) que determina se as opções de cadeia de conexão compatíveis com o SQL Server devem ser produzidas para autenticação do Windows. O valor padrão é true. Last updated on 22/11/2025

Retorna uma tabela de cubos multidimensionais ou modelos tabulares do banco de dados database do Analysis Services 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 que indica se os tipos especificados no modelo multidimensional ou tabular serão usados para os tipos de 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 que especifica a cultura dos dados. Isso corresponde à propriedade de cadeia de conexão 'Identificador de Localidade'. CommandTimeout : uma duração que controla por quanto tempo a consulta do lado do servidor tem permissão para ser executada antes de ser cancelada. O valor padrão depende do driver. ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de fazer uma conexão com o servidor. O valor padrão depende 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 subeleções ou subcubos. (O valor padrão é 2). Implementation Conteúdo relacionado Como a cultura afeta a formatação de texto Last updated on 22/11/2025

Retorna 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 que indica se os tipos especificados no modelo multidimensional ou tabular serão usados para os tipos de 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 que especifica a cultura dos dados. Isso corresponde à propriedade de cadeia de conexão 'Identificador de Localidade'. CommandTimeout : uma duração que controla por quanto tempo a consulta do lado do servidor tem permissão para ser executada antes de ser cancelada. O valor padrão depende do driver. ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de fazer uma conexão com o servidor. O valor padrão depende 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 subeleções ou subcubos. (O valor padrão é 2). Implementation Conteúdo relacionado Como a cultura afeta a formatação de texto Last updated on 22/11/2025

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 a serem lidos 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. Last updated on 22/11/2025

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 a serem lidos 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. Last updated on 22/11/2025

Retorna uma tabela de navegação que contém os documentos encontrados no contêiner especificado e 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 a serem lidos 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 a uma árvore ou em uma lista simples. O valor padrão é false. Last updated on 22/11/2025

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 a serem lidos 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. Last updated on 22/11/2025

Retorna uma tabela de navegação que contém uma linha para cada tabela encontrada na URL da conta, account de um cofre de armazenamento do Azure. Cada linha contém um link para a tabela do Azure. Um parâmetro de registro opcional, options pode ser fornecido para especificar propriedades adicionais. O registro pode conter os seguintes campos: Timeout : uma duração que controla quanto tempo aguardar antes de abandonar a solicitação para o servidor. O valor padrão é específico da origem. Last updated on 22/11/2025

Retorna o comprimento aproximado de binary , ou um erro, se a fonte de dados não der suporte a um comprimento aproximado.

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á um comprimento determinístico e uma ordem de bytes.

Combina uma lista de binários em um único binário.

Compacta um valor binário usando o tipo de compactação fornecido. O resultado dessa chamada é uma cópia compactada da entrada. Os tipos de compactação incluem: Compression.GZip Compression.Deflate

Descompacta um valor binário usando o tipo de compactação fornecido. O resultado dessa chamada é uma cópia descompactada da entrada. Os tipos de compactação incluem: Compression.GZip Compression.Deflate Exemplo Descompacte o valor binário. Usage Power Query M Binary.Decompress(#binary({115, 103, 200, 7, 194, 20, 134, 36, 134, 74, 134, 84, 6, 0}), Compression.Deflate) Saída #binary({71, 0, 111, 0, 111, 0, 100, 0, 98, 0, 121, 0, 101, 0}) Last updated on 25/03/2026

Retorna um binary valor do determinado value . Se o dado value for null , Binary.From retornará null . Se o dado value for binary , value será retornado. Os valores dos seguintes tipos podem ser convertidos em um binary valor: text : um binary valor da representação de texto. Consulte Binary.FromText para obter detalhes. Se value for de qualquer outro tipo, um erro será retornado. Exemplo Obter o binary valor de "1011" . Usage Power Query M Binary.From("1011") Saída Binary.FromText("1011", BinaryEncoding.Base64) Last updated on 25/03/2026

Converte uma lista de números em um valor binário. Last updated on 16/09/2025

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

Retorna um registro com o campo Content.Type que contém o tipo MIME inferido. Se o tipo de conteúdo inferido for texto/*, e uma página de código de codificação for detectada, retornará também o campo Content.Encoding que contém a codificação do fluxo. Se o tipo de conteúdo inferido for text/csv e o formato for delimitado, retornará também o campo Csv.PotentialDelimiter que contém uma tabela para análise de delimitadores potenciais. Se o tipo de conteúdo inferido for text/csv e o formato for de largura fixa, retornará também o campo Csv.PotentialPositions contendo uma lista para análise de possíveis posições de coluna de largura fixa. Last updated on 22/11/2025

Retorna o número de caracteres. Last updated on 16/09/2025

Retorna um subconjunto do valor binário começando no deslocamento binary . Um parâmetro opcional define offset o comprimento máximo do subconjunto.

Dividido em binary uma lista de binários em que o primeiro elemento da lista de saída é um binário que contém os primeiros pageSize bytes do binário de origem, o próximo elemento da lista de saída é um binário que contém os próximos pageSize bytes do binário de origem e assim por diante. Last updated on 22/11/2025

Converte um valor binário em uma lista de números. Last updated on 22/11/2025

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 a codificação a ser usada no valor de texto produzido Os valores a seguir BinaryEncoding podem ser usados para encoding . BinaryEncoding.Base64 : codificação base 64 BinaryEncoding.Hex : codificação hexadecedora Last updated on 22/11/2025

Retorna uma exibição de binary onde as funções especificadas handlers são usadas em vez do comportamento padrão de uma operação quando a operação é aplicada ao modo de exibição. Se binary for fornecido, todas as funções de manipulador serão opcionais. Se binary não for fornecido, a função de GetStream manipulador será necessária. Se uma função de manipulador não for especificada para uma operação, o comportamento padrão da operação será aplicado em binary vez disso (exceto no caso de GetExpression ). As funções de manipulador devem retornar um valor semanticamente equivalente ao resultado da aplicação da operação ( binary ou a 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. Binary.View pode ser usado para implementar a dobra em uma fonte de dados – a tradução de consultas M em operações específicas da origem (por exemplo, para baixar uma seção de um arquivo). Consulte a documentação do conector personalizado do Power Query publicada para obter uma descrição mais completa de Binary.View . Exemplo Crie uma exibição básica que não exija o acesso aos dados para determinar o comprimento. Usage Power Query M Binary.View( null, [ GetLength = () => 12, GetStream = () => Text.ToBinary("hello world!") ] ) Saída Text.ToBinary("hello world!") Last updated on 03/04/2026

Cria um registro de erro modificado do errorRecord qual não disparará um fallback quando gerado por um manipulador definido em uma exibição (via Binary.View). Last updated on 11/02/2026

Cria uma função de exibição com base no function que pode ser tratado em uma exibição criada por Binary.View. O OnInvoke manipulador de Binary.View pode ser usado para definir um manipulador para a função de exibição. Assim como acontece com os manipuladores para operações internas, se nenhum OnInvoke manipulador for especificado ou se ele não manipular a função de exibição ou se um erro for gerado pelo manipulador, function será aplicado na parte superior da exibição. Consulte a documentação do conector personalizado do Power Query publicada para obter uma descrição mais completa e funções de Binary.View exibição personalizadas. Last updated on 22/11/2025

Um formato binário que lê um inteiro com sinal de 64 bits que foi codificado usando uma codificação de comprimento variável de 7 bits. Last updated on 22/11/2025

Um formato binário que lê um inteiro sem sinal de 64 bits que foi codificado usando uma codificação de comprimento variável de 7 bits. Last updated on 22/11/2025

Retorna um formato binário que lê um valor binário. Se length for especificado, o valor binário conterá muitos bytes. Se length não for especificado, o valor binário conterá os bytes restantes. Pode length ser especificado como um número ou como um formato binário do comprimento que precede os dados binários. Last updated on 22/11/2025

Um formato binário que lê um inteiro sem sinal de 8 bits. Last updated on 16/09/2025

Retorna um formato binário com a ordem de bytes especificada por binaryFormat . A ordem de bytes padrão é ByteOrder.BigEndian . Last updated on 22/11/2025

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 de escolha especificada pelo parâmetro chooseFunction . A função de escolha 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, os valores primeiro e segundo serão passados para a função de combinação 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 type opcional indica o tipo de formato binário que será retornado pela função de escolha. Pode ser especificado type any , type list ou type binary . 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.

Um formato binário que lê um valor decimal de 16 bytes do .NET. Last updated on 16/09/2025

Um formato binário que lê um valor de ponto flutuante de precisão dupla IEEE de 8 bytes. Last updated on 16/09/2025

Os parâmetros são os seguintes: O binaryFormat parâmetro especifica o formato binário do valor da chave. O group parâmetro 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 extra parâmetro não for especificado, um erro será gerado se houver valores de chave inesperados. O group parâmetro especifica uma lista de definições de item. Cada definição de item é uma lista, contendo valores de 3 a 5, da seguinte maneira: Valor da chave. O valor da chave que corresponde ao item. Isso deve ser exclusivo dentro do conjunto de itens. Formato de item. O formato binário correspondente ao valor do item. Isso permite que cada item tenha um formato diferente. Ocorrência de item. O BinaryOccurrence.Type valor de quantas vezes o item deve aparecer no grupo. Os itens necessários que não estão presentes causam um erro. Itens duplicados obrigatórios ou opcionais são tratados como valores de chave inesperados. Valor do item padrão (opcional). Se o valor do item padrão aparecer na lista de definição de item e não for nulo, ele será usado em vez do padrão. O padrão para itens recorrentes ou opcionais é nulo e o padrão para valores repetidos é uma lista vazia { }. Transformação do valor do item (opcional). Se a função de transformação de valor do item estiver presente na lista de definição de item e não for nula, ela será chamada para transformar o valor do item antes de ser retornado. A função de transformação só será chamada se o item aparecer na entrada (ela nunca será chamada com o valor padrão). Exemplo 1 O seguinte pressupõe um valor de chave que é um único byte, com 4 itens esperados no grupo, todos com um byte de dados seguindo a chave. Os itens aparecem na entrada da seguinte maneira: A chave 1 é necessária e aparece com o valor 11. A chave 2 se repete e aparece duas vezes com o valor 22 e resulta em um valor de { 22,

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

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

Um formato binário que lê zero bytes e retorna nulo. Last updated on 16/09/2025

Retorna um formato binário que lê um registro. O record parâmetro especifica o formato do registro. Cada campo no 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.

Um formato binário que lê um inteiro com sinal de 16 bits. Last updated on 16/09/2025

Um formato binário que lê um inteiro com sinal de 32 bits. Last updated on 16/09/2025

Um formato binário que lê um inteiro com sinal de 64 bits. Last updated on 16/09/2025

Um formato binário que lê um valor de ponto flutuante de precisão única IEEE de 4 bytes. Last updated on 22/11/2025

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

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

Um formato binário que lê um inteiro sem sinal de 16 bits. Last updated on 16/09/2025

Um formato binário que lê um inteiro sem sinal de 32 bits. Last updated on 16/09/2025

Um formato binário que lê um inteiro sem sinal de 64 bits. Last updated on 16/09/2025 #binary Sintaxe #binary(value as any) as any Sobre Cria um valor binário de uma lista de números ou um valor de texto codificado em base 64.

Retorna um valor inteiro de 8 bits number do determinado value . Se o dado value for null , Byte.From retornará null . Se o determinado value estiver number dentro do intervalo de um 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 é RoundingMode.ToEven. Se value for de qualquer outro tipo, ele será convertido primeiro em um number uso Number.FromText. Number.Round Consulte os modos de arredondamento disponíveis. Um opcional culture também pode ser fornecido (por exemplo, "en-US").

Essa função não está disponível no contexto atual.

Retorna o equivalente de caractere do número. O fornecido number deve ser um ponto de código Unicode de 21 bits.

Retorna o número equivalente do character . O resultado será o ponto de código Unicode de 21 bits representado pelo caractere fornecido ou pelo par substituto.

Retorna uma função que combina uma lista de valores de texto em um único valor de texto usando o delimitador especificado.

Retorna uma função que combina uma lista de valores de texto em um único valor de texto usando uma sequência de delimitadores.

Retorna uma função que combina uma lista de valores de texto em um único valor de texto usando os comprimentos especificados.

Retorna uma função que combina uma lista de valores de texto em um único valor de texto usando as posições de saída especificadas. Exemplo Combine uma lista de valores de texto colocando-os na saída nas posições especificadas. Usage Power Query M Combiner.CombineTextByPositions({0, 5, 10})({"abc", "def", "ghi"}) Saída "abc def ghi" Last updated on 03/04/2026

Retorna uma função que combina uma lista de valores de texto em um único valor de texto usando as posições e os comprimentos de saída especificados. Um comprimento nulo indica que todo o valor de texto deve ser incluído. Exemplo Combine uma lista de valores de texto usando as posições e os comprimentos de saída especificados. Usage Power Query M Combiner.CombineTextByRanges({{0, 1}, {3, 2}, {6, null}})({"abc", "def", "ghijkl"}) Saída "a de ghijkl" Last updated on 03/04/2026 Funções de comparação Artigo • 23/11/2024 Essas funções testam a igualdade e determinam a ordem. ﾉ Expandir a tabela Nome Descrição Comparer.Equals Retorna um valor lógico baseado na verificação de igualdade sobre os dois valores fornecidos. Comparer.FromCulture Retorna uma função de comparador com base na cultura especificada e na confidencialidade de maiúsculas e minúsculas. Comparer.Ordinal Retorna uma função de comparador que usa regras do Ordinal para comparar valores. Comparer.OrdinalIgnoreCase Retorna uma função de comparador que não diferencia maiúsculas de minúsculas que usa regras ordinais para comparar os valores fornecidos. Comentários Esta página foi útil?  Yes  No Fornecer comentários sobre o produto | Pergunte à comunidade

Retorna um logical valor com base na verificação de igualdade sobre os dois valores fornecidos e y , x usando o fornecido comparer . comparer é um Comparer que é usado para controlar a comparação. Um comparador é uma função que aceita dois argumentos e retorna -1, 0 ou 1 com base em se o primeiro valor é menor que, igual ou maior que o segundo. Os comparadores podem ser usados para fornecer comparações que não diferenciam maiúsculas de minúsculas ou cultura e reconhecimento de localidade. Os seguintes comparadores internos estão disponíveis no idioma da fórmula: Comparer.Ordinal: usado para executar uma comparação ordinal exata Comparer.OrdinalIgnoreCase: usado para executar uma comparação ordinal exata que não diferencia maiúsculas de minúsculas Comparer.FromCulture: usado para executar uma comparação com reconhecimento de cultura

Retorna uma função comparador que usa a culture diferenciação de maiúsculas e minúsculas especificada para ignoreCase executar comparações. Uma função comparador aceita dois argumentos e retorna -1, 0 ou 1 com base em se o primeiro valor é menor que, igual ou maior que o segundo. O valor padrão é ignoreCase falso. Deve culture ser uma das localidades compatíveis com o .NET Framework (por exemplo, "en-US").

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

Retorna uma função comparador que não diferencia maiúsculas de minúsculas que usa regras ordinais para comparar os valores fornecidos x e y . Uma função comparador aceita dois argumentos e retorna -1, 0 ou 1 com base em se o primeiro valor é menor que, igual ou maior que o segundo.

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. O delimiter pode ser um caractere, uma lista de caracteres ou o valor "" , que indica que as linhas devem ser divididas por caracteres de espaço em branco consecutivos. Padrão: "," . Consulte ExtraValues.Type para obter os valores suportados de extraValues . 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 : um delimitador de coluna de caractere único. 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 tratadas. CsvStyle.QuoteAfterDelimiter (padrão): as aspas em um campo só são significativas imediatamente após o delimitador. CsvStyle.QuoteAlways: as aspas em um campo são sempre significativas, independentemente de onde elas aparecem. QuoteStyle : especifica como as quebras de linha entre aspas são tratadas. QuoteStyle.Csv (padrão): as quebras de linha entre aspas são tratadas como parte dos dados, não como o final da linha atual. QuoteStyle.None: todas as quebras de linha são tratadas como o final da linha atual, mesmo quando ocorrem dentro de um valor entre aspas. IncludeByteOrderMark : um valor lógico que indica se uma marca de ordem de byte (BOM) deve ser incluída no início da saída CSV. Quando definido como true, o BOM é escrito (por exemplo, UTF-8 BO

Mescla a tabela de dimensões especificada, dimensionSelector no contexto de filtro e cube 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 especificadas. Last updated on 04/04/2026

Adiciona uma coluna com o nome column ao cube que contém os resultados da medida measureSelector aplicada no contexto de linha de cada linha. O aplicativo de medida é afetado por alterações na granularidade e no fatiamento da dimensão. Os valores de medida serão ajustados após a execução de determinadas operações de cubo. Last updated on 22/11/2025

Retorna um cubo depois de parameter aplicar com arguments cube . Last updated on 22/11/2025

Retorna o identificador de membro exclusivo de um valor de propriedade de membro. attribute . Retorna nulo para quaisquer outros valores. Last updated on 22/11/2025

Retorna a propriedade propertyName do atributo attribute de dimensão. Last updated on 22/11/2025

Altera a granularidade dimensional do contexto de filtro para o cube recolhimento dos atributos mapeados para as colunas columnNames especificadas. As colunas também são removidas da exibição tabular do cubo. Last updated on 22/11/2025

Retorna uma tabela que contém o conjunto de dimensões disponíveis no 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 Cube.AddAndExpandDimensionColumn. Last updated on 22/11/2025

Retorna uma árvore aninhada de tabelas que representa a hierarquia de pastas de exibição dos objetos (por exemplo, dimensões e medidas) disponíveis para uso no cube . Last updated on 22/11/2025

Retorna uma tabela que contém o conjunto de propriedades disponíveis para medidas que são expandidas no cubo. Last updated on 22/11/2025

Retorna a propriedade propertyName da medida measure . Last updated on 16/09/2025

Retorna uma 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 Cube.AddMeasureColumn. Last updated on 22/11/2025

Retorna uma tabela que contém o conjunto de parâmetros que podem ser aplicados a cube . Cada parâmetro é uma função que pode ser invocada para obter cube com o parâmetro e seus argumentos aplicados. Last updated on 22/11/2025

Retorna uma tabela contendo o conjunto de propriedades disponíveis para dimensões expandidas no cubo. Last updated on 16/09/2025

Retorna a chave da propriedade property . Last updated on 16/09/2025

Substitui o conjunto de dimensões retornado por Cube.Dimensions. Por exemplo, essa função pode ser usada para adicionar uma coluna de ID a um atributo de dimensão, de modo que a fonte de dados possa agrupar na ID em vez do valor exibido. Last updated on 04/04/2026

Aplica as funções de cubo de lista, transforms na cube . Last updated on 22/11/2025

Retorna um currency valor do determinado value . Se o dado value for null , Currency.From retornará null . Se o dado value estiver number dentro do intervalo de moeda, a value parte fracionária dos dígitos decimais será arredondada para 4 dígitos decimais e retornada. Se value for de qualquer outro tipo, ele será convertido primeiro em um number uso Number.FromText. O intervalo válido para a moeda é -922,337,203,685,477.5808 para 922,337,203,685,477.5807 . Number.Round Consulte os modos de arredondamento disponíveis. O padrão é RoundingMode.ToEven. Um opcional culture também pode ser fornecido (por exemplo, "en-US").

Retorna o 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 adicionados. numberOfDays : o número de dias a adicionar.

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 adicionar.

Retorna o resultado date , datetime ou datetimezone da adição de numberOfQuarters trimestres ao valor datetime dateTime . dateTime : o valor date , datetime ou datetimezone ao qual se adicionam os trimestres. numberOfQuarters : o número de trimestres a serem adicionados. Exemplo Adicione um trimestre ao valor date , datetime ou datetimezone que representa a data de 14/05/2011. Uso Power Query M Date.AddQuarters(#date(2011, 5, 14), 1) Saída #date(2011, 8, 14) Conteúdo relacionado #date #datetime #datetimezone Last updated on 25/03/2026

Retorna o 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 adicionar.

Retorna o date , datetime ou datetimezone de adicionar numberOfYears a um valor datetime dateTime . dateTime : valor date , datetime ou datetimezone ao qual os anos são adicionados. numberOfYears : o número de anos a adicionar.

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

Retorna um número (de 0 a 6) que indica o dia da semana do fornecido dateTime . dateTime : A date , datetime ou datetimezone valor. firstDayOfWeek : um Day valor que indica qual dia deve ser considerado o primeiro dia da semana. Os valores permitidos são Day.Sunday, , Day.Monday, Day.Tuesday, Day.Wednesday, Day.Thursday, Day.Fridayou Day.Saturday. Se não for especificado, um padrão dependente da cultura será usado.

Retorna o nome do dia da semana para o fornecido date . Um opcional culture também pode ser fornecido (por exemplo, "en-US"). Exemplo Obtenha o nome do dia da semana. Usage Power Query M Date.DayOfWeekName(#date(2011, 12, 31), "en-US") Saída "Saturday" Conteúdo relacionado Como a cultura afeta a formatação de texto Last updated on 25/03/2026

Retorna um número que representa o dia do ano no valor fornecido date , datetime ou datetimezone valor. dateTime Exemplo O dia do ano de 1º de março de 2011. Usage Power Query M Date.DayOfYear(#date(2011, 03, 01)) Saída 60 Last updated on 25/03/2026

Retorna o número de dias no mês no date valor ou datetime no valor datetimezone dateTime . dateTime : A date , datetime ou datetimezone valor para o qual o número de dias no mês é retornado. Exemplo Número de dias no mês de dezembro, conforme representado por #date(2011, 12, 01) . Usage Power Query M Date.DaysInMonth(#date(2011, 12, 01)) Saída 31 Last updated on 25/03/2026 Date.EndOfDay Date.EndOfDay(dateTime as any) as any Sobre Retorna o final do dia representado por dateTime . As informações de fuso horário são preservadas. dateTime : A date , datetime ou datetimezone valor do qual o final do dia é calculado.

Retorna o final do mês que contém dateTime . dateTime : A date , datetime ou datetimezone valor do qual o final do mês é calculado.

Retorna o final do trimestre que contém dateTime . As informações de fuso horário são preservadas. dateTime : A date , datetime ou datetimezone valor do qual o final do trimestre é calculado.

Retorna o final da semana que contém dateTime . Essa função usa um opcional Day , firstDayOfWeek para definir como o primeiro dia da semana para esse cálculo relativo. O valor padrão é Day.Sunday. dateTime : A date , datetime ou datetimezone valor do qual o último dia da semana é calculado firstDayOfWeek : [Opcional] Um Day.Type valor que representa o primeiro dia da semana. Os valores possíveis são Day.Sunday , , Day.Monday , Day.Tuesday , Day.Wednesday , Day.Thursday e Day.Friday Day.Saturday . O valor padrão é Day.Sunday .

Retorna o final do ano que contém dateTime , incluindo segundos fracionários. As informações de fuso horário são preservadas. dateTime : A date , datetime ou datetimezone valor do qual o final do ano é calculado.

Retorna um valor de data do valor fornecido. value : O valor a ser convertido em uma data. Se o valor fornecido for null , esta função retorna null . Se o valor fornecido for date , value é retornado. Os valores dos seguintes tipos podem ser convertidos em um date valor: text : Um valor date da representação textual. Consulte Date.FromText 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 datetime de um número de ponto flutuante cujo componente integral é o número de dias antes ou depois da meia-noite de 30 de dezembro de 1899 e cujo componente fracionário representa a hora desse dia dividida por 24. Por exemplo, meia-noite de 31 de dezembro de 1899 é representada por 1,0; 6 da manhã, 1º de janeiro de 1900 é representado por 2,25; meia-noite de 29 de dezembro de 1899 é representada por -1,0; e 6 da manhã, 29 de dezembro de 1899 é representado por -1,25. O valor base é meia-noite de 30 de dezembro de 1899. O valor mínimo é meia-noite de 1º de janeiro de 0100. O valor máximo é o último momento de 31 de dezembro de 9999. Se value for de qualquer outro tipo, um erro será retornado. culture : A cultura do valor fornecido (por exemplo, "en-US").

Cria um valor de data a partir de uma representação textual. text : Um valor de texto a ser convertido em uma data. options : Um opcional record que pode ser fornecido para especificar propriedades adicionais. O record pode conter os seguintes campos: Format : um valor text que indica o formato a ser usado. Para obter mais detalhes, acesse Cadeias de caracteres de formato de data e hora padrão e Cadeias de caracteres de formato de data e hora personalizadas. Omitir esse campo ou fornecer null resultados na análise da data usando um melhor esforço. Culture : Quando Format não é nulo, Culture controla alguns especificadores de formato. Por exemplo, em "en-US" "MMM" é "Jan", "Feb", "Mar", ... , enquanto em "ru-RU" "MMM" é "янв", "фев", "мар", ... . Quando Format é null , Culture controla o formato padrão a ser usado. Quando Culture é null ou omitido, Culture.Current é usado. Para dar suporte a fluxos de trabalho herdados, options também pode ser um valor de texto. Isso tem o mesmo comportamento que options = [Format = null, Culture = options] .

Indica se o valor dateTime de datetime fornecido ocorre durante o dia atual, conforme determinado pela data e hora atuais no sistema. dateTime : A date , datetime ou datetimezone valor a ser avaliado. Example Determine se a hora atual do sistema está no dia atual. Usage Power Query M Date.IsInCurrentDay(DateTime.FixedLocalNow()) Saída true Last updated on 22/11/2025

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

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

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

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

Indica se o valor dateTime de datetime fornecido ocorre durante o dia seguinte, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do dia atual. dateTime : A date , datetime ou datetimezone valor a ser avaliado. Exemplo Determine se o dia após a hora atual do sistema é no dia seguinte. Usage Power Query M Date.IsInNextDay(Date.AddDays(DateTime.FixedLocalNow(), 1)) Saída true Last updated on 25/03/2026

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

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

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

Indica se o valor dateTime de datetime fornecido ocorre durante o próximo número de semanas, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro da semana atual. dateTime : A date , datetime ou datetimezone valor a ser avaliado. weeks : o número de semanas.

Indica se o valor dateTime de datetime fornecido ocorre durante o próximo número de anos, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do ano atual. dateTime : A date , datetime ou datetimezone valor a ser avaliado. years : o número de anos.

Indica se o valor dateTime de datetime fornecido ocorre durante o próximo trimestre, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do trimestre atual. dateTime : A date , datetime ou datetimezone valor a ser avaliado.

Indica se o valor dateTime de datetime fornecido ocorre durante a próxima semana, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro da semana atual. dateTime : A date , datetime ou datetimezone valor a ser avaliado.

Indica se o valor dateTime de datetime fornecido ocorre durante o próximo ano, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do ano atual. dateTime : A date , datetime ou datetimezone valor a ser avaliado.

Indica se o valor dateTime de datetime fornecido ocorre durante o dia anterior, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do dia atual. dateTime : A date , datetime ou datetimezone valor a ser avaliado. Exemplo Determine se o dia anterior à hora atual do sistema está no dia anterior. Usage Power Query M Date.IsInPreviousDay(Date.AddDays(DateTime.FixedLocalNow(), -1)) Saída true Last updated on 25/03/2026

Indica se o valor dateTime de datetime fornecido ocorre durante o mês anterior, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do mês atual. dateTime : A date , datetime ou datetimezone valor a ser avaliado.

Indica se o valor dateTime de datetime fornecido ocorre durante o número anterior de dias, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do dia atual. dateTime : A date , datetime ou datetimezone valor a ser avaliado. 'days: o número de dias.

Indica se o valor dateTime de datetime fornecido ocorre durante o número anterior de meses, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do mês atual. dateTime : A date , datetime ou datetimezone valor a ser avaliado. months : o número de meses.

Indica se o valor dateTime de datetime fornecido ocorre durante o número anterior de trimestres, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do trimestre atual. dateTime : A date , datetime ou datetimezone valor a ser avaliado. quarters : o número de trimestres. Exemplo Determine se o trimestre antes da hora atual do sistema está nos dois trimestres anteriores. Usage Power Query M Date.IsInPreviousNQuarters(Date.AddQuarters(DateTime.FixedLocalNow(), -1), 2) Saída true Last updated on 25/03/2026

Indica se o valor dateTime de datetime fornecido ocorre durante o número anterior de semanas, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro da semana atual. dateTime : A date , datetime ou datetimezone valor a ser avaliado. weeks : o número de semanas.

Indica se o valor dateTime de datetime fornecido ocorre durante o número anterior de anos, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do ano atual. dateTime : A date , datetime ou datetimezone valor a ser avaliado. years : o número de anos.

Indica se o valor dateTime de datetime fornecido ocorre durante o trimestre anterior, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do trimestre atual. dateTime : A date , datetime ou datetimezone valor a ser avaliado. Exemplo Determine se o trimestre antes da hora atual do sistema está no trimestre anterior. Usage Power Query M Date.IsInPreviousQuarter(Date.AddQuarters(DateTime.FixedLocalNow(), -1)) Saída true Last updated on 25/03/2026

Indica se o valor dateTime de datetime fornecido ocorre durante a semana anterior, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro da semana atual. dateTime : A date , datetime ou datetimezone valor a ser avaliado.

Indica se o valor dateTime de datetime fornecido ocorre durante o ano anterior, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do ano atual. dateTime : A date , datetime ou datetimezone valor a ser avaliado.

Indica se o valor dateTime de datetime fornecido ocorre durante o ano atual e está ativado ou antes do dia atual, conforme determinado pela data e hora atuais no sistema. dateTime : A date , datetime ou datetimezone valor a ser avaliado.

Indica se o valor dateTime de datetime fornecido cai é um ano bissexto. dateTime : A date , datetime ou datetimezone valor a ser avaliado. Exemplo Determine se o ano de 2012, como representado por #date(2012, 01, 01) é um ano bissexto. Usage Power Query M Date.IsLeapYear(#date(2012, 01, 01)) Saída true Last updated on 25/03/2026

Retorna o componente mensal do valor fornecido datetime . dateTime Exemplo Localize o mês em #datetime(2011, 12, 31, 9, 15, 36) . Usage Power Query M Date.Month(#datetime(2011, 12, 31, 9, 15, 36)) Saída 12 Last updated on 30/06/2026

Retorna o nome do componente do mês para o fornecido date . Um opcional culture também pode ser fornecido (por exemplo, "en-US").

Retorna um número de 1 a 4 indicando em qual trimestre do ano a data dateTime cai. dateTime pode ser um date , datetime ou datetimezone valor.

Retorna o início do dia representado por dateTime . dateTime deve ser um date , datetime ou datetimezone valor.

Retorna o início do mês que contém dateTime . dateTime deve ser um valor ou um date datetime valor.

Retorna o início do trimestre que contém dateTime . dateTime deve ser um date , datetime ou datetimezone valor.

Retorna o início da semana que contém dateTime . dateTime deve ser um date , datetime ou datetimezone valor.

Retorna o início do ano que contém dateTime . dateTime deve ser um date , datetime ou datetimezone valor.

Retorna um registro que contém as partes do valor de data fornecido. date date : um date valor para o qual o registro de suas partes deve ser calculado.

Retorna uma representação textual de date . Um parâmetro de record opcional, options , pode ser fornecido para especificar propriedades adicionais. culture é usado apenas para fluxos de trabalho herdados. O record pode conter os seguintes campos: Format : um valor text que indica o formato a ser usado. Para obter mais detalhes, vá para cadeias de caracteres de formato de data e hora padrão e cadeias de caracteres de formato de data e hora personalizadas. Omitir esse campo ou fornecer null resultará na formatação da data usando o padrão definido por Culture . Culture : quando Format não é nulo, Culture controla alguns especificadores de formato. Por exemplo, em "en-US" "MMM" é "Jan", "Feb", "Mar", ... , enquanto em "ru-RU" "MMM" é "янв", "фев", "мар", ... . Quando Format é null , Culture controla o formato padrão a ser usado. Quando Culture é null ou omitido, Culture.Current é usado. Para dar suporte a fluxos de trabalho herdados, options e culture também podem ser valores de texto. Isso tem o mesmo comportamento que options = [Format = options, Culture = culture] .

Retorna um número de 1 a 6 indicando em qual semana do mês a data dateTime cai. dateTime : um datetime valor para o qual a semana do mês é determinada.

Retorna um número de 1 a 54 indicando em qual semana do ano a data cai dateTime . dateTime : um datetime valor para o qual a semana do ano é determinada. firstDayOfWeek : um valor opcional Day.Type que indica qual dia é considerado o início de uma nova semana (por exemplo, Day.Sunday ). Se não for especificado, um padrão dependente da cultura será usado.

Retorna o componente de ano do valor fornecido datetime . dateTime Exemplo Encontre o ano em #datetime(2011, 12, 31, 9, 15, 36). Usage Power Query M Date.Year(#datetime(2011, 12, 31, 9, 15, 36)) Saída 2011 Last updated on 25/03/2026 #date 16/09/2025 Sintaxe #date( year as number, month as number, day as number ) as date Sobre Cria um valor de data a partir de números inteiros representando o ano, o mês e o dia. Gera um erro se estas condições não são verdadeiras: 1 ≤ ano ≤ 9999 1 ≤ mês ≤ 12 1 ≤ dia ≤ 31

Adiciona informações de fuso horário ao dateTime valor. As informações de fuso horário incluem timezoneHours e, opcionalmente timezoneMinutes , que especificam o deslocamento desejado da hora UTC.

Retorna o componente de data do dateTime parâmetro se o parâmetro for um date , datetime ou datetimezone valor, ou null se o parâmetro for null . Exemplo Localizar o valor de data de #datetime(2010, 12, 31, 11, 56, 02) . Usage Power Query M DateTime.Date(#datetime(2010, 12, 31, 11, 56, 02)) Saída #date(2010, 12, 31) Last updated on 30/06/2026

Retorna um datetime valor definido como a data e a hora atuais no sistema. Esse valor é fixo e não será alterado com chamadas sucessivas, ao contrário DateTime.LocalNow, que podem retornar valores diferentes ao longo da execução de uma expressão. Conteúdo relacionado Variantes locais, fixas e UTC das funções de tempo atuais

Retorna um datetime valor do determinado value . Um opcional culture também pode ser fornecido (por exemplo, "en-US"). Se o dado value for null , DateTime.From retornará null . Se o dado value for datetime , value será retornado. Os valores dos seguintes tipos podem ser convertidos em um datetime valor: text : um datetime valor da representação textual. Consulte DateTime.FromText para obter detalhes. date : A datetime com value como o componente de data e 12:00:00 AM como o componente de hora. datetimezone : o equivalente local datetime de value . time : A datetime com a data equivalente à Data de Automação OLE como o componente de 0 data e value como o componente de hora. number : um datetime equivalente à Data de Automação OLE expressa por value . Se value for de qualquer outro tipo, um erro será retornado.

Cria um datetime valor do fileTime valor e o converte no fuso horário local. O filetime é um valor de tempo de arquivo do Windows que representa o número de intervalos de 100 nanossegundos decorridos desde 12:00 meia-noite, 1º de janeiro de 1601 D.C. (C.E.) UTC (Tempo Universal Coordenado).

Cria um valor datetime com base em uma representação textual, text . Um parâmetro de record opcional, options , pode ser fornecido para especificar propriedades adicionais. O record pode conter os seguintes campos: Format : um valor text que indica o formato a ser usado. Para obter mais detalhes, vá para cadeias de caracteres de formato de data e hora padrão e cadeias de caracteres de formato de data e hora personalizadas. Omitir esse campo ou fornecer null resultará na análise da data usando um melhor esforço. Culture : quando Format não é nulo, Culture controla alguns especificadores de formato. Por exemplo, em "en-US" "MMM" é "Jan", "Feb", "Mar", ... , enquanto em "ru-RU" "MMM" é "янв", "фев", "мар", ... . Quando Format é null , Culture controla o formato padrão a ser usado. Quando Culture é null ou omitido, Culture.Current é usado. Para dar suporte a fluxos de trabalho herdados, options também podem ser um valor de texto. Isso tem o mesmo comportamento que options = [Format = null, Culture = options] .

Indica se o valor dateTime de datetime fornecido ocorre durante a hora atual, conforme determinado pela data e hora atuais no sistema. dateTime : A datetime ou datetimezone valor a ser avaliado.

Indica se o valor dateTime de datetime fornecido ocorre durante o minuto atual, conforme determinado pela data e hora atuais no sistema. dateTime : A datetime ou datetimezone valor a ser avaliado. Exemplo Determine se a hora atual do sistema está no minuto atual. Usage Power Query M DateTime.IsInCurrentMinute(DateTime.FixedLocalNow()) Saída true Last updated on 25/03/2026

Indica se o valor dateTime de datetime fornecido ocorre durante o segundo atual, conforme determinado pela data e hora atuais no sistema. dateTime : A datetime ou datetimezone valor a ser avaliado. Exemplo Determine se a hora atual do sistema está no segundo atual. Usage Power Query M DateTime.IsInCurrentSecond(DateTime.FixedLocalNow()) Saída true Last updated on 25/03/2026

Indica se o valor dateTime de datetime fornecido ocorre durante a próxima hora, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro da hora atual. dateTime : A datetime ou datetimezone valor a ser avaliado.

Indica se o valor dateTime de datetime fornecido ocorre durante o próximo minuto, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do minuto atual. dateTime : A datetime ou datetimezone valor a ser avaliado.

Indica se o valor dateTime de datetime fornecido ocorre durante o próximo número de horas, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro da hora atual. dateTime : A datetime ou datetimezone valor a ser avaliado. hours : o número de horas.

Indica se o valor dateTime de datetime fornecido ocorre durante o próximo número de minutos, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do minuto atual. dateTime : A datetime ou datetimezone valor a ser avaliado. minutes : o número de minutos. Exemplo Determine se o minuto após a hora atual do sistema é nos próximos dois minutos. Usage Power Query M DateTime.IsInNextNMinutes(DateTime.FixedLocalNow() + #duration(0, 0, 2, 0), 2) Saída true Last updated on 25/03/2026

Indica se o valor dateTime de datetime fornecido ocorre durante o próximo número de segundos, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do segundo atual. dateTime : A datetime ou datetimezone valor a ser avaliado. seconds : o número de segundos.

Indica se o valor dateTime de datetime fornecido ocorre durante o próximo segundo, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do segundo atual. dateTime : A datetime ou datetimezone valor a ser avaliado. Exemplo Determine se o segundo após a hora atual do sistema está no próximo segundo. Usage Power Query M DateTime.IsInNextSecond(DateTime.FixedLocalNow() + #duration(0, 0, 0, 1)) Saída true Last updated on 25/03/2026

Indica se o valor dateTime de datetime fornecido ocorre durante a hora anterior, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro da hora atual. dateTime : A datetime ou datetimezone valor a ser avaliado. Exemplo Determine se a hora anterior à hora atual do sistema está na hora anterior. Usage Power Query M DateTime.IsInPreviousHour(DateTime.FixedLocalNow() - #duration(0, 1, 0, 0)) Saída true Last updated on 25/03/2026

Indica se o valor dateTime de datetime fornecido ocorre durante o minuto anterior, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do minuto atual. dateTime : A datetime ou datetimezone valor a ser avaliado.

Indica se o valor dateTime de datetime fornecido ocorre durante o número anterior de horas, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro da hora atual. dateTime : A datetime ou datetimezone valor a ser avaliado. hours : o número de horas.

Indica se o valor dateTime de datetime fornecido ocorre durante o número anterior de minutos, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do minuto atual. dateTime : A datetime ou datetimezone valor a ser avaliado. minutes : o número de minutos. Exemplo Determine se o minuto antes da hora atual do sistema está nos dois minutos anteriores. Usage Power Query M DateTime.IsInPreviousNMinutes(DateTime.FixedLocalNow() - #duration(0, 0, 2, 0), 2) Saída true Last updated on 25/03/2026

Indica se o valor dateTime de datetime fornecido ocorre durante o número anterior de segundos, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do segundo atual. dateTime : A datetime >ou datetimezone valor a ser avaliado. seconds : o número de segundos. Exemplo Determine se o segundo antes do tempo atual do sistema está nos dois segundos anteriores. Usage Power Query M DateTime.IsInPreviousNSeconds(DateTime.FixedLocalNow() - #duration(0, 0, 0, 2), 2) Saída true Last updated on 25/03/2026

Indica se o valor dateTime de datetime fornecido ocorre durante o segundo anterior, conforme determinado pela data e hora atuais no sistema. Observe que essa função retornará false quando passar um valor que ocorre dentro do segundo atual. dateTime : A datetime ou datetimezone valor a ser avaliado.

Retorna um datetime valor definido como a data e a hora atuais no sistema. O valor retornado por essa função depende se você está executando sua consulta em um computador local ou online. Por exemplo, se você executar sua consulta em um sistema localizado no fuso horário do Pacífico dos EUA, o Power Query Desktop retornará a data e a hora definidas em seu computador local. No entanto, se você executar sua consulta na nuvem, o Power Query Online retornará tempo UTC porque ele está lendo o tempo definido nas máquinas virtuais de nuvem, que estão todas definidas como UTC.

Retorna a parte de hora do valor de datetime fornecido. dateTime Exemplo Localize o valor de tempo de #datetime(2010, 12, 31, 11, 56, 02) . Usage Power Query M DateTime.Time(#datetime(2010, 12, 31, 11, 56, 02)) Saída #time(11, 56, 2) Last updated on 30/06/2026

Retorna um registro que contém as partes do valor de datetime fornecido. dateTime dateTime : um datetime valor para o qual o registro de suas partes deve ser calculado.

Retorna uma representação textual de dateTime . Um parâmetro de record opcional, options , pode ser fornecido para especificar propriedades adicionais. culture é usado apenas para fluxos de trabalho herdados. O record pode conter os seguintes campos: Format : um valor text que indica o formato a ser usado. Para obter mais detalhes, vá para cadeias de caracteres de formato de data e hora padrão e cadeias de caracteres de formato de data e hora personalizadas. Omitir esse campo ou fornecer null resultará na formatação da data usando o padrão definido por Culture . Culture : quando Format não é nulo, Culture controla alguns especificadores de formato. Por exemplo, em "en-US" "MMM" é "Jan", "Feb", "Mar", ... , enquanto em "ru-RU" "MMM" é "янв", "фев", "мар", ... . Quando Format é null , Culture controla o formato padrão a ser usado. Quando Culture é null ou omitido, Culture.Current é usado. Para dar suporte a fluxos de trabalho herdados, options e culture também podem ser valores de texto. Isso tem o mesmo comportamento que options = [Format = options, Culture = culture] .

Retorna um datetime valor definido como a data e a hora atuais no sistema. O valor retornado contém informações de fuso horário que representam o fuso horário local. Esse valor é fixo e não será alterado com chamadas sucessivas, ao contrário DateTimeZone.LocalNow, que podem retornar valores diferentes ao longo da execução de uma expressão. Conteúdo relacionado Variantes locais, fixas e UTC das funções de tempo atuais

Retorna a data e a hora atuais em UTC (o fuso horário GMT). Esse valor é fixo e não será alterado com chamadas sucessivas. Conteúdo relacionado Variantes locais, fixas e UTC das funções de tempo atuais

Cria um datetimezone com base no valor fornecido. value : o valor usado para criar um datetimezone . culture : (Opcional) A cultura a ser usada ao transformar o valor (por exemplo, "en-US"). Os valores dos seguintes tipos podem ser convertidos em um datetimezone valor: text : retorna um datetimezone valor da representação textual. Consulte DateTimeZone.FromText para obter detalhes. date : retorna 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 : retorna um datetimezone com value como data e hora e o deslocamento de tempo correspondente ao fuso horário local. datetimezone : retorna value . time : Retorna um datetimezone com a data equivalente da Data de Automação OLE de 0 como componente de data, value como componente de tempo e o deslocamento correspondente da hora local. A Data de Automação OLE consiste em um número de ponto flutuante cujo componente integral é o número de dias antes ou depois da meianoite, 30 de dezembro de 1899, e cujo componente fracionário representa a hora naquele dia dividida por 24. Por exemplo, meia-noite, 31 de dezembro de 1899 é representado por 1,0; 6 da manhã, 1 de janeiro de 1900 é representado por 2,25; meia-noite, 29 de dezembro de 1899 é representado por -1.0; e 6 da manhã, 29 de dezembro de 1899 é representado por -1,25. O valor base é meia-noite, 30 de dezembro de 1899. O valor mínimo é meia-noite, 1º de janeiro de 0100. O valor máximo é o último momento de 31 de dezembro de 9999. number : Retorna um datetimezone com o datetime equivalente à Data de Automação OLE, expressa por value , e o deslocamento correspondente ao fuso horário local. null : retorna null . Se value for de qualquer outro tipo, um erro será retornado. O valor do deslocamento correspondente ao fuso horário local é diferente ao executar essa função localmente em vez de executá-la online. Quando executado localmente, o fuso horário local é retornado. Quando ex

Cria um datetimezone valor do fileTime valor e o converte no fuso horário local. O filetime é um valor de tempo de arquivo do Windows que representa o número de intervalos de 100 nanossegundos decorridos desde 12:00 meia-noite, 1º de janeiro de 1601 D.C. (C.E.) UTC (Tempo Universal Coordenado). Exemplo Converter 129876402529842245 em um valor datetimezone. Usage Power Query M DateTimeZone.FromFileTime(129876402529842245) Saída #datetimezone(2012, 7, 24, 14, 50, 52.9842245, -7, 0) Last updated on 25/03/2026

Cria um valor datetimezone com base em uma representação textual, text . Um parâmetro de record opcional, options , pode ser fornecido para especificar propriedades adicionais. O record pode conter os seguintes campos: Format : um valor text que indica o formato a ser usado. Para obter mais detalhes, vá para cadeias de caracteres de formato de data e hora padrão e cadeias de caracteres de formato de data e hora personalizadas. Omitir esse campo ou fornecer null resultará na análise da data usando um melhor esforço. Culture : quando Format não é nulo, Culture controla alguns especificadores de formato. Por exemplo, em "en-US" "MMM" é "Jan", "Feb", "Mar", ... , enquanto em "ru-RU" "MMM" é "янв", "фев", "мар", ... . Quando Format é null , Culture controla o formato padrão a ser usado. Quando Culture é null ou omitido, Culture.Current é usado. Para dar suporte a fluxos de trabalho herdados, options também podem ser um valor de texto. Isso tem o mesmo comportamento que options = [Format = null, Culture = options] .

Retorna um datetimezone valor definido como a data e a hora atuais no sistema. O valor retornado contém informações de fuso horário que representam o fuso horário local. Conteúdo relacionado Variantes locais, fixas e UTC das funções de tempo atuais

Retorna um #datetime valor com informações de dateTimeZone fuso horário removidas.

Altera as informações de fuso horário para o valor dateTimeZone de datetimezone para as novas informações de fuso horário fornecidas por timezoneHours e opcionalmente timezoneMinutes . Se dateTimeZone não tiver um componente de fuso horário, um erro será gerado.

Altera as informações de fuso horário do valor dateTimeZone de 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 Altere as informações de fuso horário para #datetimezone(2010, 12, 31, 11, 56, 02, 7, 30) o fuso horário local (supondo que PST). Usage Power Query M DateTimeZone.ToLocal(#datetimezone(2010, 12, 31, 11, 56, 02, 7, 30)) Saída #datetimezone(2010, 12, 31, 12, 26, 2, -8, 0) Last updated on 30/06/2026

Retorna um registro que contém as partes do valor de datetimezone fornecido. dateTimeZone dateTimeZone : um datetimezone valor para o qual o registro de suas partes deve ser calculado.

Retorna uma representação textual de dateTimeZone . Um parâmetro de record opcional, options , pode ser fornecido para especificar propriedades adicionais. culture é usado apenas para fluxos de trabalho herdados. O record pode conter os seguintes campos: Format : um valor text que indica o formato a ser usado. Para obter mais detalhes, acesse * Cadeias de caracteres de formato de data e hora padrão e cadeias de caracteres de formato de data e hora personalizadas. Omitir esse campo ou fornecer null resultará na formatação da data usando o padrão definido por Culture . Culture : quando Format não é nulo, Culture controla alguns especificadores de formato. Por exemplo, em "en-US" "MMM" é "Jan", "Feb", "Mar", ... , enquanto em "ru-RU" "MMM" é "янв", "фев", "мар", ... . Quando Format é null , Culture controla o formato padrão a ser usado. Quando Culture é null ou omitido, Culture.Current é usado. Para dar suporte a fluxos de trabalho herdados, options e culture também podem ser valores de texto. Isso tem o mesmo comportamento que options = [Format = options, Culture = culture] .

Altera as informações de fuso horário do valor dateTimeZone de datetime para as informações de fuso horário UTC ou Universal. Se dateTimeZone não tiver um componente de fuso horário, as informações de fuso horário UTC serão adicionadas. Exemplo Altere as informações de fuso horário para #datetimezone(2010, 12, 31, 11, 56, 02, 7, 30) o fuso horário UTC. Usage Power Query M DateTimeZone.ToUtc(#datetimezone(2010, 12, 31, 11, 56, 02, 7, 30)) Saída #datetimezone(2010, 12, 31, 4, 26, 2, 0, 0) Last updated on 30/06/2026

Retorna a data e a hora atuais em UTC (o fuso horário GMT). Exemplo Obtenha a data e a hora atuais em UTC. Uso Power Query M DateTimeZone.UtcNow() Saída #datetimezone(2011, 8, 16, 23, 34, 37.745, 0, 0) Conteúdo relacionado Variantes locais, fixas e UTC das funções de tempo atuais Last updated on 25/03/2026

Retorna o componente de hora de fuso horário de um datetimezone valor. dateTimeZone : Um datetimezone valor do qual o componente de hora de fuso horário é extraído. Se dateTimeZone for null , a função retorna null .

Retorna o componente de minutos de fuso horário de um datetimezone valor. dateTimeZone : um datetimezone valor do qual o componente de minutos de fuso horário é extraído. Se dateTimeZone for null , a função retorna null .

Retorna uma tabela de tabelas SQL e exibições disponíveis em um banco de dados Db2 no servidor server na instância de banco de dados chamada database . A porta pode ser especificada opcionalmente com o servidor, separado por dois-pontos. Um parâmetro de registro opcional, options pode ser especificado para controlar as seguintes opções: CreateNavigationProperties : um lógico (true/false) que define se as propriedades de navegação devem ser geradas nos valores retornados (o padrão é verdadeiro). NavigationPropertyNameGenerator : uma função usada para a criação de nomes para 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 por quanto tempo a consulta do lado do servidor tem permissão para ser executada antes de ser cancelada. O valor padrão é dez minutos. ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de fazer uma conexão com o servidor. O valor padrão depende do driver. HierarchicalNavigation : um lógico (true/false) que define se as tabelas agrupadas por seus nomes de esquema (o padrão é falso). Implementation : especifica a implementação interna do provedor de banco de dados a ser usada. Os valores válidos são: "IBM" e "Microsoft". BinaryCodePage : um número para o CCSID (Identificador de Conjunto de Caracteres Codificado) 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 de banco de dados. Defina outro número 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 = "Micros

Retorna um valor Decimal number do determinado value . Se o dado value for null , Decimal.From retornará null . Se o dado value estiver number dentro do intervalo de Decimal, value será retornado, caso contrário, um erro será retornado. Se value for de qualquer outro tipo, ele será convertido primeiro em um number uso Number.FromText. Um opcional culture também pode ser fornecido (por exemplo, "en-US").

Dada uma tabela Delta Lake, retorna as entradas de log para essa tabela. Last updated on 22/11/2025

Retorna o conteúdo da tabela Delta Lake. Last updated on 16/09/2025

Retorna um identificador opaco para a avaliação em execução no momento. Last updated on 22/11/2025

Retorna um identificador opaco para correlacionar solicitações de entrada com as de saída. Last updated on 16/09/2025

Grava um rastreamento message , se o rastreamento estiver habilitado e retornar value . Um parâmetro delayed opcional especifica se a avaliação deve value ser adiada até que a mensagem seja rastreada. traceLevel pode usar um dos seguintes valores: TraceLevel.Critical TraceLevel.Error TraceLevel.Warning TraceLevel.Information TraceLevel.Verbose

Essa função destina-se apenas ao uso interno. Last updated on 22/11/2025

Retorna um valor duplo number do determinado value . Se o dado value for null , Double.From retornará null . Se o dado value estiver number dentro do intervalo de Double, value será retornado, caso contrário, um erro será retornado. Se value for de qualquer outro tipo, ele será convertido primeiro em um number uso Number.FromText. Um opcional culture também pode ser fornecido (por exemplo, "en-US").

Retorna a parte de dias de duration .

Retorna o valor de duração do valor fornecido. value : o valor do qual a duração é derivada. Se o dado value for null , essa função retornará null . Se o determinado value for um duration , value será retornado. Os valores dos seguintes tipos podem ser convertidos em um duration valor: text : um duration valor dos formulários de tempo decorridos textuais (d.h:m:s). Consulte Duration.FromText para obter detalhes. number : equivalente duration ao número de dias inteiros e fracionários expressos por value . Se value for de qualquer outro tipo, um erro será retornado.

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.

Retorna a parte de horas de duration . Exemplo Extraia as horas de um valor de duração. Usage Power Query M Duration.Hours(#duration(5, 4, 3, 2)) Saída 4 Last updated on 25/03/2026

Retorna a parte de minutos de duration . Exemplo Extraia os minutos de um valor de duração. Usage Power Query M Duration.Minutes(#duration(5, 4, 3, 2)) Saída 3 Last updated on 25/03/2026

Retorna a parte de segundos de duration . Exemplo Extraia os segundos de um valor de duração. Usage Power Query M Duration.Seconds(#duration(5, 4, 3, 2)) Saída 2 Last updated on 25/03/2026

Retorna um registro que contém as partes do valor de duração. duration duration : A duration do qual o registro é criado.

Retorna o total de dias estendidos por duration .

Retorna o total de horas estendidas por duration . Exemplo Localize as horas totais estendidas por um valor de duração. Usage Power Query M Duration.TotalHours(#duration(5, 4, 3, 2)) Saída 124.05055555555555 Last updated on 25/03/2026

Retorna o total de minutos estendidos por duration .

Retorna o total de segundos estendidos por duration .

Retorna uma representação textual no formato "day.hour:mins:sec" do valor de duração fornecido. duration duration : A duration da qual a representação textual é calculada. format : (Opcional) Preterido, gerará um erro se não for nulo. Exemplo Converter #duration(2, 5, 55, 20) em um valor de texto. Usage Power Query M Duration.ToText(#duration(2, 5, 55, 20)) Saída "2.05:55:20" Last updated on 04/04/2026 #duration Sintaxe #duration( days as number, hours as number, minutes as number, seconds as number ) as duration Sobre Cria um valor de duração de números que representam dias, horas, minutos e segundos (fracionários). Last updated on 22/11/2025 Funções de tratamento de erro Artigo • 22/07/2024 Essas funções podem ser usadas para rastrear ou construir erros. ﾉ Expandir a tabela Nome Descrição Diagnostics.ActivityId Retorna um identificador opaco para a avaliação atualmente em execução. Diagnostics.CorrelationId Retorna um identificador opaco para correlacionar solicitações de entrada com as de saída. Diagnostics.Trace Grava uma entrada de rastreamento se o rastreamento está habilitado e retorna o valor. Error.Record Retorna um registro de erro dos valores de texto fornecidos para motivo, mensagem, detalhe e código de erro. Comentários Esta página foi útil?  Yes  No Fornecer comentários sobre o produto | Pergunte à comunidade

Essa função destina-se apenas ao uso interno. Last updated on 04/04/2026

Retorna um registro de erro dos valores de texto fornecidos para motivo, mensagem, detalhe e código de erro. reason : a causa de alto nível do erro. message : (Opcional) Uma descrição do erro. detail : (Opcional) Informações detalhadas adicionais sobre o erro. parameters : (Opcional) Uma lista de valores que fornecem contexto adicional para o erro, normalmente usado para diagnóstico ou tratamento programático. errorCode : (Opcional) Um identificador para o erro.

Retorna uma tabela de cubos agrupados pelo servidor Essbase de uma instância do Essbase no servidor url APS. Um parâmetro de registro opcional, options pode ser especificado para controlar as seguintes opções: CommandTimeout : uma duração que controla por quanto tempo a consulta do lado do servidor tem permissão para ser executada antes de ser cancelada. O valor padrão é dez minutos. Last updated on 22/11/2025

Retorna o conteúdo da pasta de trabalho atual do Excel. Ele retorna tabelas, intervalos nomeados e matrizes dinâmicas. Diferentemente Excel.Workbookdisso, ele não retorna planilhas. Last updated on 22/11/2025

Essa função destina-se apenas ao uso interno. Last updated on 22/11/2025

Retorna o conteúdo da pasta de trabalho do Excel. useHeaders pode ser nulo, um valor lógico (true/false) que indica se a primeira linha de cada tabela retornada deve ser tratada como um cabeçalho ou um registro de opções. Padrão: false. delayTypes pode ser nulo ou um valor lógico (true/false) que indica se as colunas de cada tabela retornada devem ser deixadas sem tipo. Padrão: false. Se um registro for especificado para useHeaders (e delayTypes for nulo), os seguintes campos de registro poderão ser fornecidos: UseHeaders : pode ser nulo ou um valor lógico (true/false) que indica se a primeira linha de cada tabela retornada deve ser tratada como um cabeçalho. Padrão: false. DelayTypes : pode ser nulo ou um valor lógico (true/false) que indica se as colunas de cada tabela retornada devem ser deixadas sem tipo. Padrão: false. InferSheetDimensions : pode ser nulo ou um valor lógico (true/false) que indica se a área de uma planilha que contém dados deve ser inferida lendo a própria planilha, em vez de ler os metadados de dimensões do arquivo. Isso pode ser útil em casos em que os metadados de dimensões estão incorretos. Observe que essa opção só tem suporte para arquivos open XML do Excel, não para arquivos herdados do Excel. Padrão: false. ７ Observação O useHeaders parâmetro ou o campo de UseHeaders registro converte números e datas em texto usando a cultura atual e, portanto, se comporta de forma diferente quando executado em ambientes com diferentes culturas do sistema operacional definidas. Em vez disso, é recomendável o uso de Table.PromoteHeaders. Por exemplo, em vez de usar Excel.Workbook(File.Contents("C:\myfile.xlsx", true, true)) ou Excel.Workbook(File.Contents("C:\myfile.xlsx", [UseHeaders = true], null)) usar, use Table.PromoteHeaders(Excel.Workbook(File.Contents("C:\myfile.xlsx", null, true), [PromoteAllScalars = true])) em vez disso.

Retorna um sumário da conta mailboxAddress do Microsoft Exchange. Se mailboxAddress não for especificado, a conta padrão da credencial será usada. Last updated on 22/11/2025

Retorna a representação do código-fonte M de um valor constante.

Retorna o resultado da avaliação de uma expressão document M, com os identificadores disponíveis que podem ser referenciados definidos por environment .

Retorna a representação do código-fonte M de um identificador name .

Retorna o resultado de passar o input especificado para um modelo de IA. Um valor opcional context pode ser fornecido para especificar dados adicionais relevantes para a solicitação.

Retorna o conteúdo do arquivo, path como binário. Atualmente options , o parâmetro destinase apenas ao uso interno. Last updated on 22/11/2025

Retorna uma tabela que contém uma linha para cada pasta e arquivo encontrado na pasta path . Cada linha contém as propriedades da pasta ou do arquivo e um link para seu conteúdo. Atualmente options , o parâmetro destina-se apenas ao uso interno. Last updated on 22/11/2025

Retorna uma tabela que contém uma linha para cada arquivo encontrado na pasta especificada e todas as suas subpastas. path : o caminho para a pasta da qual você deseja recuperar os arquivos. O caminho da pasta fornecido deve ser um caminho absoluto válido. options : (Opcional) Este parâmetro destina-se apenas ao uso interno. Cada linha da tabela retornada contém propriedades do arquivo e um link para seu conteúdo. Exemplo Retorne uma tabela que contém todos os arquivos encontrados em C:\test-examples\examplefolder e todas as suas subpastas. Usage Power Query M Folder.Files("C:\test-examples\example-folder") Saída A table containing the files, their properties, and a link to their content. Last updated on 04/04/2026

Usa uma função function unária e cria uma nova função com o tipo functionType que constrói uma lista com seus argumentos e a passa para function .

Invoca a função fornecida usando a lista especificada de argumentos e retorna o resultado. Exemplo Record.FieldNames Invoca com um argumento [A=1,B=2]. Usage Power Query M Function.Invoke(Record.FieldNames, {[A = 1, B = 2]}) Saída {"A", "B"} Last updated on 04/04/2026

Retorna o resultado da invocação function após a duração delay ter passado. Last updated on 22/11/2025

Essa função destina-se apenas ao uso interno. Last updated on 22/11/2025

Retorna se é ou não function considerada uma fonte de dados. Last updated on 22/11/2025

Retorna uma função escalar do tipo scalarFunctionType que invoca vectorFunction com uma única linha de argumentos e retorna sua única saída. Além disso, quando a função escalar é aplicada repetidamente para cada linha de uma tabela de entradas, como em Table.AddColumn, em vez disso vectorFunction , será aplicada uma vez para todas as entradas. vectorFunction será passada uma tabela cujas colunas correspondem em nome e posição aos parâmetros de scalarFunctionType . Cada linha desta tabela contém os argumentos de uma chamada para a função escalar, com as colunas correspondentes aos parâmetros de scalarFunctionType . vectorFunction deve retornar uma lista do mesmo comprimento que a tabela de entrada, cujo item em cada posição deve ser o mesmo resultado da avaliação da função escalar na linha de entrada da mesma posição. Espera-se que a tabela de entrada seja transmitida, portanto vectorFunction deve transmitir sua saída conforme a entrada é recebida, processando apenas um pedaço de cada vez. Em particular, vectorFunction não deve enumerar sua tabela de entrada mais de uma vez.

Converte o texto que representa um valor geográfico no formato WKT (Well-Known Text) em um registro estruturado. WKT é um formato padrão definido pelo OGC (Open Geospatial Consortium) e é o formato de serialização típico usado por bancos de dados, incluindo o SQL Server. Last updated on 22/11/2025

Converte um valor de ponto geográfico estruturado em sua representação WKT (Well-Known Text), conforme definido pelo OGC (Open Geospatial Consortium), também o formato de serialização usado por muitos bancos de dados, incluindo o SQL Server. Last updated on 22/11/2025

Cria um registro que representa um ponto geográfico de suas partes constituintes, como longitude, latitude e, se presente, elevação (Z) e medida (M). Um SRID (identificador de referência espacial) opcional pode ser fornecido se diferente do valor padrão (4326). Last updated on 22/11/2025

Converte o texto que representa um valor geométrico no formato WKT (Well-Known Text) em um registro estruturado. WKT é um formato padrão definido pelo OGC (Open Geospatial Consortium) e é o formato de serialização típico usado por bancos de dados, incluindo o SQL Server. Last updated on 22/11/2025

Converte um valor de ponto geométrico estruturado em sua representação WKT (Well-Known Text), conforme definido pelo OGC (Open Geospatial Consortium), também o formato de serialização usado por muitos bancos de dados, incluindo o SQL Server. Last updated on 22/11/2025

Cria um registro que representa um ponto geométrico de suas partes constituintes, como coordenada X, coordenada Y e, se presente, coordenada Z e medida (M). Um SRID (identificador de referência espacial) opcional pode ser fornecido se diferente do valor padrão (0). Last updated on 22/11/2025

Retorna contas do Google Analytics acessíveis da credencial atual. Last updated on 22/11/2025

Essa função destina-se apenas ao uso interno. Last updated on 22/11/2025

Retorna um Guid.Type valor do determinado value . Se o dado value for null , Guid.From retornará null . Uma verificação será executada para determinar se o determinado value está em um formato aceitável. Formatos aceitáveis fornecidos nos exemplos.

Retorna uma tabela que contém uma linha para cada pasta e arquivo encontrado na URL da pasta, url de um sistema de arquivos Hadoop. Cada linha contém as propriedades da pasta ou do arquivo e um link para seu conteúdo. Last updated on 22/11/2025

Retorna uma tabela que contém uma linha para cada arquivo encontrado na URL url da pasta e subpastas de um sistema de arquivos Hadoop. Cada linha contém propriedades do arquivo e um link para o conteúdo. Last updated on 22/11/2025

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. Last updated on 16/09/2025

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. Last updated on 16/09/2025

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. Last updated on 22/11/2025

Retorna uma tabela que contém os resultados da execução dos seletores CSS especificados em relação ao fornecido html . Um parâmetro de registro opcional, options pode ser fornecido para especificar propriedades adicionais. O registro pode conter os seguintes campos: RowSelector

Cria uma identidade. Last updated on 16/09/2025

Determina se uma identidade é um membro de uma coleção de identidades. Last updated on 16/09/2025

O provedor de identidade padrão do host atual. Last updated on 16/09/2025

Retorna uma tabela de tabelas SQL e exibições disponíveis em um banco de dados Informix no servidor server na instância de banco de dados chamada database . A porta pode ser especificada opcionalmente com o servidor, separado por dois-pontos. Um parâmetro de registro opcional, options pode ser especificado para controlar as seguintes opções: CreateNavigationProperties : um lógico (true/false) que define se as propriedades de navegação devem ser geradas nos valores retornados (o padrão é verdadeiro). NavigationPropertyNameGenerator : uma função usada para a criação de nomes para 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 por quanto tempo a consulta do lado do servidor tem permissão para ser executada antes de ser cancelada. O valor padrão é dez minutos. ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de fazer uma conexão com o servidor. O valor padrão depende do driver. HierarchicalNavigation : um lógico (true/false) que define se as tabelas agrupadas por seus nomes de esquema (o padrão é falso). O parâmetro de registro é especificado como [option1 = value1, option2 = value2...] ou [Query = "select ..."] por exemplo. Last updated on 22/11/2025

Retorna um valor inteiro de 16 bits number do determinado value . Se o dado value for null , Int16.From retornará null . Se o determinado value estiver number dentro do intervalo de 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 é RoundingMode.ToEven. Se value for de qualquer outro tipo, ele será convertido primeiro em um number uso Number.FromText. Number.Round Consulte os modos de arredondamento disponíveis. Um opcional culture também pode ser fornecido (por exemplo, "en-US").

Retorna um valor inteiro de 32 bits number do determinado value . Se o dado value for null , Int32.From retornará null . Se o determinado value estiver number dentro do intervalo de 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 é RoundingMode.ToEven. Se value for de qualquer outro tipo, ele será convertido primeiro em um number uso Number.FromText. Number.Round Consulte os modos de arredondamento disponíveis. Um opcional culture também pode ser fornecido (por exemplo, "en-US").

Retorna um valor inteiro de 64 bits number do determinado value . Se o dado value for null , Int64.From retornará null . Se o determinado value estiver number dentro do intervalo de 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 é RoundingMode.ToEven. Se value for de qualquer outro tipo, ele será convertido primeiro em um number uso Number.FromText. Number.Round Consulte os modos de arredondamento disponíveis. Um opcional culture também pode ser fornecido (por exemplo, "en-US").

Retorna um valor inteiro de 8 bits number assinado do determinado value . Se o dado value for null , Int8.From retornará null . Se o dado value estiver number dentro do intervalo de inteiro de 8 bits assinado 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 é RoundingMode.ToEven. Se value for de qualquer outro tipo, ele será convertido primeiro em um number uso Number.FromText. Number.Round Consulte os modos de arredondamento disponíveis. Um opcional culture também pode ser fornecido (por exemplo, "en-US").

Retorna a árvore de sintaxe abstrata (AST) para o corpo de function , normalizada 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 ItemExpression.Itempor . O AST será simplificado para conter apenas nós dos tipos: Constant Invocation Unary Binary If FieldAccess Um erro será gerado se uma expressão de item AST não puder ser retornada para o corpo de function . Essa função é idêntica a RowExpression.From.

Retorna o conteúdo do documento JSON. jsonText : o conteúdo do documento JSON. O valor desse parâmetro pode ser texto ou um valor binário retornado por uma função como File.Contents. encoding : um TextEncoding.Type que especifica a codificação usada no documento JSON. Se encoding for omitido, UTF8 é usado.

Produz uma representação JSON de um determinado valor 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, de texto e lógicos 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 nulos 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, datetimes, datetimezones e durações são representados como texto ISO8601 Os valores binários são representados como texto codificado em base 64 Tipos e funções produzem um erro

Converte um valor binário em uma lista de valores de texto divididos em quebras de linha. binary : O valor binário a ser convertido na lista. quoteStyle : Especifica como as quebras de linha são tratadas. O valor de quoteStyle pode ser null . O valor padrão é QuoteStyle.None. includeLineSeparators : Especifica se os caracteres de quebra de linha devem ser incluídos no texto. O valor de includeLineSeparators pode ser null . O valor padrão é false . encoding : Especifica a codificação de texto do valor binário. O valor de encoding pode ser null . O valor padrão é 65001 (UTF-8). Se um registro for especificado para quoteStyle (e includeLineSeparators e encoding are null ), os seguintes campos de registro poderão ser fornecidos: QuoteStyle : especifica como as quebras de linha entre aspas são manipuladas. QuoteStyle.Csv: as quebras de linha entre aspas são tratadas como parte dos dados, não como o final da linha atual. QuoteStyle.None: todas as quebras de linha são tratadas como o final da linha atual, mesmo quando ocorrem dentro de um valor entre aspas. Esse valor será o padrão se a CsvStyle opção não for especificada. CsvStyle : especifica como as aspas são manipuladas. Não deve ser usado com QuoteStyle.None. CsvStyle.QuoteAfterDelimiter: as aspas em um campo só são significativas imediatamente após o Delimiter . CsvStyle.QuoteAlways: as aspas em um campo são sempre significativas, independentemente de onde elas aparecem. Delimiter : Um único delimitador de caracteres. Deve ser usado apenas com CsvStyle.QuoteAfterDelimiter. IncludeLineSeparators : Especifica se os caracteres de quebra de linha devem ser incluídos no texto. O valor padrão é false . Encoding : A codificação de texto do valor binário. O valor padrão é 65001 (UTF-8). Last updated on 02/04/2026

Converte um valor de texto em uma lista de valores de texto divididos em quebras de linha. text : O valor de texto a ser convertido na lista de valores de texto. quoteStyle : Especifica como as quebras de linha são tratadas. O valor de quoteStyle pode ser null . O valor padrão é QuoteStyle.None. includeLineSeparators : Especifica se os caracteres de quebra de linha devem ser incluídos no texto. O valor de includeLineSeparators pode ser null . O valor padrão é false . Se um registro for especificado para quoteStyle (e includeLineSeparators for null ), os seguintes campos de registro poderão ser fornecidos: QuoteStyle : especifica como as quebras de linha entre aspas são manipuladas. QuoteStyle.Csv: as quebras de linha entre aspas são tratadas como parte dos dados, não como o final da linha atual. QuoteStyle.None: todas as quebras de linha são tratadas como o final da linha atual, mesmo quando ocorrem dentro de um valor entre aspas. Esse valor será o padrão se a CsvStyle opção não for especificada. CsvStyle : especifica como as aspas são manipuladas. Não deve ser usado com QuoteStyle.None. CsvStyle.QuoteAfterDelimiter: as aspas em um campo só são significativas imediatamente após o Delimiter . CsvStyle.QuoteAlways: as aspas em um campo são sempre significativas, independentemente de onde elas aparecem. Delimiter : Um único delimitador de caracteres. Deve ser usado apenas com CsvStyle.QuoteAfterDelimiter. IncludeLineSeparators : Especifica se os caracteres de quebra de linha devem ser incluídos no texto. O valor padrão é false . Last updated on 02/04/2026

Converte uma lista de texto em um valor binário usando a codificação e o lineSeparator especificados. O lineSeparator especificado é acrescentado a cada linha. Se não for especificado, os caracteres de retorno de carro e alimentação de linha serão usados. Last updated on 22/11/2025

Converte uma lista de texto em um único texto. O lineSeparator especificado é acrescentado a cada linha. Se não for especificado, os caracteres de retorno de carro e alimentação de linha serão usados. Last updated on 22/11/2025 Listar funções 13/08/2025 Essas funções criam e manipulam valores de lista. Informação Nome Descrição List.Count Retorna o número de itens em uma lista. List.IsEmpty Retorna true se a lista estiver vazia. List.NonNullCount Retorna o número de itens não nulos na lista. ﾉ Expandir a tabela ﾉ Expandir a tabela Escolha Nome Descrição List.Alternate Retorna uma lista composta por todos os elementos de deslocamento de número ímpar em uma lista. List.Buffer Armazena uma lista em buffer. List.Distinct Retorna uma lista de valores com duplicatas removidas. List.FindText Retorna uma lista de valores (incluindo campos de registro) que contêm o texto especificado. List.First Retorna o primeiro valor da lista ou o padrão especificado se vazio. List.FirstN Retorna o primeiro conjunto de itens na lista especificando quantos itens devem ser retornados ou uma condição de qualificação. List.InsertRange Insere valores em uma lista no índice fornecido. List.IsDistinct Indica se há duplicatas na lista. List.Last Retorna o último valor da lista ou o padrão especificado se vazio. List.LastN Retorna o último valor na lista. Opcionalmente, é possível especificar quantos valores retornar ou uma condição de qualificação. Nome Descrição List.MatchesAll Retorna true se a função de condição for atendida por todos os valores na lista. List.MatchesAny Retorna true se a função de condição for atendida por qualquer valor. List.Positions Retorna uma lista de deslocamentos para a entrada. List.Range Retorna um subconjunto da lista começando em um deslocamento. List.Select Retorna uma lista de valores que correspondem à condição. List.Single Retorna o item de uma lista para uma lista de comprimento um, caso contrário, gera uma exceção. List.SingleOrDefault Retorna o único item d

Acumula um valor de resumo dos itens na lista especificada usando o acumulador. list : a lista a ser iterada. seed : um valor acumulado inicial. accumulator : uma função que usa o estado atual e o item atual e retorna o novo estado.

Retornará true se todas as expressões na lista list forem verdadeiras.

Retorna uma lista composta por todos os elementos de deslocamento de número ímpar em uma lista. Alterna entre tirar e ignorar valores da lista list , dependendo dos parâmetros. count : especifica o número de valores que são ignorados 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 de opção para começar a ignorar os valores no deslocamento inicial.

Retornará true se qualquer expressão na lista list for verdadeira.

Retorna o valor médio dos itens na lista. list O resultado é fornecido no mesmo tipo de dados que os valores na lista. Só funciona com valores de número, data, hora, datetime, datetimezone e duração. Se a lista estiver vazia, será retornado nulo.

Armazena em buffer a lista list na memória. O resultado dessa chamada é uma lista estável.

Usa uma lista de listas lists e as mescla em uma única nova lista.

Essa função destina-se apenas ao uso interno. Last updated on 22/11/2025

Indica se a lista contém o valor especificado. Retorna true se o valor for encontrado na lista, false caso contrário. list : a lista a ser pesquisada. value : o valor a ser pesquisado na lista. equationCriteria : (Opcional) O comparador usado para determinar se os dois valores são iguais.

Indica se a lista inclui todos os valores de outra lista. Retorna true se todos os valores forem encontrados na lista, false caso contrário. list : a lista a ser pesquisada. values : a lista de valores a serem pesquisados na primeira lista. equationCriteria : (Opcional) O comparador usado para determinar se os dois valores são iguais.

Indica se a lista contém qualquer um dos valores de outra lista. Retorna true se os valores forem encontrados na lista, false caso contrário. list : a lista a ser pesquisada. values : a lista de valores a serem pesquisados na primeira lista. equationCriteria : (Opcional) O comparador usado para determinar se os dois valores são iguais.

Retorna o número de itens na lista especificada. list : A lista que será examinada.

Retorna a covariância entre duas listas numberList1 e numberList2 . numberList1 e numberList2 deve conter o mesmo número de number valores.

Retorna uma lista de date valores de tamanho count , começando em start . O incremento step fornecido é um valor duration que é adicionado a cada valor. Exemplo Crie uma lista de 5 valores a partir de Véspera de Ano Novo ( #date(2011, 12, 31) ) incrementando em 1 dia ( #duration(1, 0, 0, 0) ). Uso Power Query M List.Dates(#date(2011, 12, 31), 5, #duration(1, 0, 0, 0)) Saída Power Query M { #date(2011, 12, 31), #date(2012, 1, 1), #date(2012, 1, 2), #date(2012, 1, 3), #date(2012, 1, 4) } Conteúdo relacionado #duration Last updated on 30/06/2026

Retorna uma lista de datetime valores de tamanho count , começando em start . O incremento step fornecido é um duration valor que é adicionado a cada valor. Example Crie uma lista de 10 valores a partir de 5 minutos antes do incremento do Dia de Ano Novo ( #datetime(2011, 12, 31, 23, 55, 0) ) em 1 minuto ( #duration(0, 0, 1, 0) ). Usage Power Query M List.DateTimes(#datetime(2011, 12, 31, 23, 55, 0), 10, #duration(0, 0, 1, 0)) Saída Power Query M { #datetime(2011, 12, 31, 23, 55, 0), #datetime(2011, 12, 31, 23, 56, 0), #datetime(2011, 12, 31, 23, 57, 0), #datetime(2011, 12, 31, 23, 58, 0), #datetime(2011, 12, 31, 23, 59, 0), #datetime(2012, 1, 1, 0, 0, 0), #datetime(2012, 1, 1, 0, 1, 0), #datetime(2012, 1, 1, 0, 2, 0), #datetime(2012, 1, 1, 0, 3, 0), #datetime(2012, 1, 1, 0, 4, 0) } Last updated on 30/06/2026

Retorna uma lista de datetimezone valores de tamanho count , começando em start . O incremento step fornecido é um duration valor que é adicionado a cada valor. Exemplo Crie uma lista de 10 valores a partir de 5 minutos antes do incremento do Dia de Ano Novo ( #datetimezone(2011, 12, 31, 23, 55, 0, -8, 0) ) em 1 minuto ( #duration(0, 0, 1, 0) ). Usage Power Query M List.DateTimeZones(#datetimezone(2011, 12, 31, 23, 55, 0, -8, 0), 10, #duration(0, 0, 1, 0)) Saída Power Query M { #datetimezone(2011, 12, 31, 23, 55, 0, -8, 0), #datetimezone(2011, 12, 31, 23, 56, 0, -8, 0), #datetimezone(2011, 12, 31, 23, 57, 0, -8, 0), #datetimezone(2011, 12, 31, 23, 58, 0, -8, 0), #datetimezone(2011, 12, 31, 23, 59, 0, -8, 0), #datetimezone(2012, 1, 1, 0, 0, 0, -8, 0), #datetimezone(2012, 1, 1, 0, 1, 0, -8, 0), #datetimezone(2012, 1, 1, 0, 2, 0, -8, 0), #datetimezone(2012, 1, 1, 0, 3, 0, -8, 0), #datetimezone(2012, 1, 1, 0, 4, 0, -8, 0) } Last updated on 30/06/2026

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.

Retorna uma lista que contém todos os valores na lista especificada com duplicatas removidas. Se a lista especificada estiver vazia, o resultado será uma lista vazia. list : a lista da qual valores distintos são extraídos. equationCriteria : (Opcional) Especifica como a igualdade é determinada ao comparar valores. Esse parâmetro pode ser uma função de seletor de chave, uma função de comparador ou uma lista que contém um seletor de chave e um comparador.

Retorna uma lista de count duration valores, começando em start e incrementado pelo . duration step Exemplo Crie uma lista de 5 valores começando com 1 hora e incrementando em uma hora. Usage Power Query M List.Durations(#duration(0, 1, 0, 0), 5, #duration(0, 1, 0, 0)) Saída Power Query M { #duration(0, 1, 0, 0), #duration(0, 2, 0, 0), #duration(0, 3, 0, 0), #duration(0, 4, 0, 0), #duration(0, 5, 0, 0) } Last updated on 04/04/2026

Retorna uma lista dos valores da lista list que continha o valor text . Exemplo Localize os valores de texto na lista {"a", "b", "ab"} que correspondem a "a". Usage Power Query M List.FindText({"a", "b", "ab"}, "a") Saída {"a", "ab"} Last updated on 25/03/2026

Retorna o primeiro item da lista list ou o valor padrão opcional, defaultValue se a lista estiver vazia. Se a lista estiver vazia e um valor padrão não for especificado, a função retornará null .

Se um número for especificado, até esse número de itens será retornado. Se uma condição for especificada, todos os itens serão retornados que inicialmente atendem à condição. Quando um item falha na condição, nenhum outro item é considerado.

Gera uma lista de valores usando as funções fornecidas. A initial função gera um valor de candidato inicial, que é então testado em relação condition a . Se o valor do candidato for aprovado, ele será retornado como parte da lista resultante e o próximo valor do candidato será gerado passando o valor recém-aprovado para next . Depois que um valor candidato não corresponder condition , o processo de geração de lista será interrompido. Um parâmetro opcional também selector pode ser fornecido para transformar os itens na lista resultante.

Retorna uma nova lista produzida inserindo os valores em values list . index A primeira posição na lista está 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 está no índice 0. values : a lista de valores que devem ser inseridos em list .

Retorna a interseção dos valores de lista encontrados na lista de entrada lists . Um parâmetro opcional, equationCriteria , pode ser especificado.

Retorna um valor lógico se há duplicatas na lista list ; true se a lista é distinta; false se há valores duplicados.

Retorna true se a lista não list contiver valores (comprimento 0). Se a lista contiver valores (comprimento > 0), retornará false .

Retorna o último item na lista especificada ou o valor padrão opcional se a lista estiver vazia. list : A lista que será examinada. defaultValue : (Opcional) O valor padrão a ser retornado se a lista estiver vazia. Se a lista estiver vazia e um valor padrão não for especificado, a função retornará null .

Retorna uma lista do último item ou itens na lista especificada. list : A lista que será examinada. Se a lista estiver vazia, uma lista vazia será retornada. countOrCondition : (Opcional) Dá suporte à coleta de vários itens ou à filtragem de itens. Embora esse parâmetro esteja listado como opcional, ocorrerá um erro se esse valor não for fornecido ou for null . Esse parâmetro pode ser especificado de duas maneiras: Se um número for especificado, até esse número de itens será retornado. Se uma condição for especificada, todos os itens serão retornados que atendem à condição, começando no final da lista. Quando um item falha na condição, nenhum outro item é considerado.

Retorna true se a função de condição for atendida por todos os valores na lista, caso contrário, retornará false . list : a lista que contém os valores a serem verificados. condition : a condição para verificar os valores na lista.

Retorna true se a função de condição for atendida por qualquer um dos valores na lista, caso contrário, retornará false . list : a lista que contém os valores a serem verificados. condition : a condição para verificar os valores na lista.

Retorna o item máximo na lista ou o valor padrão opcional se a lista estiver vazia. list : lista de valores. default : (Opcional) O valor a ser retornado se a lista estiver vazia. comparisonCriteria : (Opcional) Uma função que é usada para transformar os valores antes de serem comparados. Se esse parâmetro for null , os valores serão comparados sem nenhuma transformação. includeNulls : (Opcional) Indica se null os valores na lista devem ser incluídos na determinação do item máximo. O valor padrão é true .

Retorna o valor máximo na lista especificada. Depois que as linhas são classificadas, parâmetros opcionais podem ser especificados para filtrar ainda mais o resultado. list : Lista de valores. countOrCondition : especifica o número de valores a serem retornados ou uma condição de filtro. Se um número for especificado, uma lista de até countOrCondition itens em ordem decrescente será retornada. Se uma condição for especificada, a lista retornada incluirá todos os itens que atendem à condição. comparisonCriteria : (Opcional) Uma função que é usada para transformar os valores antes de serem comparados. Se esse parâmetro for null , os valores serão comparados sem nenhuma transformação. includeNulls : (Opcional) Indica se null os valores na lista devem ser incluídos na determinação do item máximo. O valor padrão é true .

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.

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.

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 opcional de comparisonCriteria pode ser especificado para determinar como comparar os itens na lista. Se esse parâmetro for nulo, o comparador padrão será usado.

Retorna o item que aparece com mais frequência em 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 critério de comparação opcional, equationCriteria , pode ser especificado para controlar o teste de igualdade.

Retorna os itens que aparecem com mais frequência em list . Se a lista estiver vazia, um erro será gerado. Se vários itens aparecerem com a mesma frequência máxima, todos eles serão retornados. Um valor de critério de comparação opcional, equationCriteria , pode ser especificado para controlar o teste de igualdade.

Retorna o número de itens não nulos na lista list . Last updated on 22/11/2025

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 pelo qual incrementar. Se os valores omitidos forem incrementados em 1.

Retorna um ou mais percentis de exemplo da lista list . Se o valor percentiles for um número entre 0,0 e 1,0, ele será tratado como um percentil e o resultado será um único valor correspondente a essa probabilidade. Se o valor percentiles for uma lista de números com valores entre 0,0 e 1,0, o resultado será uma lista de percentis correspondentes à probabilidade de entrada. A opção PercentileMode pode options ser usada por usuários avançados para escolher um método de interpolação mais específico, mas não é recomendada para a maioria dos usos. Símbolos PercentileMode.ExcelInc predefinidos e PercentileMode.ExcelExc correspondem aos métodos de interpolação usados PERCENTILE.INC pelas funções do Excel e PERCENTILE.EXC . O comportamento padrão corresponde PercentileMode.ExcelInc. Os símbolos PercentileMode.SqlCont e PercentileMode.SqlDisc correspondem ao comportamento do SQL Server para PERCENTILE_CONT e PERCENTILE_DISC , respectivamente.

Retorna o deslocamento no qual o valor especificado aparece em uma lista. Retornará -1 se o valor não for exibido. list : a lista a ser pesquisada. value : o valor a ser encontrado na lista. occurrence : (Opcional) A ocorrência específica a ser reportado. Esse valor pode ser Occurrence.First, Occurrence.Last ou Occurrence.All. Se não occurrence for especificado, Occurrence.First será usado. equationCriteria : (Opcional) Especifica como a igualdade é determinada ao comparar valores. Esse parâmetro pode ser uma função de seletor de chave, uma função de comparador ou uma lista que contém um seletor de chave e um comparador.

Retorna o deslocamento no qual um item da lista de valores especificada aparece em uma lista. Retornará -1 se nenhuma ocorrência for encontrada. list : a lista a ser pesquisada. values : a lista de valores a serem encontrados na lista original. occurrence : (Opcional) A ocorrência específica a ser reportado. Esse valor pode ser Occurrence.First, Occurrence.Last ou Occurrence.All. Se não occurrence for especificado, Occurrence.First será usado. equationCriteria : (Opcional) Especifica como a igualdade é determinada ao comparar valores. Esse parâmetro pode ser uma função de seletor de chave, uma função de comparador ou uma lista que contém um seletor de chave e um comparador.

Retorna uma lista de índices para a lista de entrada especificada. list : a lista de entrada. Ao usar List.Transform para alterar uma lista, a lista de posições pode ser usada para permitir que a transformação acesse a posição.

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 Localize o produto dos números na lista {1, 2, 3, 3, 4, 5, 5} . Usage Power Query M List.Product({1, 2, 3, 3, 4, 5, 5}) Saída 1800 Last updated on 25/03/2026

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úmero aleatório. Se uma lista exclusiva de números aleatórios for gerada sempre que você chamar a função. Se você especificar o valor da semente com um número cada chamada para a função gerará a mesma lista de números aleatórios.

Retorna um subconjunto de list começando em offset . Um parâmetro opcional, count , define o número máximo de itens no subconjunto.

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 countOrCondition opcional para dar suporte à remoção de vários valores, conforme listado abaixo. Se um número for especificado, até que muitos itens sejam removidos. Se uma condição for especificada, todos os itens correspondentes consecutivos no início serão list removidos. Se esse parâmetro for nulo, o comportamento padrão será observado.

Remove todas as ocorrências dos valores fornecidos em list2 . list1 Se os valores em list2 não existirem list1 , a lista original será retornada.

Retorna uma lista que remove os últimos countOrCondition elementos 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 muitos itens sejam removidos. Se uma condição for especificada, todos os itens correspondentes consecutivos no final serão list removidos. Se esse parâmetro for nulo, apenas um item será removido.

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 Crie uma lista em {1, 2, 3, 4, 5, 5} sem {1, 5}. Usage Power Query M List.RemoveMatchingItems({1, 2, 3, 4, 5, 5}, {1, 5}) Saída {2, 3, 4} Conteúdo relacionado Critérios de equação Last updated on 25/03/2026

Remove todas as ocorrências de valores "nulos" no list . Se não houver valores 'nulos' na lista, a lista original será retornada.

Remove valores count na list inicialização na posição especificada. index

Retorna uma lista que é count repetições da lista original. list Exemplo Crie uma lista que tenha {1, 2} repetido 3 vezes. Usage Power Query M List.Repeat({1, 2}, 3) Saída {1, 2, 1, 2, 1, 2} Last updated on 25/03/2026

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.

count Substitui os valores na list lista replaceWith , começando na posição especificada. index

Pesquisa uma lista de valores, list o valor oldValue e substitui cada ocorrência pelo valor newValue de substituição.

Retorna uma lista com os valores na lista list em ordem invertida.

Retorna os valores da lista especificada que correspondem à condição de seleção. list : A lista que será examinada. selection : a função que determina os valores a serem selecionados.

Se houver apenas um item na lista list , retornará esse item. Se houver mais de um item ou se a lista estiver vazia, a função gerará um erro.

Se houver apenas um item na lista list , retornará esse item. Se a lista estiver vazia, a função retornará nulo, a menos que um opcional default seja especificado. Se houver mais de um item na lista, a função retornará um erro.

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 countOrCondition opcional para dar suporte a ignorar vários valores, conforme listado abaixo. Se um número for especificado, até que muitos itens sejam ignorados. Se uma condição for especificada, todos os itens correspondentes consecutivos no início serão list ignorados. Se esse parâmetro for nulo, o comportamento padrão será observado.

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. Isso pode levar os seguintes valores: Para controlar a ordem, o critério de comparação pode ser um valor de enumeração Order. (Order.Descending, Order.Ascending). Para calcular uma chave a ser usada para classificação, uma função de um argumento pode ser usada. Para selecionar uma chave e uma ordem de controle, o critério de comparação pode ser uma lista que contém a chave e a ordem ( {each 1 / _, Order.Descending} ). Para controlar completamente a comparação, uma função de dois argumentos pode ser usada (como Value.Compare). Essa função será passada dois itens da lista (quaisquer dois itens, em qualquer ordem). A função deve retornar um dos seguintes valores: -1 : o primeiro item é menor que o segundo item. 0 : os itens são iguais. 1 : o primeiro item é maior que o segundo item.

Divide-se em uma lista de listas list 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 e assim por diante. Last updated on 22/11/2025

Retorna uma estimativa baseada em exemplo do desvio padrão dos valores na lista. numbersList Se numbersList for uma lista de números, um número será retornado. Um erro é gerado em uma lista vazia ou em uma lista de itens que não são do tipo number . Exemplo Localize o desvio padrão dos números de 1 a 5. Usage Power Query M List.StandardDeviation({1..5}) Output 1.5811388300841898 Last updated on 26/03/2026

Retorna a soma dos valores não nulos na lista. list Retornará nulo se não houver valores não nulos na lista.

Retorna uma lista de time valores de tamanho count , começando em start . O incremento step fornecido é um duration valor que é adicionado a cada valor.

Retorna uma nova lista de valores aplicando a função transform de transformação à lista. list

Retorna uma lista cujos elementos são projetados da lista de entrada. A collectionTransform função transforma cada elemento em uma lista intermediária e a resultTransform função recebe o elemento original, bem como um item da lista intermediária, a fim de construir o resultado final. A collectionTransform função tem a assinatura (x as any) as list => ... , onde x está um elemento em list . A resultTransform função projeta a forma do resultado e tem a assinatura (x as any, y as any) as any => ... , onde x list está um elemento e y é um elemento da lista gerado passando x para collectionTransform . Exemplo Nivele uma lista de pessoas e seus animais de estimação. Usage Power Query M List.TransformMany( { [Name = "Alice", Pets = {"Scruffy", "Sam"}], [Name = "Bob", Pets = {"Walker"}] }, each [Pets], (person, pet) => [Name = person[Name], Pet = pet] ) Saída Power Query M { [Name = "Alice", Pet = "Scruffy"], [Name = "Alice", Pet = "Sam"], [Name = "Bob", Pet = "Walker"] } Last updated on 25/03/2026

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.

Usa uma lista de listas lists e retorna uma lista de listas que combinam itens na mesma posição.

Retorna um logical valor do determinado value . Se o dado value for null , Logical.From retornará null . Se o dado value for logical , value será retornado. Os valores dos seguintes tipos podem ser convertidos em um logical valor: text : um logical valor do valor de texto ou "true" "false" . Consulte Logical.FromText para obter detalhes. number : false se value for igual 0 , true caso contrário. Se value for de qualquer outro tipo, um erro será retornado.

Cria um valor lógico com base no valor text de texto , "true" ou "false". Se text contiver uma cadeia de caracteres diferente, um erro será gerado. O valor text do texto não diferencia maiúsculas de minúsculas.

Cria um valor de texto com base no valor logicalValue lógico ou true false . Se logicalValue não for um valor lógico, um erro será gerado. Exemplo Crie um valor de texto com base no lógico true . Usage Power Query M Logical.ToText(true) Saída "true" Last updated on 25/03/2026 Funções numéricas 15/08/2025 Essas funções criam e manipulam valores numéricos. Informação Nome Descrição Number.IsEven Retorna true se um valor for um número par. Number.IsNaN Retorna true se um valor for Number.NaN. Number.IsOdd Retorna true se um valor for um número ímpar. ﾉ Expandir a tabela ﾉ Expandir a tabela Conversão e formatação Nome Descrição Byte.From Retorna um valor de número inteiro de 8 bits do valor fornecido. Currency.From Retorna um valor de moeda do valor fornecido. Decimal.From Retorna um valor de número decimal do valor fornecido. Double.From Retorna um valor de número duplo do valor fornecido. Int8.From Retorna um valor de número inteiro de 8 bits assinado do valor fornecido. Int16.From Retorna um valor de número inteiro de 16 bits do valor fornecido. Int32.From Retorna um valor de número inteiro de 32 bits do valor fornecido. Int64.From Retorna um valor de número inteiro de 64 bits do valor fornecido. Number.From Retorna um valor numérico de um valor. Number.FromText Retorna um valor numérico de um valor de texto. Number.ToText Converte o número especificado em texto. Percentage.From Retorna um valor percentual do valor fornecido. Nome Descrição Single.From Retorna um valor de número único do valor fornecido. Arredondamento ﾉ Expandir a tabela Nome Descrição Number.Round Retorna um número anulável (n) se o valor for um inteiro. Number.RoundAwayFromZero Retorna Number.RoundUp(valor) quando o valor >= 0 e Number.RoundDown(valor) quando o valor < 0. Number.RoundDown Retorna o maior inteiro menor ou igual a um valor numérico. Number.RoundTowardZero Retorna Number.RoundDown(x) quando x >= 0 e Number.RoundUp(x) quando x < 0. Number.RoundUp Retorna o inteiro maior ou igual a um

Retorna um registro das versões do módulo para o módulo atual e suas dependências. Last updated on 22/11/2025

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 de banco de dados chamada database . A porta pode ser especificada opcionalmente com o servidor, separado por dois- pontos. Um parâmetro de registro opcional, options pode ser especificado para controlar as seguintes opções: Encoding : um valor TextEncoding que especifica o conjunto de caracteres usado para codificar todas as consultas enviadas ao servidor (o padrão é nulo). CreateNavigationProperties : um lógico (true/false) que define se as propriedades de navegação devem ser geradas nos valores retornados (o padrão é verdadeiro). NavigationPropertyNameGenerator : uma função usada para a criação de nomes para 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 por quanto tempo a consulta do lado do servidor tem permissão para ser executada antes de ser cancelada. O valor padrão é dez minutos. ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de fazer uma conexão com o servidor. O valor padrão depende do driver. TreatTinyAsBoolean : uma lógica (true/false) que determina se as colunas minúsculas devem ser forçadas no servidor como valores lógicos. O valor padrão é true. OldGuids : uma lógica (true/false) que define se as colunas char(36) (se false) ou binary(16) (se 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 bancos de dados devem ser retornadas (se false) ou para retornar tabelas e exibições do banco de dados especificado (se verdadeiro). O valor padrão é false. HierarchicalNavigation : um lógico (true/false) que define se as tabelas agrupadas por seus nomes de esquema (o padrão é falso). O parâmetro de reg

Retorna o valor absoluto de number . Se number for nulo, Number.Abs retornará nulo. number : A number para o qual o valor absoluto deve ser calculado.

Retorna a arccosina de number . Last updated on 22/11/2025

Retorna o arco de number . Last updated on 22/11/2025

Retorna o arctangent de number . Last updated on 22/11/2025

Retorna o ângulo, em radianos, cuja tangente é o quociente y / x dos dois números y e x . Last updated on 16/09/2025

Retorna o resultado da execução de uma operação "And" bit a bit entre number1 e number2 . Last updated on 22/11/2025

Retorna o resultado da execução de uma operação "Não" bit a bit em number . Last updated on 22/11/2025

Retorna o resultado da execução de um "Or" bit a bit entre number1 e number2 . Last updated on 22/11/2025

Retorna o resultado da execução de uma mudança bit a bit para a esquerda, number1 pelo número especificado de bits number2 . Last updated on 22/11/2025

Retorna o resultado da execução de uma mudança bit a bit para a direita, number1 pelo número especificado de bits number2 . Last updated on 22/11/2025

Retorna o resultado da execução de um "XOR" bit a bit (Exclusive-OR) entre number1 e number2 . Last updated on 22/11/2025

Retorna o número de combinações exclusivas de uma lista de itens, setSize com tamanho de combinação especificado. combinationSize setSize : o número de itens na lista. combinationSize : o número de itens em cada combinação.

Retorna o cosseno do ângulo especificado. number : um ângulo, medido em radianos.

Retorna o cosseno hiperbólico de number . Last updated on 16/09/2025

Retorna o resultado da elevação e à potência da number (função exponencial). number : A number para o qual a função exponencial deve ser calculada. Se number for nulo, Number.Exp retornará nulo.

Retorna o fatorial do número number . Exemplo Localize o fatorial de 10. Usage Power Query M Number.Factorial(10) Saída 3628800 Last updated on 25/03/2026

Retorna um number valor do determinado value . Um opcional culture também pode ser fornecido (por exemplo, "en-US"). Se o dado value for null , Number.From retornará null . Se o dado value for number , value será retornado. Os valores dos seguintes tipos podem ser convertidos em um number valor: text : um number valor da representação textual. Formatos de texto comuns são tratados ("15", "3.423,10", "5.0E-10"). Consulte Number.FromText 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 à data e hora locais 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.

Retorna um number valor do valor de texto fornecido. text text : a representação textual de um valor numérico. A representação deve estar em um formato de número comum, como "15", "3.423,10" ou "5.0E-10". culture : uma cultura opcional que controla como text é interpretada (por exemplo, "en- US").

Retorna a parte inteiro do resultado da divisão de um número, number1 por outro número. number2 Se number1 ou number2 for nulo, Number.IntegerDivide retornará nulo. number1 : o dividendo. number2 : o divisor.

Indica se o valor, number está mesmo retornando true se estiver par, false caso contrário.

Indica se o valor é NaN (não um número). Retorna true se number for equivalente a Number.NaN , false caso contrário.

Indica se o valor é ímpar. Retorna true se number for um número ímpar, false caso contrário.

Retorna o logaritmo natural de um número. number Se number for nulo Number.Ln , retornará nulo.

Retorna o logaritmo de um número number , para a base especificada base . Se base não for especificado, o valor padrão será Number.E. Se number for nulo Number.Log , retornará nulo.

Retorna o logaritmo base 10 de um número. number Se number for nulo Number.Log10 , retornará nulo. Exemplo Obtenha o logaritmo base 10 de 2. Usage Power Query M Number.Log10(2) Saída 0.3010299956639812 Last updated on 25/03/2026

Retorna o restante resultante da divisão inteira de number por divisor . Se number ou divisor estiver null , essa função retornará null . number : o dividendo. divisor : o divisor. precision : (Opcional) A precisão da divisão de inteiros. Esse parâmetro pode ser Precision.Double para Double precisão ou Precision.Decimal precisão Decimal . O valor padrão é Precision.Double.

Retorna o número de permutações que podem ser geradas de vários itens, setSize com um tamanho de permutação especificado. permutationSize

Retorna o resultado da elevação number ao poder de power . Se number ou power for nulo, Number.Power retornará nulo. number : a base. power : o expoente.

Retorna um número aleatório entre 0 e 1. Exemplo Obtenha um número aleatório. Usage Power Query M Number.Random() Saída 0.919303 Last updated on 25/03/2026

Retorna um número aleatório entre bottom e top .

Retorna o resultado do arredondamento number para o número mais próximo. Se number for nulo, Number.Round retornará nulo. Por padrão, number é arredondado para o inteiro mais próximo e os laços são quebrados arredondando para o número par mais próximo (usando RoundingMode.ToEven, também conhecido como "arredondamento do banqueiro"). No entanto, esses padrões podem ser substituídos por meio dos seguintes parâmetros opcionais. digits : faz number com que seja arredondado para o número especificado de dígitos decimais. roundingMode : substitui o comportamento padrão de quebra de empate quando number está no ponto médio entre dois valores arredondados potenciais (consulte RoundingMode.Type os valores possíveis).

Retorna o resultado do arredondamento 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.

Retorna o resultado do arredondamento number para baixo para o inteiro mais alto anterior. Se number for nulo, essa função retornará nulo. Se digits for fornecido, number será arredondado para o número especificado de dígitos decimais.

Retorna o resultado do arredondamento 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.

Retorna o resultado da arredondamento number para o próximo inteiro mais alto. Se number for nulo, essa função retornará nulo. Se digits for fornecido, number será arredondado para o número especificado de dígitos decimais.

Retorna 1 para se number for um número positivo, -1 se for um número negativo e 0 se for zero. Se number for nulo, Number.Sign retornará nulo.

Retorna o seno de number . Exemplo Localize o seno do ângulo 0. Usage Power Query M Number.Sin(0) Saída 0 Last updated on 25/03/2026

Retorna o seno hiperbólico de number . Last updated on 16/09/2025

Retorna a raiz quadrada de number . Se number for nulo, Number.Sqrt retornará nulo. Se for um valor negativo, Number.NaN será retornado (não um número).

Retorna a tangente de number .

Retorna a tangente hiperbólica de number . Last updated on 16/09/2025

Converte o valor number numérico em um valor de texto de acordo com o formato especificado por format . O formato é um valor de texto que indica como o número deve ser convertido. Para obter mais detalhes sobre os valores de formato com suporte, vá para cadeias de caracteres de formato numérico Standard e cadeias de caracteres de formato numérico personalizado. Um opcional culture também pode ser fornecido (por exemplo, "en-US") para controlar o comportamento dependente da cultura de format .

Retorna uma tabela de feeds OData oferecida por um serviço OData de um uri serviceUri , cabeçalhos headers . Um valor booliano que especifica se deve 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 o escape. 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 fazer 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 é 600 segundos. EnableBatch : um lógico (true/false) que define se a geração de um OData $batch solicitação se o MaxUriLength for excedido (o padrão é false). 'MaxUriLength: um número que indica o comprimento máximo de um uri permitido enviado para um serviço OData. Se excedido e EnableBatch for true, a solicitação será feita em um ponto de extremidade de $batch OData, caso contrário, falhará (o padrão é 2048). Concurrent : uma lógica (true/false) quando definida como true, as solicitações para o serviço serão feitas simultaneamente. Quando definido como false, as solicitações serão feitas sequencialmente. Quando não for 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 sequencialmente. ODataVersion : um número (3 ou 4) que especifica a versão do protocolo OData a ser usada para este serviço OData. Quando não for especificado, todas a

Retorna uma tabela de tabelas SQL e exibições da fonte de dados ODBC especificada pela cadeia de conexão connectionString . connectionString pode ser texto ou um registro de pares de valor de propriedade. Os valores da 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 : um lógico (true/false) que define se as propriedades de navegação devem ser geradas nos valores retornados (o padrão é verdadeiro). HierarchicalNavigation : um lógico (true/false) que define se as tabelas agrupadas por seus nomes de esquema (o padrão é falso). ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de fazer uma conexão com o servidor. O valor padrão é 15 segundos. CommandTimeout : uma duração que controla por quanto tempo a consulta do lado do servidor tem permissão para ser executada antes de ser cancelada. O valor padrão é dez minutos. SqlCompatibleWindowsAuth : uma lógica (true/false) que determina se as opções de cadeia de conexão compatíveis com o SQL Server devem ser produzidas para autenticação do Windows. O valor padrão é true. TableTypes Exemplo Retorne as tabelas e exibições sql da cadeia de conexão fornecida. Usage Power Query M Odbc.DataSource("dsn=your_dsn") Saída table Last updated on 29/06/2026

Retorna o resultado da tentativa de inferir as capbabilidades do SQL com a cadeia de connectionString conexão usando ODBC. connectionString pode ser texto ou um registro de pares de valor de propriedade. Os valores da propriedade podem ser texto ou número. Exemplo Retorne os recursos de SQL inferidos para uma cadeia de conexão. Usage Power Query M Odbc.InferOptions("dsn=your_dsn") Saída record Last updated on 03/04/2026

Retorna o resultado da execução query com a cadeia de conexão connectionString usando ODBC. connectionString pode ser texto ou um registro de pares de valor de propriedade. Os valores da 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 uma conexão com o servidor. O valor padrão é 15 segundos. CommandTimeout : uma duração que controla por quanto tempo a consulta do lado do servidor tem permissão para ser executada antes de ser cancelada. O valor padrão é dez minutos. SqlCompatibleWindowsAuth : uma lógica (true/false) que determina se as opções de cadeia de conexão compatíveis com o SQL Server devem ser produzidas para autenticação do Windows. O valor padrão é true.

Retorna uma tabela de tabelas SQL e exibições da fonte de dados OLE DB especificada pela cadeia de conexão connectionString . connectionString pode ser texto ou um registro de pares de valor de propriedade. Os valores da 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 : um lógico (true/false) que define se as propriedades de navegação devem ser geradas nos valores retornados (o padrão é verdadeiro). NavigationPropertyNameGenerator : uma função usada para a criação de nomes para 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 : um lógico (true/false) que define se as tabelas agrupadas por seus nomes de esquema (o padrão é verdadeiro). ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de fazer uma conexão com o servidor. O valor padrão depende do driver. CommandTimeout : uma duração que controla por quanto tempo a consulta do lado do servidor tem permissão para ser executada antes de ser cancelada. O valor padrão é dez minutos. SqlCompatibleWindowsAuth : uma lógica (true/false) que determina se as opções de cadeia de conexão compatíveis com o SQL Server devem ser produzidas para 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. Last updated on 22/11/2025

Retorna o resultado da execução query com a cadeia de conexão connectionString usando OLE DB. connectionString pode ser texto ou um registro de pares de valor de propriedade. Os valores da 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 uma conexão com o servidor. O valor padrão depende do driver. CommandTimeout : uma duração que controla por quanto tempo a consulta do lado do servidor tem permissão para ser executada antes de ser cancelada. O valor padrão é dez minutos. SqlCompatibleWindowsAuth : uma lógica (true/false) que determina se as opções de cadeia de conexão compatíveis com o SQL Server devem ser produzidas para autenticação do Windows. O valor padrão é true. Last updated on 22/11/2025

Retorna uma tabela de tabelas SQL e exibições do banco de dados Oracle no servidor server . A porta pode ser especificada opcionalmente com o servidor, separado por dois-pontos. Um parâmetro de registro opcional, options pode ser especificado para controlar as seguintes opções: CreateNavigationProperties : um lógico (true/false) que define se as propriedades de navegação devem ser geradas nos valores retornados (o padrão é verdadeiro). NavigationPropertyNameGenerator : uma função usada para a criação de nomes para 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 por quanto tempo a consulta do lado do servidor tem permissão para ser executada antes de ser cancelada. O valor padrão é dez minutos. ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de fazer uma conexão com o servidor. O valor padrão depende do driver. HierarchicalNavigation : um lógico (true/false) que define se as tabelas agrupadas por seus nomes de esquema (o padrão é falso). O parâmetro de registro é especificado como [option1 = value1, option2 = value2...] ou [Query = "select ..."] por exemplo. Last updated on 22/11/2025

Retorna todas as tabelas encontradas em pdf . Um parâmetro de registro opcional, options pode ser fornecido para especificar propriedades adicionais. O registro pode conter os seguintes campos: Implementation : a versão do algoritmo a ser usada ao identificar tabelas. As versões antigas estão disponíveis apenas para compatibilidade com versões anteriores, para impedir que consultas antigas sejam interrompidas por atualizações de algoritmo. A versão mais recente sempre deve dar os melhores resultados. Os valores válidos são "1.3", "1.2", "1.1" ou nulo. StartPage : especifica a primeira página no intervalo de páginas a serem examinadas. Padrão: 1. EndPage : especifica a última página no intervalo de páginas a serem examinadas. Padrão: a última página do documento. MultiPageTables : controla se tabelas semelhantes em páginas consecutivas serão automaticamente combinadas em uma única tabela. Padrão: true. EnforceBorderLines : controla se as linhas de borda são sempre impostas como limites de célula (quando true) ou simplesmente usadas como uma dica entre muitas para determinar limites de célula (quando false). Padrão: false. Exemplo Retorna as tabelas contidas em sample.pdf. Usage Power Query M Pdf.Tables(File.Contents("c:\sample.pdf")) Saída #table({"Name", "Kind", "Data"}, ...) Last updated on 03/04/2026

Retorna um percentage valor do determinado value . Se o dado value for null , Percentage.From retornará null . Se o determinado value estiver text com um símbolo de porcentagem à direita, o número decimal convertido será retornado. Caso contrário, o valor será convertido em um number uso Number.From. Um opcional culture também pode ser fornecido (por exemplo, "en-US"). Exemplo Obter o percentage valor de "12.3%" . Usage Power Query M Percentage.From("12.3%") Saída 0.123 Conteúdo relacionado Como a cultura afeta a formatação de texto Last updated on 25/03/2026

Retorna uma tabela de tabelas SQL e exibições disponíveis em um banco de dados PostgreSQL no servidor server na instância de banco de dados chamada database . A porta pode ser especificada opcionalmente com o servidor, separado por dois-pontos. Um parâmetro de registro opcional, options pode ser especificado para controlar as seguintes opções: CreateNavigationProperties : um lógico (true/false) que define se as propriedades de navegação devem ser geradas nos valores retornados (o padrão é verdadeiro). NavigationPropertyNameGenerator : uma função usada para a criação de nomes para 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 por quanto tempo a consulta do lado do servidor tem permissão para ser executada antes de ser cancelada. O valor padrão é dez minutos. ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de fazer uma conexão com o servidor. O valor padrão depende do driver. HierarchicalNavigation : um lógico (true/false) que define se as tabelas agrupadas por seus nomes de esquema (o padrão é falso). O parâmetro de registro é especificado como [option1 = value1, option2 = value2...] ou [Query = "select ..."] por exemplo. Last updated on 22/11/2025

Essa função destina-se apenas ao uso interno. Last updated on 22/11/2025

Retorna um registro de quadros de dados do arquivo RData. Last updated on 16/09/2025

Adiciona um campo a um registro record , dado o nome do campo fieldName e o valor value .

Combina os registros no determinado records . Se o records valor não contiver registro, um erro será retornado.

Retorna o valor do especificado field no record . Se o campo não for encontrado, um erro será gerado. Exemplo Localize o valor do campo "CustomerID" no registro. Usage Power Query M Record.Field([CustomerID = 1, Name = "Bob", Phone = "123-4567"], "CustomerID") Saída 1 Last updated on 25/03/2026

Retorna o número de campos no registro record . Exemplo Localize o número de campos no registro. Usage Power Query M Record.FieldCount([CustomerID = 1, Name = "Bob"]) Saída 2 Last updated on 25/03/2026

Retorna os nomes dos campos no registro record como texto.

Retorna o valor do campo field especificado no registro record . Se o campo não for encontrado, o opcional defaultValue será retornado.

Retorna uma lista dos valores de campo no registro record .

Retorna um registro dado um list dos valores de campo e um conjunto de campos. Pode fields ser especificado por uma lista de valores de texto ou por um tipo de registro. Um erro será gerado se os campos não forem exclusivos.

Retorna um registro de uma tabela de registros table que contém nomes de campo e nomes {[Name = name, Value = value]} de valor. Um erro será gerado se os nomes de campo não forem exclusivos.

Indica se o registro record tem os campos especificados fields , retornando um valor lógico (true ou false). Vários valores de campo podem ser especificados usando uma lista.

Retorna um registro que remove todos os campos especificados na lista fields da entrada record . Se o campo especificado não existir, um erro será gerado.

Retorna um registro após renomear campos na entrada record para os novos nomes de campo especificados na lista renames . Para várias renomeações, uma lista aninhada pode ser usada ({ {old1, new1}, {old2, new2} }).

Reordena os campos de um registro para corresponder à ordem de uma lista de nomes de campo. record : o registro que contém os campos a serem reordenados. fieldOrder : uma lista que contém a nova ordem dos campos a serem aplicados ao registro. Os valores de campo são mantidos e os campos não listados nesse parâmetro são deixados em suas posições originais. missingField : especifica a ação esperada para valores ausentes em uma linha que contém menos campos do que o esperado. Os seguintes valores são válidos: MissingField.Error : (Padrão) Indica que campos ausentes devem resultar em um erro. Se nenhum valor for inserido para o missingField parâmetro, esse valor será usado. MissingField.Ignore : indica que os campos ausentes devem ser ignorados. MissingField.UseNull : indica que os campos ausentes devem ser incluídos como null valores.

Retorna um registro que inclui apenas os campos especificados na lista fields da entrada record . Exemplo Selecione os campos "Item" e "Preço" no registro. Usage Power Query M Record.SelectFields( [OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100.0], {"Item", "Price"} ) Saída [Item = "Fishing rod", Price = 100] Last updated on 25/03/2026

Retorna uma lista de valores que contêm os valores de campo da entrada record .

Retorna uma tabela que contém as colunas Name e Value com uma linha para cada campo em record .

Retorna um registro depois de aplicar transformações especificadas na lista transformOperations a record . Um ou mais campos podem ser transformados em um determinado momento. No caso de um único campo sendo transformado, transformOperations espera-se que seja uma lista com dois itens. O primeiro item transformOperations especifica um nome de campo e o segundo item especifica transformOperations a função a ser usada para transformação. Por exemplo, {"Quantity", Number.FromText} No caso de vários campos sendo transformados, transformOperations espera-se que 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",Number.FromText},{"UnitPrice", Number.FromText}}

Substitui o old texto no original text pelo new texto. Essa função de substituição pode ser usada em List.ReplaceValue e Table.ReplaceValue .

Substitui o old valor no original value pelo new valor. Essa função de substituição pode ser usada em List.ReplaceValue e Table.ReplaceValue. Exemplo Substitua o valor 11 pelo valor 10. Usage Power Query M Replacer.ReplaceValue(11, 11, 10) Saída 10 Last updated on 04/04/2026 Funções de divisor Essas funções dividem o texto. ﾉ Expandir a tabela Nome Description Splitter.SplitByNothing Retorna uma função que não faz nenhuma divisão, retornando seu argumento como uma única lista de elementos. Splitter.SplitTextByCharacterTransition 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. Splitter.SplitTextByAnyDelimiter Retorna uma função que divide o texto por qualquer delimitador com suporte. Splitter.SplitTextByDelimiter Retorna uma função que dividirá o texto de acordo com um delimitador. Splitter.SplitTextByEachDelimiter Retorna uma função que divide o texto por cada delimitador por sua vez. Splitter.SplitTextByLengths Retorna uma função que divide o texto de acordo com os comprimentos especificados. Splitter.SplitTextByPositions Retorna uma função que divide o texto de acordo com as posições especificadas. Splitter.SplitTextByRanges Retorna uma função que divide o texto de acordo com os intervalos especificados. Splitter.SplitTextByRepeatedLengths Retorna uma função que divide o texto em uma lista de texto após o comprimento especificado repetidamente. Splitter.SplitTextByWhitespace Retorna uma função que divide o texto de acordo com o espaço em branco. Last updated on 22/11/2025

Retorna uma árvore de sintaxe abstrata (AST) que representa o acesso à coluna columnName da linha dentro de uma expressão de linha.

Retorna a árvore de sintaxe abstrata (AST) para o corpo de function , normalizada 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 RowExpression.Rowpor . Todas as referências a colunas são substituídas por RowExpression.Column(columnName). O AST será simplificado para conter apenas nós dos tipos: Constant Invocation Unary Binary If FieldAccess Um erro será gerado se uma expressão de linha AST não puder ser retornada para o corpo de function . Essa função é idêntica a ItemExpression.From.

Retorna os objetos na conta salesforce fornecida nas credenciais. A conta será conectada por meio do ambiente loginUrl fornecido. Se nenhum ambiente for fornecido, a conta se conectará à produção (https://login.salesforce.com ). Um parâmetro de registro opcional, options pode ser fornecido para especificar propriedades adicionais. O registro pode conter os seguintes campos: CreateNavigationProperties : um lógico (true/false) que define se as propriedades de navegação devem ser geradas nos valores retornados (o padrão é falso). ApiVersion : a versão da API do Salesforce a ser usada para esta consulta. Quando não especificado, a API versão 29.0 é usada. Timeout : uma duração que controla quanto tempo aguardar antes de abandonar a solicitação para o servidor. O valor padrão é específico da origem. Last updated on 22/11/2025

Retorna os relatórios na conta do Salesforce fornecidas nas credenciais. A conta será conectada por meio do ambiente loginUrl fornecido. Se nenhum ambiente for fornecido, a conta se conectará à produção (https://login.salesforce.com ). 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 API versão 29.0 é usada. Timeout : uma duração que controla quanto tempo aguardar antes de abandonar a solicitação para o servidor. O valor padrão é específico da origem. Last updated on 22/11/2025

Retorna uma tabela de InfoCubes e consultas agrupadas pelo InfoArea de uma instância do SAP Business Warehouse no servidor server com o número systemNumberOrSystemId do sistema e a ID clientId do cliente. Um parâmetro de registro opcional, optionsOrLogonGroup pode ser especificado para controlar as seguintes opções: Last updated on 04/04/2026

Retorna uma tabela de pacotes multidimensionais do banco de dados server SAP HANA. 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 : um SapHanaDistribution que define o valor da propriedade "Distribution" na cadeia de conexão. O roteamento de instrução é o método de avaliar o nó de servidor correto de um sistema distribuído antes da execução da instrução. O valor padrão é SapHanaDistribution.All. Implementation : especifica a implementação do conector do SAP HANA a ser usado. EnableColumnBinding : associa variáveis às colunas de um conjunto de resultados do SAP HANA ao buscar dados. Pode potencialmente melhorar o desempenho ao custo de utilização de memória ligeiramente maior. O valor padrão é false. ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de fazer uma conexão com o servidor. O valor padrão é 15 segundos. CommandTimeout : uma duração que controla por quanto tempo a consulta do lado do servidor tem permissão para ser executada antes de ser cancelada. O valor padrão é dez minutos. Last updated on 26/03/2026

Retorna uma tabela que contém uma linha para cada pasta e documento encontrado no site do SharePoint especificado, url . Cada linha contém propriedades da pasta ou 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 "Auto" que especifica a versão da API do SharePoint a ser usada para este site. Quando não especificado, a API versão 14 é usada. Quando Auto for especificado, a versão do servidor será descoberta automaticamente, se possível, caso contrário, a versão padrão será 14. Sites do SharePoint não em inglês exigem pelo menos a versão 15. Implementation : opcional. Especifica qual versão do conector do SharePoint usar. Os valores aceitos são "2,0" ou nulos. Se o valor for "2.0", a implementação 2.0 do conector do SharePoint será usada. Se o valor for nulo, a implementação original do conector do SharePoint será usada. Last updated on 04/04/2026

Retorna uma tabela que contém uma linha para cada documento encontrado no site url do SharePoint especificado 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 "Auto" que especifica a versão da API do SharePoint a ser usada para este site. Quando não especificado, a API versão 14 é usada. Quando Auto for especificado, a versão do servidor será descoberta automaticamente, se possível, caso contrário, a versão padrão será 14. Sites do SharePoint não em inglês exigem pelo menos a versão 15. Last updated on 22/11/2025

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 "Auto" que especifica a versão da API do SharePoint a ser usada para este site. Quando não especificado, a API versão 14 é usada. Quando Auto for especificado, a versão do servidor será descoberta automaticamente, se possível, caso contrário, a versão padrão será 14. Sites do SharePoint não em inglês exigem pelo menos a versão 15. Implementation : opcional. Especifica qual versão do conector do SharePoint usar. Os valores aceitos são "2,0" ou nulos. Se o valor for "2.0", a implementação 2.0 do conector do SharePoint será usada. Se o valor for nulo, a implementação original do conector do SharePoint será usada. ViewMode : opcional. Essa opção só é válida para a implementação 2.0. Os valores aceitos são "Todos" e "Padrão". Se nenhum valor for especificado, o valor será definido como "Todos". Quando "Tudo"; é especificado, o modo de exibição inclui todas as colunas criadas pelo usuário e definidas pelo sistema. Quando "Padrão" for especificado, o modo de exibição corresponderá ao que o usuário vê ao examinar a lista online em qualquer exibição que o usuário definir como Padrão em suas configurações. Se o usuário editar seu modo de exibição padrão para adicionar ou remover colunas criadas pelo usuário ou definidas pelo sistema ou criando um novo modo de exibição e definindo-o como padrão, essas alterações serão propagadas por meio do conector. DisableAppendNoteColumns : impede que o conector use um ponto de extremidade separado para colunas de observação. Last updated on 22/11/2025

Retorna um valor único number do determinado value . Se o dado value for null , Single.From retornará null . Se o determinado value estiver number dentro do intervalo de Single, value será retornado, caso contrário, um erro será retornado. Se value for de qualquer outro tipo, ele será convertido primeiro em um number uso Number.FromText. Um opcional culture também pode ser fornecido (por exemplo, "en-US"). Exemplo Obter o valor único number de "1.5" . Usage Power Query M Single.From("1.5") Saída 1.5 Conteúdo relacionado Como a cultura afeta a formatação de texto Last updated on 25/03/2026 Funções de registro 19/06/2025 Essas funções criam e manipulam valores de registro. Informação ﾉ Expandir a tabela Nome Descrição Record.FieldCount Retorna o número de campos em um registro. Record.HasFields Retornará true se o nome do campo ou os nomes de campo estiverem presentes em um registro. Transformações ﾉ Expandir a tabela Nome Descrição Geography.FromWellKnownText Converte o texto que representa um valor geográfico no formato WKT (Well-Known Text) em um registro estruturado. Geography.ToWellKnownText Converte um valor de ponto geográfico estruturado em sua representação WKT (Well-Known Text). GeographyPoint.From Cria um registro que representa um ponto geográfico a partir de partes. Geometry.FromWellKnownText Converte o texto que representa um valor geométrico no formato WKT (Well-Known Text) em um registro estruturado. Geometry.ToWellKnownText Converte um valor de ponto geométrico estruturado em sua representação WKT (Well-Known Text). GeometryPoint.From Cria um registro que representa um ponto geométrico a partir de partes. Record.AddField Adiciona um campo a partir de um nome de campo e um valor. Record.Combine Combina os registros em uma lista. Record.RemoveFields Remove os campos especificados do registro de entrada. Nome Descrição Record.RenameFields Retorna um novo registro que renomeia os campos especificados. Os campos resultantes manterão sua ordem original. Est

Retorna uma tabela do conteúdo na URL url especificada formatada de acordo com a API DO SODA 2.0. A URL deve apontar para uma fonte em conformidade com SODA válida que termina em uma extensão .csv. Last updated on 16/09/2025

Retorna uma função que não faz nenhuma divisão, retornando seu argumento como uma única lista de elementos. Last updated on 22/11/2025

Retorna uma função que divide o texto em uma lista de texto em qualquer um dos delimitadores especificados.

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. O before parâmetro pode after ser uma lista de caracteres ou uma função que usa um caractere e retorna true/false.

Retorna uma função que divide o texto em uma lista de texto de acordo com o delimitador especificado. Exemplo Divida a entrada por vírgula, ignorando as vírgulas entre aspas. Usage Power Query M Splitter.SplitTextByDelimiter(",", QuoteStyle.Csv)("a,""b,c"",d") Saída {"a", "b,c", "d"} Last updated on 25/03/2026

Retorna uma função que divide o texto em uma lista de texto em cada delimitador especificado em sequência.

Retorna uma função que divide o texto em uma lista de texto por cada comprimento especificado.

Retorna uma função que divide o texto em uma lista de texto em cada posição especificada.

Retorna uma função que divide o texto em uma lista de texto de acordo com os deslocamentos e comprimentos especificados. Um comprimento nulo indica que todas as entradas restantes devem ser incluídas.

Retorna uma função que divide o texto em uma lista de texto após o comprimento especificado repetidamente.

Retorna uma função que divide o texto em uma lista de texto no espaço em branco. Exemplo Divida a entrada por caracteres de espaço em branco, tratando aspas como qualquer outro caractere. Usage Power Query M Splitter.SplitTextByWhitespace(QuoteStyle.None)("a b#(tab)c") Saída {"a", "b", "c"} Last updated on 25/03/2026 Funções de tabela 29/08/2025 Essas funções criam e manipulam valores de tabela. Construção de tabela ﾉ Expandir a tabela Nome Descrição #table Cria um valor de tabela a partir de colunas e linhas. ItemExpression.From Retorna a árvore de sintaxe abstrata (AST) para o corpo de uma função. RowExpression.Column Retorna uma árvore de sintaxe abstrata (AST) que representa o acesso a uma coluna em meio a uma expressão de linha. RowExpression.From Retorna a árvore de sintaxe abstrata (AST) para o corpo de uma função. Table.FromColumns Cria uma tabela com base em uma lista de colunas e valores especificados. Table.FromList Converte uma lista em uma tabela aplicando a função de divisão especificada a cada item na lista. Table.FromRecords Converte uma lista de registros em uma tabela. Table.FromRows Cria uma tabela com base em uma lista de valores de linha e colunas opcionais. Table.FromValue Cria uma tabela com uma coluna com base no valor ou valores fornecidos. Table.WithErrorContext Essa função destina-se apenas ao uso interno. Table.View Cria ou estende uma tabela com manipuladores definidos pelo usuário para operações de consulta e ação. Table.ViewError Cria um registro de erro modificado que não aciona um fallback quando disparado por um manipulador definido em uma visualização (via Table.View). Table.ViewFunction Cria uma função que pode ser interceptada por um manipulador definido em uma visualização (via Table.View). Conversões ﾉ Expandir a tabela Nome Descrição Table.ToColumns Cria listas aninhadas de valores de colunas a partir de uma tabela. Table.ToList Converte uma tabela em uma lista aplicando a função de combinação especificada a cada linha de valo

Retorna uma tabela de tabelas SQL, exibições e funções armazenadas do banco de dados database do SQL Server no servidor server . A porta pode ser especificada opcionalmente com o servidor, separado por dois-pontos ou uma 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 : um lógico (true/false) que define se as propriedades de navegação devem ser geradas nos valores retornados (o padrão é verdadeiro). NavigationPropertyNameGenerator : uma função usada para a criação de nomes para 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 por quanto tempo a consulta do lado do servidor tem permissão para ser executada antes de ser cancelada. O valor padrão é dez minutos. ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de fazer uma conexão com o servidor. O valor padrão depende do driver. HierarchicalNavigation : um lógico (true/false) que define se as tabelas agrupadas por seus nomes de esquema (o padrão é falso). MultiSubnetFailover : uma lógica (true/false) que define o valor da propriedade "MultiSubnetFailover" na cadeia de conexão (o padrão é false). Ele também define ApplicationIntent=readonly. UnsafeTypeConversions : um lógico (true/false) que, se verdadeiro, tenta dobrar conversões de tipo que podem falhar e fazer com que toda a consulta falhe. Não recomendado para uso geral. ContextInfo : um valor binário usado para definir o CONTEXT_INFO antes de executar cada comando. OmitSRID : um lógico (true/false) que, se verdadeiro, omite o SRID ao produzir Texto Bem Conhecidoo de tipos de geometria e geografia. EnableCrossDatabaseFolding : um valor lógico (true/false

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 : um lógico (true/false) que define se as propriedades de navegação devem ser geradas nos valores retornados (o padrão é verdadeiro). NavigationPropertyNameGenerator : uma função usada para a criação de nomes para 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 por quanto tempo a consulta do lado do servidor tem permissão para ser executada antes de ser cancelada. O valor padrão é dez minutos. ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de fazer uma conexão com o servidor. O valor padrão depende do driver. HierarchicalNavigation : um lógico (true/false) que define se as tabelas agrupadas por seus nomes de esquema (o padrão é falso). MultiSubnetFailover : uma lógica (true/false) que define o valor da propriedade "MultiSubnetFailover" na cadeia de conexão (o padrão é false). Ele também define ApplicationIntent=readonly. UnsafeTypeConversions : um lógico (true/false) que, se verdadeiro, tenta dobrar conversões de tipo que podem falhar e fazer com que toda a consulta falhe. Não recomendado para uso geral. ContextInfo : um valor binário usado para definir o CONTEXT_INFO antes de executar cada comando. OmitSRID : um lógico (true/false) que, se verdadeiro, omite o SRID ao produzir Texto Bem Conhecidoo de tipos de geometria e geografia. EnableCrossDatabaseFolding : um valor lógico (true/false) que, se verdadeiro, permite a dobragem de consulta entre bancos de dados no mesmo servidor. O valor padrão é false. O parâmetro de registro é especificado como [option1 = value1, option2 = value2...], por exemplo. Não dá suporte à configuração de uma consulta SQL a ser executada no servidor. Sql.Database

Essa função destina-se apenas ao uso interno. Last updated on 22/11/2025

Converte a consulta fornecida sql em código M, com os identificadores disponíveis definidos por environment . Essa função destina-se apenas ao uso interno. Last updated on 22/11/2025

Retorna uma tabela de tabelas SQL e exibições 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 opcionalmente com o servidor, separado por dois-pontos. Um parâmetro de registro opcional, options pode ser especificado para controlar as seguintes opções: CreateNavigationProperties : um lógico (true/false) que define se as propriedades de navegação devem ser geradas nos valores retornados (o padrão é verdadeiro). NavigationPropertyNameGenerator : uma função usada para a criação de nomes para 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 por quanto tempo a consulta do lado do servidor tem permissão para ser executada antes de ser cancelada. O valor padrão é dez minutos. ConnectionTimeout : uma duração que controla quanto tempo esperar antes de abandonar uma tentativa de fazer uma conexão com o servidor. O valor padrão depende do driver. HierarchicalNavigation : um lógico (true/false) que define se as tabelas agrupadas por seus nomes de esquema (o padrão é falso). O parâmetro de registro é especificado como [option1 = value1, option2 = value2...] ou [Query = "select ..."] por exemplo. Last updated on 22/11/2025

Adiciona uma coluna nomeada newColumnName à tabela table . Os valores da coluna são computados usando a função columnGenerator de seleção especificada com cada linha usada como entrada.

Adiciona uma nova coluna newColumnName com table valores representativos de columnName . Os representantes são obtidos por valores de correspondência difusa em columnName , para cada linha. Um conjunto opcional de options pode ser incluído para especificar como comparar as colunas de chave. As opções incluem: Culture : permite agrupar registros com base em regras específicas da cultura. Pode ser qualquer nome de cultura válido. Por exemplo, uma opção cultura de "ja-JP" agrupa registros com base na cultura japonesa. O valor padrão é "", que agrupa com base na cultura inglesa invariável. IgnoreCase : um valor lógico (true/false) que permite agrupamento de chaves que não diferencia maiúsculas de minúsculas. Por exemplo, quando verdadeiro, "Uvas" é agrupado com "uvas". O valor padrão é true. IgnoreSpace : um valor lógico (true/false) que permite a combinação de partes de texto para localizar grupos. Por exemplo, quando verdadeiro, "Gra pes" é agrupado com "Uvas". O valor padrão é true. SimilarityColumnName : um nome para a coluna que mostra a semelhança entre um valor de entrada e o valor representativo dessa entrada. O valor padrão é nulo, caso em que uma nova coluna para semelhanças não será adicionada. Threshold : um número entre 0,00 e 1,00 que especifica a pontuação de similaridade na qual dois valores serão agrupados. Por exemplo, "Uvas" e "Graes" (faltando o "p") serão agrupados somente se essa opção for definida como menor que 0,90. Um limite de 1,00 só permite correspondências exatas. (Observe que uma "correspondência exata" difusa pode ignorar diferenças como maiúsculas, ordem de palavras e pontuação.) O valor padrão é 0,80. TransformationTable : uma tabela que permite agrupar registros com base em mapeamentos de valor personalizados. Ele deve conter colunas "De" e "Para". Por exemplo, "Uvas" será agrupada com "Raisins" se uma tabela de transformação for fornecida com a coluna "From" contendo "Uvas" e a coluna "Para" que contém "Passas". Observe que a transfor

Acrescenta uma coluna nomeada newColumnName aos table valores de posição explícitos. Um valor opcional, initialValue o valor do índice inicial. Um valor opcional especifica increment quanto incrementar cada valor de índice.

Une as linhas de table1 com as linhas de table2 base na igualdade dos valores das colunas de chave selecionadas por key1 (para table1 ) e key2 (para table2 ). Os resultados são armazenados em uma coluna chamada newColumnName . Essa função se comporta de forma idêntica a Table.NestedJoin com joinKind set to JoinKind.LeftOuter . Exemplo Adicione uma coluna de junção a ({[saleID = 1, item = "Shirt"], [saleID = 2, item = "Hat"]}) denominado "preço/ação" da tabela ({[saleID = 1, preço = 20], [saleID = 2, preço = 10]}) ingressado em [saleID]. Usage Power Query M Table.AddJoinColumn( Table.FromRecords({ [saleID = 1, item = "Shirt"], [saleID = 2, item = "Hat"] }), "saleID", Table.FromRecords({ [saleID = 1, price = 20, stock = 1234], [saleID = 2, price = 10, stock = 5643] }), "saleID", "price" ) Saída Power Query M Table.FromRecords({ [ saleID = 1, item = "Shirt", price = Table.FromRecords({[saleID = 1, price = 20, stock = 1234]}) ], [ saleID = 2, item = "Hat", price = Table.FromRecords({[saleID = 2, price = 10, stock = 5643]}) ] }) Last updated on 04/06/2026

Adiciona uma chave a table , onde columns está a lista de nomes de coluna que definem a chave e isPrimary especifica se a chave é primária.

Acrescenta uma coluna chamada de newColumnName a table com a classificação de uma ou mais outras colunas descritas por comparisonCriteria . A opção RankKind pode options ser usada por usuários avançados para escolher um método de classificação mais específico. Exemplo Adicione uma coluna chamada "RevenueRank" à tabela que classifica a coluna "Receita" da mais alta para a mais baixa. Usage Power Query M Table.AddRankColumn( Table.FromRecords({ [CustomerID = 1, Name = "Bob", Revenue = 200], [CustomerID = 2, Name = "Jim", Revenue = 100], [CustomerID = 3, Name = "Paul", Revenue = 200], [CustomerID = 4, Name = "Ringo", Revenue = 50] }), "RevenueRank", {"Revenue", Order.Descending}, [RankKind = RankKind.Competition] ) Saída Power Query M Table.FromRecords({ [CustomerID = 1, Name = "Bob", Revenue = 200, RevenueRank = 1], [CustomerID = 3, Name = "Paul", Revenue = 200, RevenueRank = 1], [CustomerID = 2, Name = "Jim", Revenue = 100, RevenueRank = 3], [CustomerID = 4, Name = "Ringo", Revenue = 50, RevenueRank = 4] }) Conteúdo relacionado Critérios de comparação Last updated on 04/04/2026

Agrega tabelas em [ table ] em column várias colunas que contêm valores agregados 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 Agregar colunas de tabela na [t] 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] . Usage Power Query M Table.AggregateTableColumn( Table.FromRecords( { [ t = Table.FromRecords({ [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", List.Sum, "sum of t.a"}, {"b", List.Min, "min of t.b"}, {"b", List.Max, "max of t.b"}, {"a", List.Count, "count of t.a"} } ) Saída Table.FromRecords({[#"sum of t.a" = 3, #"min of t.b" = 2, #"max of t.b" = 4, #"count of t.a" = 2, b = 2]}) Last updated on 25/03/2026

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 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.

Retorna o número aproximado de linhas no table , ou um erro se a fonte de dados não der suporte à aproximação.

Armazena em buffer uma tabela na memória, isolando-a de alterações externas durante a avaliação. O buffer é superficial. Ele força a avaliação de quaisquer valores de célula escalar, mas deixa valores não escalares (registros, listas, tabelas e assim por diante) as-is. table : a tabela a ser armazenada em buffer na memória. options : (Opcional) Os seguintes valores de registro de opções podem ser usados: BufferMode : o modo de buffer que descreve o tipo de buffer a ser executado. Essa opção pode ser ou BufferMode.EagerBufferMode.Delayed. Usar essa função pode ou não fazer suas consultas serem executadas mais rapidamente. Em alguns casos, isso pode fazer com que suas consultas sejam executadas mais lentamente devido ao custo adicional de ler todos os dados e armazená-los na memória, bem como o fato de que o buffer impede a dobra downstream. Se os dados não precisarem ser armazenados em buffer, mas você quiser apenas impedir a dobra downstream, use Table.StopFolding em vez disso. Exemplo Carregue todas as linhas de uma tabela SQL na memória, para que todas as operações downstream não sejam mais capazes de consultar o SQL Server. Usage Power Query M let Source = Sql.Database("SomeSQLServer", "MyDb"), MyTable = Source{[Item="MyTable"]}[Data], BufferMyTable = Table.Buffer(MyTable) in BufferMyTable Saída table Last updated on 04/04/2026 Table.ClearDown Syntax Table.ClearDown(table as table, columns as list) as table Sobre Substitui o especificado columns por nulo quando todos os seus valores são repetidos da linha anterior. Example Desmarque as colunas Região e Local quando ambas forem repetidas. Usage Power Query M Table.ClearDown( Table.FromRecords({ [Region = "West", Place = 1, Name = "Bob"], [Region = "West", Place = 1, Name = "John"], [Region = "West", Place = 2, Name = "Brad"], [Region = "East", Place = 3, Name = "Mark"], [Region = "East", Place = 3, Name = "Tom"] }), {"Region", "Place"} ) Output Power Query M Table.FromRecords({ [Region = "West", Place = 1, Name =

Retorna a coluna de dados especificada pela column tabela table como uma lista. Exemplo Retorna os valores da coluna [Nome] na tabela. Usage Power Query M Table.Column( Table.FromRecords({ [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" ) Saída {"Bob", "Jim", "Paul", "Ringo"} Last updated on 25/03/2026

Retorna o número de colunas na tabela table . Exemplo Localize o número de colunas na tabela. Usage Power Query M Table.ColumnCount( Table.FromRecords({ [CustomerID = 1, Name = "Bob", Phone = "123-4567"], [CustomerID = 2, Name = "Jim", Phone = "987-6543"], [CustomerID = 3, Name = "Paul", Phone = "543-7890"] }) ) Saída 3 Last updated on 25/03/2026

Retorna os nomes de coluna na tabela table como uma lista de texto.

Retorna uma lista com os nomes das colunas da tabela table que correspondem aos tipos especificados em listOfTypes . Exemplo Retorne os nomes das colunas do tipo Number.Type da tabela. Usage Power Query M Table.ColumnsOfType( Table.FromRecords( {[a = 1, b = "hello"]}, type table[a = Number.Type, b = Text.Type] ), {type number} ) Saída {"a"} Conteúdo relacionado Tipos e conversão de tipo Last updated on 25/03/2026

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 especificada.

Combina as colunas especificadas em uma nova coluna usando a função combinada especificada. Exemplo Combine o último e os primeiros nomes em uma nova coluna, separada por uma vírgula. Usage Power Query M Table.CombineColumns( Table.FromRecords({[FirstName = "Bob", LastName = "Smith"]}), {"LastName", "FirstName"}, Combiner.CombineTextByDelimiter(",", QuoteStyle.None), "FullName" ) Saída Table.FromRecords({[FullName = "Smith,Bob"]}) Last updated on 03/04/2026

Combina as colunas especificadas de table uma nova coluna com valor de registro nomeada newColumnName em que cada registro tem nomes de campo e valores correspondentes aos nomes de coluna e valores das colunas que foram combinadas. Se um registro for especificado, options as seguintes opções poderão ser fornecidas: DisplayNameColumn : quando especificado como texto, indica que o nome da coluna fornecido deve ser tratado como o nome de exibição do registro. Essa não precisa ser uma das colunas no próprio registro. TypeName : quando especificado como texto, fornece um nome de tipo lógico para o registro resultante que pode ser usado durante a carga de dados para conduzir o comportamento pelo ambiente de carregamento. Conteúdo relacionado Tipos e conversão de tipo Last updated on 22/11/2025

Essa função destina-se apenas ao uso interno. Last updated on 22/11/2025

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.

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.

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.

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 "Column1", "Column2" e assim por diante. Exemplo Rebaixe a primeira linha de valores na tabela. Usage Power Query M Table.DemoteHeaders( Table.FromRecords({ [CustomerID = 1, Name = "Bob", Phone = "123-4567"], [CustomerID = 2, Name = "Jim", Phone = "987-6543"] }) ) Saída Power Query M Table.FromRecords({ [Column1 = "CustomerID", Column2 = "Name", Column3 = "Phone"], [Column1 = 1, Column2 = "Bob", Column3 = "123-4567"], [Column1 = 2, Column2 = "Jim", Column3 = "987-6543"] }) Last updated on 25/03/2026

Remove linhas duplicadas da tabela. 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. Como o Power Query às vezes descarrega determinadas operações para fazer back-end de fontes de dados (conhecidas como "dobragem" e também às vezes otimiza consultas ignorando operações que não são estritamente necessárias, em geral não há garantia de qual duplicata específica será preservada. Por exemplo, você não pode assumir que a primeira linha com um conjunto exclusivo de valores de coluna permanecerá e que as linhas mais abaixo na tabela serão removidas. Se você quiser que a remoção duplicada se comporte previsivelmente, primeiro faça o buffer da tabela usando Table.Buffer.

Duplicar a coluna nomeada columnName para a tabela table . Os valores e o tipo da coluna newColumnName são copiados da coluna columnName . Example Duplicar a coluna "a" para uma coluna chamada "coluna copiada" na tabela ({[a = 1, b = 2], [a = 3, b = 4]}) . Usage Power Query M Table.DuplicateColumn( Table.FromRecords({ [a = 1, b = 2], [a = 3, b = 4] }), "a", "copied column" ) Saída Power Query M Table.FromRecords({ [a = 1, b = 2, #"copied column" = 1], [a = 3, b = 4, #"copied column" = 3] }) Conteúdo relacionado Tipos e conversão de tipo Last updated on 22/11/2025

Dado um table local em que column contém 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. Essa função também pode expandir tabelas aninhadas tratando-as como listas de registros.

Considerando os column 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 para colunas na tabela. newColumnNames : a lista de nomes de coluna para fornecer as novas colunas. Os novos nomes de coluna não podem duplicar nenhuma coluna na nova tabela. Exemplo Expanda a coluna [a] na tabela ({[a = [aa = 1, bb = 2, cc = 3], b = 2]}) em três colunas "aa", "bb" e "cc". Usage Power Query M Table.ExpandRecordColumn( Table.FromRecords({ [ a = [aa = 1, bb = 2, cc = 3], b = 2 ] }), "a", {"aa", "bb", "cc"} ) Saída Table.FromRecords({[aa = 1, bb = 2, cc = 3, b = 2]}) Last updated on 25/03/2026

Expande tabelas em 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.

Retorna uma tabela da table especificada em que o valor de uma célula anterior é propagado para as células com valor nulo abaixo no columns especificado. Exemplo Retornar uma tabela com os valores nulos na coluna [Place] preenchido com o valor acima deles da tabela. Usage Power Query M Table.FillDown( Table.FromRecords({ [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"} ) Saída Power Query M Table.FromRecords({ [Place = 1, Name = "Bob"], [Place = 1, Name = "John"], [Place = 2, Name = "Brad"], [Place = 3, Name = "Mark"], [Place = 3, Name = "Tom"], [Place = 3, Name = "Adam"] }) Last updated on 25/03/2026

Retorna uma tabela da table especificada em que o valor da próxima célula é propagado para as células com valor nulo acima no columns especificado.

Essa função destina-se apenas ao uso interno. Last updated on 22/11/2025

Retorna as linhas na tabela table que contêm o texto text . Se o texto não for encontrado, uma tabela vazia será retornada.

Retorna a primeira linha do table valor padrão ou opcional, default se a tabela estiver vazia.

Retorna as primeiras linhas da tabela table , dependendo do valor de countOrCondition : Se countOrCondition for um número, muitas linhas (começando na parte superior) serão retornadas. Se countOrCondition for uma condição, as linhas que atendem à condição serão retornadas até que uma linha não atenda à condição.

Retorna a primeira coluna da primeira linha da tabela table ou um valor padrão especificado. Last updated on 16/09/2025

Cria uma tabela de tipo columns de uma lista lists que contém listas aninhadas com os nomes e valores das colunas. Se algumas colunas tiverem mais valores do que outras, os valores ausentes serão preenchidos com o valor padrão, 'null', se as colunas forem anuláveis.

Converte uma lista, list em uma tabela aplicando a função de divisão opcional, splitter a cada item da lista. Por padrão, supõe-se que a lista seja uma lista de valores de texto divididos por vírgulas. Opcional columns pode ser o número de colunas, uma lista de colunas ou um TableType. Opcional default e extraValues também pode ser especificado.

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 usa como padrão any , mas pode ser especificado por partitionColumnType .

Converte uma lista especificada de registros em uma tabela. records : a lista de registros a serem convertidos em uma tabela. columns : (Opcional) Uma lista dos nomes de coluna da tabela ou do tipo da tabela. missingField : (Opcional) Especifica como lidar com campos ausentes em uma linha. Use um dos valores a seguir: MissingField.Error : todos os campos ausentes produzem um erro (padrão). MissingField.UseNull : todos os campos ausentes são incluídos como null valores. O uso MissingField.Ignore nesse parâmetro produz um erro.

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 .

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 usado ao construir uma tabela a partir de uma lista ou valor escalar.

Agrupa as linhas de table por valores de correspondência difusa na coluna especificada, key para cada linha. Para cada grupo, um registro é construído contendo as colunas de chave (e seus valores) juntamente com quaisquer 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 : permite agrupar registros com base em regras específicas da cultura. Pode ser qualquer nome de cultura válido. Por exemplo, uma opção cultura de "ja-JP" agrupa registros com base na cultura japonesa. O valor padrão é "", que agrupa com base na cultura inglesa invariável. IgnoreCase : um valor lógico (true/false) que permite agrupamento de chaves que não diferencia maiúsculas de minúsculas. Por exemplo, quando verdadeiro, "Uvas" é agrupado com "uvas". O valor padrão é true. IgnoreSpace : um valor lógico (true/false) que permite a combinação de partes de texto para localizar grupos. Por exemplo, quando verdadeiro, "Gra pes" é agrupado com "Uvas". O valor padrão é true. SimilarityColumnName : um nome para a coluna que mostra a semelhança entre um valor de entrada e o valor representativo dessa entrada. O valor padrão é nulo, caso em que uma nova coluna para semelhanças não será adicionada. Threshold : um número entre 0,00 e 1,00 que especifica a pontuação de similaridade na qual dois valores serão agrupados. Por exemplo, "Uvas" e "Graes" (faltando o "p") serão agrupados somente se essa opção for definida como menor que 0,90. Um limite de 1,00 só permite correspondências exatas. (Observe que uma "correspondência exata" difusa pode ignorar diferenças como maiúsculas, ordem de palavras e pontuação.) O valor padrão é 0,80. TransformationTable : uma tabela que permite agrupar registros com base em mapeamentos de valor personalizados. Ele deve conter colunas "De" e "Para". Por exemplo, "Uvas" será agrupada

Une as linhas de table1 com as linhas de table2 com base em uma correspondência difusa dos valores das colunas de chave selecionadas por key1 (para table1 ) e key2 (para table2 ). Correspondência difusa é uma comparação baseada na similaridade do texto em vez da igualdade de texto. Por padrão, uma junção interna é executada, no entanto, um opcional joinKind pode ser incluído para especificar o tipo de junção. As opções incluem: JoinKind.Inner JoinKind.LeftOuter JoinKind.RightOuter JoinKind.FullOuter JoinKind.LeftAnti JoinKind.RightAnti JoinKind.LeftSemi JoinKind.RightSemi Um conjunto opcional de joinOptions pode ser incluído para especificar como comparar as colunas de chave. As opções incluem: ConcurrentRequests : um número entre 1 e 8 que especifica o número de threads paralelos a serem usados para correspondência difusa. O valor padrão é 1. Culture : permite a correspondência de registros com base em regras específicas da cultura. Pode ser qualquer nome de cultura válido. Por exemplo, uma opção cultura de "ja-JP" corresponde a registros com base na cultura japonesa. O valor padrão é "", que corresponde com base na cultura inglesa invariável. IgnoreCase : um valor lógico (true/false) que permite correspondência de chave que não diferencia maiúsculas de minúsculas. Por exemplo, quando verdadeiro, "Uvas" é correspondido com "uvas". O valor padrão é true. IgnoreSpace : um valor lógico (true/false) que permite a combinação de partes de texto para localizar correspondências. Por exemplo, quando verdadeiro, "Gra pes" é correspondido com "Uvas". O valor padrão é true. NumberOfMatches : um número inteiro que especifica o número máximo de linhas correspondentes que podem ser retornadas para cada linha de entrada. Por exemplo, um valor de 1 retornará no máximo uma linha correspondente para cada linha de entrada. Se essa opção não for fornecida, todas as linhas correspondentes serão retornadas. SimilarityColumnName : um nome para a coluna que mostra a semelhança entre um val

Une as linhas de table1 com as linhas de table2 com base em uma 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 . Correspondência difusa é uma comparação baseada na similaridade do texto em vez da igualdade de texto. O opcional joinKind especifica o tipo de junção a ser executada. Por padrão, uma junção externa esquerda será executada se não joinKind for especificado. As opções incluem: JoinKind.Inner JoinKind.LeftOuter JoinKind.RightOuter JoinKind.FullOuter JoinKind.LeftAnti JoinKind.RightAnti JoinKind.LeftSemi JoinKind.RightSemi Um conjunto opcional de joinOptions pode ser incluído para especificar como comparar as colunas de chave. As opções incluem: ConcurrentRequests : um número entre 1 e 8 que especifica o número de threads paralelos a serem usados para correspondência difusa. O valor padrão é 1. Culture : permite a correspondência de registros com base em regras específicas da cultura. Pode ser qualquer nome de cultura válido. Por exemplo, uma opção cultura de "ja-JP" corresponde a registros com base na cultura japonesa. O valor padrão é "", que corresponde com base na cultura inglesa invariável. IgnoreCase : um valor lógico (true/false) que permite correspondência de chave que não diferencia maiúsculas de minúsculas. Por exemplo, quando verdadeiro, "Uvas" é correspondido com "uvas". O valor padrão é true. IgnoreSpace : um valor lógico (true/false) que permite a combinação de partes de texto para localizar correspondências. Por exemplo, quando verdadeiro, "Gra pes" é correspondido com "Uvas". O valor padrão é true. NumberOfMatches : um número inteiro que especifica o número máximo de linhas correspondentes que podem ser retornadas para cada linha de entrada. Por exemplo, um valor de 1 retornará no máximo uma linha correspondente para cada linha de entrada. Se essa opção não for fornecida, todas as linhas correspondentes ser

Agrupa as linhas de table pelas colunas de chave definidas por key . key pode ser um único nome de coluna ou uma lista de nomes de coluna. Para cada grupo, é construído um registro contendo as colunas de chave (e seus valores) com as colunas agregadas especificadas por aggregatedColumns . Opcionalmente, também é possível especificar groupKind e comparer . Se os dados já estiverem classificados pelas colunas de chave, um groupKind de GroupKind.Local poderá ser fornecido. Isso pode melhorar o desempenho do agrupamento em certos casos, já que todas as linhas com um determinado conjunto de valores de chave são consideradas contíguas. Ao passar comparer , observe que, se isso tratar chaves diferentes como iguais, uma linha poderá ser colocada em um grupo cujas chaves sejam diferentes. Essa função não garante a ordenação das linhas que ela retorna.

Indica se contém as table colunas columns especificadas. Retorna true se a tabela contiver as colunas, false caso contrário.

Retorna uma tabela com a lista de linhas, rows inserida table na posição determinada. offset Cada coluna na linha a ser inserida deve corresponder aos tipos de coluna da tabela.

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.

Indica se as table linhas contêm alguma. Retorna true se não houver linhas (ou seja, a tabela está vazia), false caso contrário.

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 opcional joinKind pode ser incluído para especificar o tipo de junção. As opções incluem: JoinKind.Inner JoinKind.LeftOuter JoinKind.RightOuter JoinKind.FullOuter JoinKind.LeftAnti JoinKind.RightAnti JoinKind.LeftSemi JoinKind.RightSemi Um conjunto opcional de keyEqualityComparers pode ser incluído para especificar como comparar as colunas de chave. Atualmente, esse parâmetro destina-se apenas ao uso interno.

Retorna as chaves da tabela especificada. Exemplo Obtenha a lista de chaves de uma tabela. Usage Power Query M let table = Table.FromRecords({ [Id = 1, Name = "Hello There"], [Id = 2, Name = "Good Bye"] }), tableWithKeys = Table.AddKey(table, {"Id"}, true), keys = Table.Keys(tableWithKeys) in keys Saída {[Columns = {"Id"}, Primary = true]} Last updated on 25/03/2026

Retorna a última linha do table valor padrão ou opcional, default se a tabela estiver vazia.

Retorna as últimas linhas da tabela, table dependendo do valor de countOrCondition : Se countOrCondition for um número, muitas linhas serão retornadas a partir da posição (final – countOrCondition ). Se countOrCondition for uma condição, as linhas que atendem à condição serão retornadas em posição crescente até que uma linha não atenda à condição.

Indica se todas as linhas no table conjunto correspondem ao determinado condition . Retorna true se todas as linhas corresponderem, false caso contrário.

Indica se as linhas na table correspondência são as fornecidas condition . Retorna true se qualquer uma das linhas corresponder, false caso contrário.

Retorna a maior linha do table , dado o comparisonCriteria . Se a tabela estiver vazia, o valor opcional de default será retornado.

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.

Retorna a menor linha do table , dado o comparisonCriteria . Se a tabela estiver vazia, o valor opcional de default será retornado.

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.

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. Atualmente, esse recurso destina-se apenas ao uso interno. Exemplo Una duas tabelas usando uma coluna de chave. Usage Power Query M Table.NestedJoin( Table.FromRecords({ [CustomerToCall = 1], [CustomerToCall = 3] }), {"CustomerToCall"}, Table.FromRecords({ [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"}, "CustomerDetails" ) Saída Power Query M Table.FromRecords({ [CustomerToCall = 1, CustomerDetails = Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]})], [CustomerToCall = 3, CustomerDetails = Table.FromRecords({[CustomerID = 3, Name = "Paul", Phone = "543-7890"]})] }) Conteúdo relacionado Junte-se ao tipo Last updated on 04/04/2026

Particiona em table uma lista de número de groups tabelas, com base no valor da função e da column hash função. A hash função é aplicada ao valor da column linha para obter um valor de hash para a linha. O modulo groups de valor de hash determina em qual das tabelas retornadas a linha será colocada. table : a tabela a ser particionada. column : a coluna a ser hash para determinar em qual tabela retornada a linha está. groups : o número de tabelas em que 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 2 tabelas na coluna [a], usando o valor das colunas como a função de hash. Usage Power Query M Table.Partition( Table.FromRecords({ [a = 2, b = 4], [a = 1, b = 4], [a = 2, b = 4], [a = 1, b = 4] }), "a", 2, each _ ) Saída Power Query M { Table.FromRecords({ [a = 2, b = 4], [a = 2, b = 4] }), Table.FromRecords({ [a = 1, b = 4], [a = 1, b = 4] }) } Last updated on 25/03/2026

Retorna a chave de partição da tabela especificada.

Retorna informações sobre como uma tabela é particionada. Uma tabela é retornada onde cada coluna é uma coluna de partição na tabela original e cada linha corresponde a uma partição na tabela original. Last updated on 22/11/2025

Dado um par de colunas que representam pares de atributo/valor, gira os dados na coluna de atributo para um título de coluna.

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 quais ocorrências da linha retornar. equationCriteria : (Opcional) Controla a comparação entre as linhas da tabela.

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 quais ocorrências da linha retornar. equationCriteria : (Opcional) Controla a comparação entre as linhas da tabela.

Retorna uma tabela em que todos os nomes de coluna do table fornecido são prefixados com o texto fornecido, prefix além de um período no formulário prefix.ColumnName . Exemplo Prefixe as colunas com "MyTable" na tabela. Usage Power Query M Table.PrefixColumns( Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}), "MyTable" ) Saída Table.FromRecords({[MyTable.CustomerID = 1, MyTable.Name = "Bob", MyTable.Phone = "1234567"]}) Last updated on 04/04/2026