Referência de fórmula - Power Apps

Neste artigo, conheça todas as funções disponíveis no Power Apps.

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

  • As funções aceitam parâmetros, executam uma operação e obtém 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 obtêm 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 obtêm 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:

A

Abs – valor absoluto de um número.

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

Acos – obtém o arco de cosseno de um número, em radianos.

Acot – obtém o arco tangente de um número, em radianos.

AddColumns – obtém 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 &&.

AIClassify – Classifica o texto numa ou mais categorias.

AIExtract – Extrai entidades especificadas, tais como números de registo, números de telefone ou nomes de pessoas.

AIReply – Redige um rascunho de uma resposta à mensagem que forneceu.

AISentiment – Deteta o sentimento do texto fornecido.

AISummarize – Resume o texto fornecido.

AITranslate – Traduz texto de outro idioma.

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

Asin – obtém 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 – obtém o arco de tangente de um número, em radianos.

Atan2 – obtém 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 – obtém um valor em branco que pode ser utilizado para inserir um valor NULO numa origem de dados.

Boolean – Converte uma cadeia de texto, número ou valor sem tipo para um valor booleano.

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 – obtém 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.

Column – Obtém os nomes e valores das colunas de um Tipo de dados objeto sem tipo.

ColumnNames – Obtém os nomes e valores das colunas de um Tipo de dados objeto sem tipo.

Compass – obtém 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 – obtém informações sobre a ligação de rede.

Copiar – Copia texto para a área de transferência do dispositivo em que a aplicação está em execução.

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

Cos – obtém o cosseno de um ângulo especificado em radianos.

Cot – obtém 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 – obtém 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.

DateTime — devolve um valor de data/hora, com base nos componentes de data e hora.

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.

Dec2Hex — converte um número numa cadeia de texto hexadecimal.

Defaults – obtém 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 – obtém uma tabela com uma ou mais colunas removidas.

E

EDate — adiciona ou subtrai meses a uma data, sem alterar o dia do mês.

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.

EOMonth — adiciona ou subtrai meses a uma data, devolvendo o último dia do mês.

Erro – Crie 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 atualmente em execução e opcionalmente autentica o utilizador atual.

Exp — devolve e elevado a uma potência.

F

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

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

First – obtém o primeiro registo de uma tabela.

FirstN – obtém 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 – obtém 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.

Hex2Dec — converte uma cadeia de texto hexadecimal num número.

Anfitrião – Fornece informações sobre o anfitrião atual que está a executar a aplicação.

Hour – obtém a parte da hora de um valor de data/hora.

I

If – obtém 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 – obtém 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 – obtém 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 – obtém a etiqueta de idioma do utilizador atual.

Last – obtém o último registo de uma tabela.

LastN – obtém o último conjunto de registos (N registos) de uma tabela.

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

Left – obtém a parte mais à esquerda de uma cadeia.

Len – obtém o comprimento de uma cadeia.

Ln – obtém 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 – obtém 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 – obtém 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 – obtém 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.

ParseJSON – Converte o documento JSON representado como texto num valor de Objeto sem tipo.

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

PDF – Exporte conteúdos do ecrã atual para um objeto para utilização em vários cenários.

Pi – obtém o número π.

PlainText – remove etiquetas HTML e XML de uma cadeia.

Power – obtém 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 – obtém 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 – obtém um valor de cor para um conjunto de componentes vermelho, verde, azul e alfa.

Right – obtém 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.

SendAppNotification (pré-visualização) – Enviar uma notificação na aplicação com ações opcionais a um destinatário.

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 – obtém uma tabela apenas com as colunas selecionadas.

ShowHostInfo – Apresenta informações para o utilizador da aplicação.

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

Sin – obtém o seno de um ângulo especificado em radianos.

Sort – obtém uma tabela ordenada com base numa fórmula.

SortByColumns – obtém uma tabela ordenada com base em uma ou mais colunas.

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

Sqrt – obtém a raiz quadrada de um número.

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

StdevP – obtém 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 – obtém o registo para o item atual numa galeria ou controlo de formulário.

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

Time – obtém 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 – obtém a diferença entre UTC e a hora local do utilizador em minutos.

Today – obtém 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.

UniChar – Converte um código Unicode numa cadeia.

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 – obtém informações sobre o utilizador atual.

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

UTCToday – obtém 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 – obtém 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 – obtém 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.