Operadores

A linguagem de fórmula do 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 os operandos e o operador é o operador de adição (+).

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

Operador plus (+)

Expressão	Igual
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" & "BC"	Concatenação de texto: "ABC"
{1} & {2, 3}	Concatenação de lista: {1, 2, 3}
[ a = 1 ] & [ b = 2 ]	Mesclagem de registros: [ a = 1, b = 2 ]

Lista de operadores M

Operadores comuns que se aplicam a null, logical, , number, time, date, datetime, datetimezone, , duration, , , textbinary

Operador	Descrição
>	Maior que
>=	Maior ou igual
<	Menor que
<=	Inferior ou igual
=	Igual
<>	Não igual
??	Operador de coalescência nula

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

Operador	Descrição
or	Lógico condicional OR
and	Lógico condicional AND
not	Lógico NOT

Operadores de número (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

Listar, gravar, operadores de tabela

Operador	Descrição
=	Igual
<>	Não igual
&	Concatenação

Operador de consulta de registro

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

Operador indexador de lista

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

Operadores de compatibilidade e asserção de tipo

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

Operadores de data

Operador	Operando Esquerdo	Operando Direito	Significado
x + y	time	duration	Deslocamento de data por duração
x + y	duration	time	Deslocamento de data 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 de data e hora

Operador	Operando Esquerdo	Operando Direito	Significado
x + y	datetime	duration	Deslocamento de datetime por duração
x + y	duration	datetime	Deslocamento de datetime 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 de datetimezone por duração
x + y	duration	datetimezone	Deslocamento de 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 datetime por duração
x + y	duration	datetime	Deslocamento de datetime 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	number	N vezes uma duração
x * y	number	duration	N vezes uma duração
x / y	duration	number	Fração de uma duração

Observação

Nem todas as combinações de valores podem ser suportadas por um operador. 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
1 + "2"	Erro: não há suporte para adicionar número e texto