Ler em inglês

Compartilhar via


Operadores

A linguagem de fórmula Power Query M inclui um conjunto de operadores que podem ser usados em uma expressão. Os operadores são aplicados a operandos para formar expressões simbólicas. Por exemplo, na expressão 1 + 2, os números 1 e 2 são operandos e o operador é o operador de adição (+).

O significado de um operador pode variar dependendo do tipo de valores do operando. A linguagem tem os seguintes operadores:

Operador de adição (+)

Expression Igual a
1 + 2 Adição numérica: 3
#time(12,23,0) + #duration(0,0,2,0) Aritmética de tempo: #time(12,25,0)

Operador de combinação (&)

Função Igual a
"A" & "BC" Concatenação de texto: "ABC"
{1} & {2, 3} Concatenação de lista: {1, 2, 3}
[ a = 1 ] & [ b = 2 ] Mesclagem de registro: [ a = 1, b = 2 ]

Lista de operadores M

Operadores comuns que se aplicam a nulo, lógico, número, hora, data, datetime, datetimezone, duração, texto, binário)

Operador Descrição
> Maior que
>= Maior ou igual
< Menor que
<= Inferior ou igual
= Igual
<> Diferente

Operadores lógicos (além de Operadores comuns)

Operador Descrição
ou OR lógico condicional
e AND lógico condicional
not NOT lógico

Operadores numéricos (além de Operadores comuns)

Operador Descrição
+ Soma
- Diferença
* Produto
/ Quociente
+x Adição de unário
-X Negação

Operadores de texto (além de Operadores comuns)

Operador Descrição
& Concatenação

Operadores de lista, registro, tabela

Operador Descrição
= Igual
<> Diferente
& Concatenação

Operador de pesquisa de registro

Operador Descrição
[] Acesse os campos de um registro por nome.

Operador do indexador de lista

Operador Descrição
{} Acesse um item em uma lista pelo índice numérico baseado em zero.

Compatibilidade de tipos e operadores de asserção

Operador Descrição
is A expressão x is y retornará true se o tipo de x for compatível com y e retornará false se o tipo de x não for compatível com y.
as A expressão x as y assegura que o valor de x seja compatível com y de acordo com o operador is.

Operadores de data

Operador Operando Esquerdo Operando Direito Significado
x + y time duration Deslocamento de Date por duração
x + y duration time Deslocamento de Date por duração
x - y time duration Deslocamento de data por duração negada
x - y time time Duração entre datas
x & y date time Data/hora mescladas

Operadores datetime

Operador Operando Esquerdo Operando Direito Significado
x + y DATETIME duration Deslocamento de data/hora por duração
x + y duration DATETIME Deslocamento de data/hora por duração
x - y DATETIME duration Deslocamento de Datetime por duração negada
x - y DATETIME DATETIME Duração entre datetimes

Operadores datetimezone

Operador Operando Esquerdo Operando Direito Significado
x + y datetimezone duration Deslocamento DateTimeZone por duração
x + y duration datetimezone Deslocamento DateTimeZone por duração
x - y datetimezone duration Deslocamento de datetimezone por duração negada
x - y datetimezone datetimezone Duração entre datetimezones

Operadores de duração

Operador Operando Esquerdo Operando Direito Significado
x + y DATETIME duration Deslocamento de data/hora por duração
x + y duration DATETIME Deslocamento de data/hora por duração
x + y duration duration Soma das durações
x - y DATETIME duration Deslocamento de Datetime por duração negada
x - y DATETIME DATETIME Duração entre datetimes
x - y duration duration Diferença de durações
x * y duration número N vezes uma duração
x * y número duration N vezes uma duração
x / y duration número Fração de uma duração

Observação

Um operador pode não ter suporte para todas as combinações de valores. As expressões que, quando avaliadas, encontram condições de operador indefinidas são avaliadas como erros. Para obter mais informações sobre erros em M, acesse Erros

Exemplo de erro:

Função Igual a
1 + "2" Erro: não há suporte para adicionar número e texto