Operadores
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:
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) |
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 ] |
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 |