Referência de fórmula para o Power Apps

Nota

Já verificou o novo Microsoft Power Fx?

As fórmulas combinam muitos elementos. Abaixo, encontram-se descritos:

• As funções aceitam parâmetros, executam uma operação e devolvem um valor. Por exemplo, Sqrt(25) devolve 5. As funções são modeladas após as funções do Microsoft Excel. Algumas funções têm efeitos secundários, tais como SubmitForm, que são adequadas apenas numa fórmula de comportamento como Button.OnSelect.
• Os sinais devolvem informações sobre o ambiente. Por exemplo, Location devolve as coordenadas GPS atuais do dispositivo. Os sinais não aceitam parâmetros nem têm efeitos secundários.
• As enumerações devolvem um valor constante predefinido. Por exemplo, Cor é uma enumeração que tem valores predefinidos para Color.Red, Color.Blue, etc. As enumerações comuns são incluídas aqui; as enumerações específicas de uma função são descritas com a função.
• Os operadores com nome, como ThisItem e Self, proporcionam acesso a informações de um contentor.

Outros elementos incluem:

• Operadores e identificadores
• Controlos e as respetivas propriedades
• Tipos de dados

A

Abs – valor absoluto de um número.

Acceleration – lê o sensor de aceleração no seu dispositivo.

Acos – devolve o arco de cosseno de um número, em radianos.

Acot – devolve o arco tangente de um número, em radianos.

AddColumns – devolve uma tabela com colunas adicionadas.

And – o valor lógico booleano AND. Devolve true se todos os argumentos forem verdadeiros. Também pode utilizar o operador &&.

App – fornece informações sobre a aplicação a ser atualmente executada e permite controlar o comportamento da mesma.

Asin – devolve o arco de seno de um número, em radianos.

Assert – avalia se algo é verdadeiro ou falso num teste.

As – atribui um nome ao registo atual nas funções de galeria, formulário e âmbito de registo, tais como ForAll, With e Sum.

AsType – Trata a referência de um registo como um tipo de tabela específico.

Atan – devolve o arco de tangente de um número, em radianos.

Atan2 – devolve o arco de tangente com base numa coordenada (x,y), em radianos.

Average – calcula a média de uma expressão de tabela ou conjunto de argumentos.

B

Back – mostra o ecrã anterior.

Blank – devolve um valor em branco que pode ser utilizado para inserir um valor NULO numa origem de dados.

C

Calendar – obtém informações sobre o calendário para a região atual.

Char – converte um código do caráter numa cadeia.

Choices – devolve uma tabela com os valores possíveis de uma coluna de pesquisa.

Clear – elimina todos os dados de uma coleção.

ClearCollect – elimina todos os dados de uma coleção e, em seguida, adiciona um conjunto de registos.

ClearData – Limpa uma coleção ou todas as coleções de um host de aplicações como um dispositivo local.

Clock –obtém as informações sobre o relógio para a região atual.

Coalesce – substitui os valores em branco, mantendo os valores que não estão em branco inalterados.

Collect – cria uma coleção ou adiciona dados a uma origem de dados.

Color – define uma propriedade para um valor de cor incorporado.

ColorFade – desvanece um valor de cor.

ColorValue – converte um nome de cor CSS ou um código hexadecimal num valor de cor.

Compass – devolve o cabeçalho de bússola.

Concat – concatena cadeias numa origem de dados.

Concatenate – concatena cadeias.

Concurrent – avalia múltiplas fórmulas em simultâneo.

Connection – devolve informações sobre a ligação de rede.

Count – conta os registos de tabela que contêm números.

Cos – devolve o cosseno de um ângulo especificado em radianos.

Cot – devolve a cotangente de um ângulo especificado em radianos.

CountA – conta os registos de tabela que não estão vazios.

CountIf – conta os registos de tabela que satisfazem uma condição.

CountRows – conta os registos de tabela.

D

DataSourceInfo – fornece informações sobre uma origem de dados.

Date – devolve um valor de data/hora, com base nos valores de Ano, Mês e Dia.

DateAdd – adiciona dias, meses, trimestres ou anos a um valor de data/hora.

DateDiff – subtrai dois valores de data e mostra o resultado em dias, meses, trimestres ou anos.

DateTimeValue – converte uma cadeia de data e hora num valor de data/hora.

DateValue – converte uma cadeia só de data num valor de data/hora.

Day – obtém a parte do dia de um valor de data/hora.

Defaults – devolve os valores predefinidos para uma origem de dados.

Degrees – converte radianos em graus.

Disable – desativa um sinal, tal como Location para ler o GPS.

Distinct – resume os registos de uma tabela, removendo os duplicados.

Download – transfere um ficheiro da Web para o dispositivo local.

DropColumns – devolve uma tabela com uma ou mais colunas removidas.

E

EditForm – repõe um controlo de formulário para a edição de um item.

Enable – ativa um sinal, tal como Location para ler o GPS.

EncodeUrl – codifica carateres especiais com codificação do URL.

EndsWith – Verifica se uma cadeia de texto termina com outra cadeia de texto.

Error – Cria um erro personalizado ou transmita um erro.

