Operadores

  • Artigo

A linguagem de fórmula do Power Query M inclui um conjunto de operadores que podem ser utilizados numa 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 de operando. A linguagem tem os seguintes operadores:

Operador Plus (+)

Expression igual a
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 combinado (&)

Function igual a
"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, date, datetime, datetimezone, duration, text, binary)

Operator Description
> Maior que
>= Maior ou igual a
< Menor que
<= Menor ou igual a
= Igual
<> Não é igual a

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

Operator Description
ou Lógica condicional OU
e Lógica condicional E
not Lógico NÃO

Número de operadores (Além dos operadores comuns)

Operator Description
+ Sum
- Diferença
* Produto
/ Quociente
+x Unário mais
-x Negação

Operadores de texto (Além de operadores comuns)

Operator Description
& Concatenação

Operadores de lista, registo, tabela

Operator Description
= Igual
<> Não é igual a
& Concatenação

Operador de pesquisa de registros

Operator Description
[] Aceda aos campos de um registo por nome.

Operador de indexador de lista

Operator Description
{} Acesse um item em uma lista por seu índice numérico baseado em zero.

Operadores de compatibilidade e asserção de tipo

Operator Description
é 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 hora duration Data compensada pela duração
x + y duration hora Data compensada pela duração
x - y hora duration Data compensada pela duração negada
x - y hora hora Duração entre datas
x & y data hora Data/hora mesclada

Operadores de data/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 fuso data/hora

Operador Operando esquerdo Operando direito Significado
x + y Fuso DataTimeF duration Deslocamento de fuso horário de data por duração
x + y duration Fuso DataTimeF Deslocamento de fuso horário de data por duração
x - y Fuso DataTimeF duration Fuso horário de data compensado pela duração negada
x - y Fuso DataTimeF Fuso DataTimeF Duração entre fusos data-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

Nota

Nem todas as combinações de valores podem ser suportadas por um operador. Expressões que, quando avaliadas, encontram condições de operador indefinidas avaliam erros. Para obter mais informações sobre erros em M, vá para Erros

Exemplo de erro:

Function igual a
1 + "2" Erro: adicionar número e texto não é suportado