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 nulo, lógico, número, tempo, data, data e hora, fuso horário, duração, texto, binário)

Operador	Descrição
>	Maior que
>=	Maior ou igual
<	Menos de
<=	Menor ou igual
=	Igual
<>	Não é igual

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

Operador	Descrição
ou	Lógica condicional OU
e ainda	Lógica condicional E
não	Lógico NÃO

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
é	A expressão x é 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.
como	A expressão x como y afirma que o valor x é compatível com y de acordo com o operador is.

Operadores de data

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

Operadores de data e hora

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

Operadores de Datetimezone

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

Operadores de duração

Operador	Operando esquerdo	Operando direito	Significado
x + y	datetime	Duração	Deslocamento de data/hora por um período de tempo
x + y	Duração	data e hora	Data/hora ajustada pela duração
x + y	Duração	Duração	Soma das durações
x - y	data e hora	Duração	Data/hora compensada pela duração negada
x - y	data e hora	data e hora	Duração entre datetimes
x - y	Duração	Duração	Diferença de durações
x * y	Duração	número	N vezes uma duração
x * y	número	Duração	N vezes uma duração
x / y	Duração	número	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