Errors – Fornece informações de erro relativas a alterações anteriores a uma origem de dados.

exactin – verifica se uma cadeia de texto está contida noutra cadeia de texto ou tabela, dependente de maiúsculas/minúsculas. Também usado para verificar se um registo está numa tabela.

Exit – sai da aplicação actualmente em execução e opcionalmente autentica o utilizador actual.

Exp – devolve e elevado a uma potência.

F

Filter – devolve uma tabela filtrada com base em um ou mais critérios.

Find – verifica se uma cadeia é apresentada dentro de outra e devolve a localização.

First – devolve o primeiro registo de uma tabela.

FirstN – devolve o primeiro conjunto de registos (N registos) de uma tabela.

ForAll – calcula valores e realiza ações para todos os registos de uma tabela.

G

GroupBy – devolve uma tabela com registos agrupados.

GUID – converte uma cadeia GUID num valor GUID ou cria um novo valor GUID.

H

HashTags – extrai as hashtags (#cadeias) de uma cadeia.

Hour – devolve a parte da hora de um valor de data/hora.

I

If – devolve um valor se uma condição for verdadeira e outro valor se não for.

IfError – deteta erros e fornece um valor alternativo ou efetua uma ação.

in – Verifica se uma cadeia de texto está contida noutra cadeia de texto ou tabela, independente de maiúsculas/minúsculas. Também usado para verificar se um registo está numa tabela.

Index – Devolve um registo de uma tabela baseada na posição solicitada.

Int – Arredonda um valor para baixo até ao número inteiro mais próximo.

IsBlank – Verifica a existência de um valor em branco.

IsBlankOrError – Verifica se existe um valor ou erro em branco.

IsEmpty – verifica a existência de uma tabela vazia.

IsError – verifica a existência de um erro.

IsMatch – verifica uma cadeia em relação a um padrão. Podem ser utilizadas expressões regulares.

IsNumeric – verifica a existência de um valor numérico.

ISOWeekNum – Devolve o número da semana ISO de um valor de data/hora.

IsToday – verifica se um valor de data/hora é em algum momento de hoje no fuso horário do utilizador.

IsType – Verifica se a referência de um registo se refere a um tipo de tabela específico.

IsUTCToday – verifica se um valor de data/hora é em algum momento de hoje em Hora Universal Coordenada (UTC).

J

JSON – gera uma cadeia de texto JSON para uma tabela, registo ou valor.

L

Language – devolve a etiqueta de idioma do utilizador atual.

Last – devolve o último registo de uma tabela.

LastN – devolve o último conjunto de registos (N registos) de uma tabela.

Launch – lança uma página Web ou uma aplicação de tela.

Left – devolve a parte mais à esquerda de uma cadeia.

Len – devolve o comprimento de uma cadeia.

Ln – devolve o registo natural.

LoadData – Carrega uma coleção de um host de aplicações como um dispositivo local.

Location – obtém a sua localização como uma coordenada de mapa através do GPS (Global Positioning System) e outras informações.

Log – obtém o logaritmo natural em qualquer base de um número.

LookUp – procura um único registo numa tabela com base em um ou mais critérios.

Lower – converte as letras de uma cadeia de texto em letras minúsculas.

M

Match – extrai uma subcadeia com base num padrão. Podem ser utilizadas expressões regulares.

MatchAll – extrai múltiplas subcadeias com base num padrão. Podem ser utilizadas expressões regulares.

Max – valor máximo de uma expressão de tabela ou um conjunto de argumentos.

Mid – devolve a parte do meio de uma cadeia.

Min – valor mínimo de uma expressão de tabela ou um conjunto de argumentos.

Minute – obtém a parte do minuto de um valor de data/hora.

Mod – devolve o resto depois de um dividendo ser dividido por um divisor.

Month – obtém a parte do mês de um valor de data/hora.

N

Navigate – altera o ecrã que é apresentado.

NewForm – repõe um controlo de formulário para a criação de um item.

Not – o valor lógico booleano NOT. Devolve true se o respetivo argumento for falso e devolve false se o respetivo argumento for verdadeiro. Também pode utilizar o operador !.

Notify – apresenta uma mensagem em faixa ao utilizador.

Now – devolve o valor de data/hora atual no fuso horário do utilizador.

O

Or – o valor lógico booleano OR. Devolve true se qualquer um dos respetivos argumentos for verdadeiro. Também pode utilizar o operador ||.

P

Param – parâmetros de acesso transmitidos a uma aplicação de tela quando iniciados.

Parent – proporciona acesso às propriedades de um controlo de recipiente.

Patch – modifica ou cria um registo numa origem de dados ou une registos fora de uma origem de dados.

Pi – devolve o número π.

PlainText – remove etiquetas HTML e XML de uma cadeia.

Power – devolve um número elevado a uma potência. Também pode utilizar o operador ^.

Proper – converte a primeira letra de cada palavra numa cadeia em maiúsculas e converte o resto em minúsculas.

R

Radians – Converte graus em radianos.

Rand – Devolve um número pseudoaleatório entre 0 e 1.

RandBetween – Devolve um número pseudoaleatório entre dois números.

ReadNFC – Lê uma etiqueta de comunicação de campo próximo (NFC).

RecordInfo – Fornece informações sobre um registo de uma origem de dados.

Refresh – atualiza os registos de uma origem de dados.

Relate – Associa os registos de duas tabelas através de uma relação um-para-muitos ou muitos-para-muitos.

Remove – remove um ou mais registos específicos de uma origem de dados.

RemoveIf – remove registos de uma origem de dados com base numa condição.

RenameColumns – muda o nome de colunas de uma tabela.

Replace – substitui parte de uma cadeia por outra cadeia, pela posição inicial da cadeia.

RequestHide – oculta um formulário do SharePoint.

Reset – repõe o valor predefinido de um controlo de entrada, eliminando quaisquer alterações do utilizador.

ResetForm – repõe um controlo de formulário para a edição de um item existente.

Revert – recarrega e limpa os erros dos registos de uma origem de dados.

RGBA – devolve um valor de cor para um conjunto de componentes vermelho, verde, azul e alfa.

Right – devolve a parte mais à direita de uma cadeia.

Round – arredonda para o número mais próximo.

RoundDown – arredonda para baixo até ao número anterior maior.

RoundUp – arredonda para cima até ao número seguinte mais pequeno.

S

SaveData – Guarda uma coleção para um host de aplicações como um dispositivo local.

Search – localiza registos numa tabela que contêm uma cadeia numa das respetivas colunas.

Second – obtém a segunda parte de um valor de data/hora.

Select – simula uma ação de seleção num controlo e faz com que a fórmula OnSelect seja avaliada.

Self – Dá acesso às propriedades do controlo atual.

Sequence – gera uma tabela de números sequenciais, útil quando é feita a iteração com ForAll.

Set – define o valor de uma variável global.

SetFocus – move o foco de introdução para um controlo específico.

SetProperty – simula interações com controlos de introdução.

ShowColumns – devolve uma tabela apenas com as colunas selecionadas.

Shuffle – reordena de forma aleatória os registos de uma tabela.

Sin – devolve o seno de um ângulo especificado em radianos.

Sort – devolve uma tabela ordenada com base numa fórmula.

SortByColumns – devolve uma tabela ordenada com base em uma ou mais colunas.

Split – divide uma cadeia de texto numa tabela de subcadeias.

Sqrt – devolve a raiz quadrada de um número.

StartsWith – verifica se uma cadeia de texto começa com outra cadeia de texto.

StdevP – devolve o desvio padrão dos respetivos argumentos.

Substitute – substitui parte de uma cadeia por outra cadeia, por cadeias correspondentes.

SubmitForm – guarda o item de um controlo de formulário numa origem de dados.

Sum – calcula a soma de uma expressão de tabela ou conjunto de argumentos.

Switch – faz a correspondência com um conjunto de valores e, em seguida, avalia uma fórmula correspondente.

T

Table – cria uma tabela temporária.

Tan – devolve a tangente de um ângulo especificado em radianos.

Text – converte qualquer valor e formata um valor de número ou data/hora numa cadeia de texto.

ThisItem – devolve o registo para o item atual numa galeria ou controlo de formulário.

ThisRecord – devolve o registo para o item atual numa função de âmbito de registo, tal como ForAll, With e Sum.

Time – devolve um valor de data/hora, com base nos valores de Hora, Minuto e Segundo.

TimeValue – converte uma cadeia só de hora num valor de data/hora.

TimeZoneOffset – devolve a diferença entre UTC e a hora local do utilizador em minutos.

Today – devolve o valor de apenas data atual.

Trace – fornece informações adicionais nos resultados do seu teste.

Trim – remove os espaços extra das extremidades e do interior de uma cadeia de texto.

TrimEnds – remove os espaços extra das extremidades de uma cadeia só de texto.

Trunc – Trunca o número apenas para a parte de número inteiro, removendo qualquer porção decimal.

U

Ungroup – remove um agrupamento.

Unrelate – Desassocia os registos de duas tabelas de uma relação um-para-muitos ou muitos-para-muitos.

Update – substitui um registo numa origem de dados.

UpdateContext – define o valor de uma ou mais variáveis de contexto do ecrã atual.

UpdateIf – modifica um conjunto de registos numa origem de dados com base numa condição.

Upper – converte as letras de uma cadeia de texto em letras maiúsculas.

User – devolve informações sobre o utilizador atual.

UTCNow – devolve o valor de data/hora atual na Hora Universal Coordenada (UTC).

UTCToday – devolve o valor de apenas data atual na Hora Universal Coordenada (UTC).

V

Validate – verifica se o valor de uma única coluna ou de um registo completo é válido para uma origem de dados.

Value – converte uma cadeia num número.

VarP – devolve a variância dos respetivos argumentos.

ViewForm – repõe um controlo de formulário para a visualização de um item existente.

W

Weekday – obtém a parte do dia da semana de um valor de data/hora.

WeekNum – Devolve o número da semana de um valor de data/hora.

With – calcula valores e realiza ações num único registo, incluindo registos inline de valores com nome.

Y

Year – obtém a parte do ano de um valor de data/hora.

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).