Operadores

A linguagem de fórmula do Power Query M inclui um conjunto de operadores que podem ser utilizados numa expressão. 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 de operando. A linguagem 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 do 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 listas: {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, datedatetimedatetimezonedurationtext,binary

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

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

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

Operadores Numéricos (Além de Operadores Comuns)

Operador	Descrição
+	Soma
-	Diferença
*	Produto
/	Quociente
+x	Unário mais
-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
<>	Não é igual
&	Concatenação

Operador de pesquisa de registros

Operador	Descrição
[]	Aceda aos campos de um registo por nome.

Operador de 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 x is y retorna true se o tipo de x é compatível com y, e retorna false se o tipo de x não é compatível com y.
as	A expressão x as y afirma que o valor x é compatível com o operador de acordo com y o is operador.

Operadores de data

Operador	Operando esquerdo	Operando direito	Significado
x + y	time	duration	Data ajustada pela duração
x + y	duration	time	Data ajustada pela duração
x - y	time	duration	Data ajustada por duração negativa
x - y	time	time	Duração entre datas
x & y	date	time	Data/hora mesclada

Operadores de data e hora

Operador	Operando esquerdo	Operando direito	Significado
x + y	datetime	duration	Data/hora deslocada por duração
x + y	duration	datetime	Data/hora deslocada por duração
x - y	datetime	duration	Data/hora compensada pela duração negada
x - y	datetime	datetime	Duração entre datetimes

Operadores de Datetimezone

Operador	Operando esquerdo	Operando direito	Significado
x + y	datetimezone	duration	Deslocamento de fuso horário de data por duração
x + y	duration	datetimezone	Deslocamento de fuso horário de data por duração
x - y	datetimezone	duration	Fuso horário de data compensado pela duração negada
x - y	datetimezone	datetimezone	Duração entre zonas de data e hora

Operadores de duração

Operador	Operando esquerdo	Operando direito	Significado
x + y	datetime	duration	Data/hora deslocada por duração
x + y	duration	datetime	Data/hora deslocada por duração
x + y	duration	duration	Soma das durações
x - y	datetime	duration	Data/hora compensada pela 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 indefinidas de operador resultam em erros. Para obter mais informações sobre erros em M, vá para Erros

Exemplo de erro:

Função	Igual
1 + "2"	Erro: não é possível adicionar número a texto