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 vários elementos. São mostrados abaixo:
- Funções aceitam parâmetros, executam uma operação e retornam um valor. Por exemplo, Sqrt(25) retorna 5. As funções são modeladas de acordo com as funções do Microsoft Excel. Algumas funções têm efeitos colaterais, como SubmitForm, que são apropriadas apenas em uma fórmula de comportamento, como Button.OnSelect.
- Sinais retornam informações sobre o ambiente. Por exemplo, Location retorna as coordenadas de GPS atuais do dispositivo. Sinais não usam parâmetros nem têm efeitos colaterais.
- Enumerações retornam um valor constante predefinido. Por exemplo, Color é uma enumeração que tem valores predefinidos para Color.Red, Color.Blue e assim por diante. As enumerações comuns são incluídas aqui; enumerações específicas de função são descritas com a função.
- Operadores chamados, como ThisItem e Auto, fornecem acesso a informações de dentro de um contêiner.
Outros elementos incluem:
A
Abs – valor absoluto de um número.
Acceleration – lê o sensor de aceleração em seu dispositivo.
Acos – retorna o arco cosseno de um número, em radianos.
Acot – retorna o arco tangente de um número, em radianos.
AddColumns – retorna uma tabela com colunas adicionadas.
And – operador lógico booliano AND. Retornará true se todos os argumentos forem true. Você também pode usar o operador &&.
AIClassify – classifica o texto em uma ou mais categorias.
AIExtract – extrai entidades especificadas, como números de registro, números de telefone ou nomes de pessoas.
AIReply – elabora uma resposta para a mensagem que você forneceu.
AISentiment – detecta o sentimento do texto que você fornece.
AISummarize – resume o texto que você fornece.
AITranslate – traduz texto de outro idioma.
App – fornece informações sobre o aplicativo em execução no momento e o controle sobre o comportamento do aplicativo.
Asin – retorna o arco seno de um número, em radianos.
Assert – avalia como verdadeiro ou falso em um teste.
As – nomeia o registro atual em funções de galeria, formulário e escopo de registro, como ForAll, With e Sum.
AsType – trata uma referência de registro como um tipo de tabela específico.
Atan – retorna o arco tangente de um número, em radianos.
Atan2 – retorna o arco tangente com base em uma coordenada (x,y), em radianos.
Average – calcula a média de uma expressão de tabela ou de um conjunto de argumentos.
B
Back – exibe a tela anterior.
Blank – retorna um valor em branco que pode ser usado para inserir um valor NULL em uma fonte de dados.
Boolean – converte um valor de cadeia de caracteres de texto, número ou sem tipo em um valor booliano.
C
Calendar – recupera informações sobre o calendário para a localidade atual.
Char – converte um código de caracteres em uma cadeia de caracteres.
Choices – retorna uma tabela com os valores possíveis para uma coluna de pesquisa.
Clear – exclui todos os dados de uma coleção.
ClearCollect – exclui todos os dados de uma coleção e, em seguida, adiciona um conjunto de registros.
ClearData – apaga uma coleção ou todas as coleções de um host de aplicativo, como um dispositivo local.
Clock – recupera informações sobre o relógio para a localidade atual.
Coalesce – substitui valores em branco, deixando os valores não em branco inalterados.
Collect – cria uma coleção ou adiciona dados a uma fonte de dados.
Color – define uma propriedade como um valor de cor interno.
ColorFade – atenua um valor de cor.
ColorValue – converte um nome de cor CSS ou um código hexadecimal para um valor de cor.
Coluna – recupera nomes de colunas e valores de um Tipo de dados de objeto sem tipo.
ColumnNames – recupera nomes de colunas e valores de um Tipo de dados de objeto sem tipo.
Compass – retorna o título da bússola.
Concat – concatena as cadeias de caracteres em uma fonte de dados.
Concatenate – concatena cadeias de caracteres.
Concurrent – avalia várias fórmulas simultaneamente entre si.
Connection – retorna informações sobre a conexão de rede.
Copiar – Copia o texto para a área de transferência no dispositivo em que o aplicativo está sendo executado.
Count – conta registros da tabela que contêm números.
Cos – retorna o cosseno de um ângulo especificado em radianos.
Cot – retorna o cotangente de um ângulo especificado em radianos.
CountA – conta os registros da tabela que não estão vazios.
CountIf – conta registros da tabela que atendem a uma condição.
CountRows – conta registros da tabela.
D
DataSourceInfo – fornece informações sobre uma fonte de dados.
Date – retorna um valor de data/hora, com base nos valores de Year, Month e Day.
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 - retorna um valor de data/hora, com base em valores de Hora, Minuto e Segundo.
DateTimeValue – converte uma cadeia de caracteres de data e hora em um valor de data/hora.
DateValue – converte uma cadeia de caracteres somente data em um valor de data/hora.
Day – recupera a parte do dia de um valor de data/hora.
Dec2Hex – Converte um número em uma cadeia de caracteres de texto hexadecimal.
Defaults – retorna os valores padrão para uma fonte de dados.
Degrees – Converte radianos em graus.
Disable – desabilita um sinal, como Location para ler o GPS.
Distinct – resume os registros de uma tabela, removendo duplicatas.
Download – baixa um arquivo da Web para o dispositivo local.
DropColumns – retorna 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 – redefine um controle de formulário para edição de um item.
Enable – habilita um sinal, como um Location para ler o GPS.
EncodeUrl – codifica caracteres especiais usando a codificação de URL.
EndsWith – verifica se uma cadeia de texto termina com outra cadeia de texto.
EOMonth – Adiciona ou subtrai meses a uma data, retornando o último dia desse mês.
Erro – crie um erro personalizado ou passe um erro.
Errors – fornece informações de erro para alterações anteriores em uma fonte de dados.
exactin – Verifica se uma cadeia de texto está contida em outra cadeia de texto ou tabela, dependendo de maiúsculas/minúsculas. Também é usado para verificar se um registro está em uma tabela.
Exit – sai do aplicativo em execução no momento e, opcionalmente, desconecta o usuário atual.
Exp – Retorna e elevado a uma potência.
F
Filter – retorna uma tabela filtrada com base em um ou mais critérios.
Find – verifica se uma cadeia de caracteres aparece dentro de outra e retorna o local.
First – retorna o primeiro registro de uma tabela.
FirstN – retorna o primeiro conjunto de registros (N registros) de uma tabela.
ForAll – calcula valores e executa ações para todos os registros de uma tabela.
G
GroupBy – retorna uma tabela com registros agrupados juntos.
GUID – converte uma cadeia de caracteres de GUID em um valor de GUID ou cria um valor de GUID.
H
HashTags – extrai as hashtags (#strings) de uma cadeia de caracteres.
Hex2Dec – Converte um uma cadeia de caracteres de texto hexadecimal em um número.
Host - Fornece informações sobre o host atual que está executando o aplicativo.
Hour – retorna a parte de hora de um valor de data/hora.
I
If – retorna um valor se uma condição for verdadeira e outro valor se não for.
IfError – Detecta erros e fornece um valor alternativo ou executa ação.
in – Verifica se uma cadeia de texto está contida em outra cadeia de texto ou tabela, independente de maiúsculas/minúsculas. Também é usado para verificar se um registro está em uma tabela.
Index – retorna um registro de uma tabela com base na posição ordenada.
Int – Arredonda para baixo até o número inteiro mais próximo.
IsBlank – procura por um valor em branco.
IsBlankOrError - verifica se há um valor em branco ou um erro.
IsEmpty – procura por uma tabela vazia.
IsError – verifica se há um erro.
IsMatch – verifica uma cadeia de caracteres em relação a um padrão. Expressões regulares podem ser usadas.
IsNumeric – procura por um valor numérico.
ISOWeekNum – Retorna o número da semana ISO de um valor de data/hora.
IsToday – verifica se um valor de data/hora é hoje no fuso horário do usuário.
IsType – verifica se uma referência de registro se refere a um tipo de tabela específico.
IsUTCToday – verifica se um valor de data/hora é hoje no Tempo Universal Coordenado (UTC).
J
JSON – gera uma cadeia de caracteres de texto JSON para uma tabela, um registro ou um valor.
L
Language – retorna a marca de idioma para o usuário atual.
Last – retorna o último registro de uma tabela.
LastN – retorna o último conjunto de registros (N registros) de uma tabela.
Launch – inicia uma página da Web ou um aplicativo de tela.
Left – retorna a parte mais à esquerda de uma cadeia de caracteres.
Len – retorna o comprimento de uma cadeia de caracteres.
Ln – retorna o log natural.
LoadData – carrega uma coleção de um host de aplicativo, como um dispositivo local.
Location – retorna o local como uma coordenada de mapa usando o sistema de GPS e outras informações.
Log – retorna o logaritmo em qualquer base de um número.
LookUp – pesquisa um único registro em uma tabela com base em um ou mais critérios.
Lower – converte todas as letras de uma cadeia de caracteres de texto em letras minúsculas.
M
Match – extrai uma subcadeia de caracteres com base em um padrão. Expressões regulares podem ser usadas.
MatchAll – extrai várias subcadeias de caracteres com base em um padrão. Expressões regulares podem ser usadas.
Max – valor máximo de uma expressão de tabela ou um conjunto de argumentos.
Mid – retorna a parte do meio de uma cadeia de caracteres.
Min – valor mínimo de uma expressão de tabela ou um conjunto de argumentos.
Minute – recupera a parte dos minutos de um valor de data/hora.
Mod – retorna o resto após um dividendo ser dividido por um divisor.
Month – recupera a parte do mês de um valor de data/hora.
N
Navigate – altera qual tela é exibida.
NewForm – redefine um controle de formulário para criação de um item.
Not – operador lógico booliano NOT. Retornará true se o argumento for false e retornará false se o argumento for true. Você também pode usar o operador !.
Notify – exibe uma mensagem de banner para o usuário.
Now – retorna o valor de data/hora atual no fuso horário do usuário.
O
Or – operador lógico booliano OR. Retorna true se qualquer um dos argumentos for true. Você também pode usar o operador ||.
P
Param – os parâmetros de acesso passados para um aplicativo de tela quando iniciados.
Parent – fornece acesso a propriedades de um controle de contêiner.
ParseJSON – converte o documento JSON representado como texto em um valor Objeto sem tipo.
Patch – modifica ou cria um registro em uma fonte de dados ou mescla registros fora de uma fonte de dados.
PDF - Exporte o conteúdo da tela atual para um objeto para uso em vários cenários.
Pi – retorna o número π.
PlainText – remove marcas HTML e XML de uma cadeia de caracteres.
Power – retorna um número elevado a uma potência. Você também pode usar o operador ^.
Proper – converte a primeira letra de cada palavra em uma cadeia de caracteres de letras maiúsculas e converte o restante em letras minúsculas.
R
Radians – Converte gruas em radianos.
Rand – retorna um número pseudoaleatório entre 0 e 1.
RandBetween – retorna um número pseudoaleatório entre dois números.
ReadNFC - lê uma marca NFC (Near Field Communication).
RecordInfo – fornece informações sobre um registro de uma fonte de dados.
Refresh – atualiza os registros de uma fonte de dados.
Relate – relaciona registros de duas tabelas por meio de um relacionamento um-para-muitos ou muitos-para-muitos.
Remove – remove um ou mais registros específicos de uma fonte de dados.
RemoveIf – remove registros de uma fonte de dados com base em uma condição.
RenameColumns – renomeia colunas de uma tabela.
Replace – substitui parte de uma cadeia de caracteres por outra cadeia de caracteres, iniciando a posição da cadeia de caracteres.
RequestHide – oculta um formulário do SharePoint.
Reset – redefine um controle de entrada para seu valor padrão, descartando quaisquer alterações de usuário.
ResetForm – redefine um controle de formulário para edição de um item existente.
Revert – recarrega e limpa erros dos registros de uma fonte de dados.
RGBA – retorna um valor de cor para um conjunto de componentes vermelhos, verdes, azuis e alfabéticos.
Right – retorna a parte mais à direita de uma cadeia de caracteres.
Round – arredonda para o número mais próximo.
RoundDown – arredonda para baixo para o maior número anterior.
RoundUp – arredonda para cima para o menor número mais próximo.
S
SaveData – salva uma coleção em um host de aplicativo, como um dispositivo local.
Search – localiza registros em uma tabela que contém uma cadeia de caracteres em uma de suas colunas.
Second – recupera a segunda parte de um valor de data/hora.
Select – simula uma ação de seleção em um controle, fazendo com que a fórmula OnSelect seja avaliada.
Self – fornece acesso às propriedades do controle atual.
Sequence – gere uma tabela de números sequenciais, útil ao iterar com ForAll.
SendAppNotification (versão preliminar) – envie uma notificação no aplicativo com ações opcionais para um destinatário.
Set – define o valor de uma variável global.
SetFocus – move o foco de entrada para um controle específico.
SetProperty – simula interações com controles de entrada.
ShowColumns – retorna uma tabela apenas com as colunas selecionadas.
ShowHostInfo – Exibe informações para o usuário no aplicativo.
Shuffle – reordena aleatoriamente os registros de uma tabela.
Sin – retorna o seno de um ângulo especificado em radianos.
Sort – retorna uma tabela classificada com base em uma fórmula.
SortByColumns – retorna uma tabela classificada com base em uma ou mais colunas.
Split – divide uma cadeia de texto em uma tabela de subcadeias de caracteres.
Sqrt – retorna a raiz quadrada de um número.
StartsWith – verifica se uma cadeia de caracteres de texto começa com outra cadeia de caracteres de texto.
StdevP – retorna o desvio padrão dos seus argumentos.
Substitute – substitui parte de uma cadeia de caracteres por outra cadeia de caracteres, ao fazer a correspondência de cadeias de caracteres.
SubmitForm – salva o item em um controle de formulário para a fonte de dados.
Sum – calcula a soma de uma expressão de tabela ou de um conjunto de argumentos.
Switch – cria correspondências com um conjunto de valores e, em seguida, avalia uma fórmula correspondente.
T
Table – cria uma tabela temporária.
Tan – Retorna a tangente de um ângulo especificado em radianos.
Text – converte qualquer valor e formata um número ou valor de data/hora em uma cadeia de caracteres de texto.
ThisItem – retorna o registro do item atual em uma galeria ou controle de formulário.
ThisRecord – Retorna o registro do item atual em uma função de escopo de registro, como ForAll, With e Sum.
Time – retorna um valor de data/hora, com base em valores de Hour, Minute e Second.
TimeValue – converte uma cadeia de caracteres de apenas hora em um valor de data/hora.
TimeZoneOffset – retorna a diferença entre UTC e a hora local do usuário em minutos.
Today – retorna somente o valor de data atual.
Trace – Fornece outras informações nos resultados do teste.
Trim – remove espaços extras de extremidades e do interior de uma cadeia de caracteres de texto.
TrimEnds – remove espaços extras de extremidades de uma cadeia de caracteres de texto apenas.
Trunc – trunca o número para apenas a parte inteira, removendo qualquer parte decimal.
U
Ungroup – remove um agrupamento.
UniChar – converte um código Unicode em uma cadeia de caracteres.
Unrelate – cancela o relacionamento de registros de duas tabelas de um relacionamento um-para-muitos ou muitos-para-muitos.
Update – substitui um registro em uma fonte de dados.
UpdateContext – define o valor de uma ou mais variáveis de contexto da tela atual.
UpdateIf – modifica um conjunto de registros em uma fonte de dados com base em uma condição.
Upper – converte todas as letras de uma cadeia de caracteres de texto em letras maiúsculas.
User – retorna informações sobre o usuário atual.
UTCNow – retorna o valor de data/hora atual no Tempo Universal Coordenado (UTC).
UTCToday – retorna somente o valor de data atual no Tempo Universal Coordenado (UTC).
V
Validate – verifica se o valor de uma única coluna ou um registro completo é válido para uma fonte de dados.
Value – converte uma cadeia de caracteres em um número.
VarP – retorna a variância dos seus argumentos.
ViewForm – redefine um controle de formulário para exibição de um item existente.
W
Weekday – recupera a parte do dia da semana de um valor de data/hora.
WeekNum – retorna o número da semana de um valor de data/hora.
With – calcula valores e executa ações para um único registro, incluindo registros embutidos de valores nomeados.
Y
Year – recupera a parte do ano de um valor de data/hora.