Referência de fórmula para PowerAppsFormula reference for PowerApps

As fórmulas combinam vários elementos.Formulas combine many elements. São mostrados abaixo:Listed below are:

  • Funções aceitam parâmetros, executam uma operação e retornam um valor.Functions take parameters, perform an operation, and return a value. Por exemplo, Sqrt(25) retorna 5.For example, Sqrt(25) returns 5. Funções são modeladas após funções do Microsoft Excel.Functions are modeled after Microsoft Excel functions. Algumas funções têm efeitos colaterais, como SubmitForm, que são apropriadas apenas em uma fórmula de comportamento como Button.OnSelect.Some functions have side effects, such as SubmitForm, which are appropriate only in a behavior formula such as Button.OnSelect.
  • Sinais retornam informações sobre o ambiente.Signals return information about the environment. Por exemplo, local retorna as coordenadas de GPS atuais do dispositivo.For example, Location returns the device's current GPS coordinates. Sinais não usam parâmetros nem têm efeitos colaterais.Signals don't take parameters or have side effects.
  • Enumerações retornam um valor constante predefinido.Enumerations return a pre-defined constant value. Por exemplo, cor é uma enumeração que tem valores predefinidos para Color.Red, Color.Blue e assim por diante.For example, Color is an enumeration that has pre-defined values for Color.Red, Color.Blue, and so forth. Enumerações comuns são incluídas aqui; enumerações específicas de função são descritas com a função.Common enumerations are included here; function-specific enumerations are described with the function.
  • Operadores chamados, como ThisItem e Pai, fornecem acesso a informações de dentro de um contêiner.Named operators, such as ThisItem and Parent, provide access to information from within a container.

Outros elementos incluem:Other elements include:

AA

Abs – valor absoluto de um número.Abs – Absolute value of a number.

Acceleration – lê o sensor de aceleração em seu dispositivo.Acceleration – Reads the acceleration sensor in your device.

Acos – retorna o arco cosseno de um número, em radianos.Acos – Returns the arccosine of a number, in radians.

Acot – retorna o arco tangente de um número, em radianos.Acot – Returns the arccotangent of a number, in radians.

AdicionarColunas – retorna uma tabela com colunas adicionadas.AddColumns – Returns a table with columns added.

And – operador lógico booliano AND.And – Boolean logic AND. Retornará true se todos os argumentos forem true.Returns true if all arguments are true. Você também pode usar o operador &&.You can also use the && operator.

Aplicativo – retorna informações sobre o aplicativo atualmente em execução, como qual tela é exibida no momento.App – Returns information about the currently running app, such as which screen is currently displayed.

Asin – retorna o arco seno de um número, em radianos.Asin – Returns the arcsine of a number, in radians.

Atan – retorna o arco tangente de um número, em radianos.Atan – Returns the arctangent of a number, in radians.

Atan2 – retorna o arco tangente com base em uma coordenada (x,y), em radianos.Atan2 – Returns the arctangent based on an (x,y) coordinate, in radians.

Média – calcula a média de uma expressão de tabela ou de um conjunto de argumentos.Average – Calculates the average of a table expression or a set of arguments.

BB

Back – exibe a tela anterior.Back – Displays the previous screen.

Blank – retorna um valor blank que pode ser usado para inserir um valor NULL em uma fonte de dados.Blank – Returns a blank value that can be used to insert a NULL value in a data source.

CC

Calendário – recupera informações sobre o calendário para a localidade atual.Calendar – Retrieves information about the calendar for the current locale.

Char – converte um código de caracteres em uma cadeia de caracteres.Char – Translates a character code into a string.

Limpar – exclui todos os dados de uma coleção.Clear – Deletes all data from a collection.

LimparColeta – exclui todos os dados de uma coleção e, em seguida, adiciona um conjunto de registros.ClearCollect – Deletes all data from a collection and then adds a set of records.

Relógio – recupera informações sobre o relógio para a localidade atual.Clock – Retrieves information about the clock for the current locale.

Coalesce – substitui valores em branco, deixando os valores não em branco inalterados.Coalesce – Replaces blank values while leaving non-blank values unchanged.

Coletar – cria uma coleção ou adiciona dados a uma fonte de dados.Collect – Creates a collection or adds data to a data source.

Cor – define uma propriedade como um valor de cor incorporado.Color – Sets a property to a built-in color value.

ColorFade – atenua um valor de cor.ColorFade – Fades a color value.

ColorValue – converte um nome de cor CSS ou um código hexadecimal para um valor de cor.ColorValue – Translates a CSS color name or a hex code to a color value.

Bússola – retorna o rumo da bússola.Compass – Returns your compass heading.

Concat – concatena as cadeias de caracteres em uma fonte de dados.Concat – Concatenates strings in a data source.

Concatenar – concatena cadeias de caracteres.Concatenate – Concatenates strings.

Conexão – retorna informações sobre a conexão de rede.Connection – Returns information about your network connection.

Contar – conta registros da tabela que contêm números.Count – Counts table records that contain numbers.

Cos – retorna o cosseno de um ângulo especificado em radianos.Cos – Returns the cosine of an angle specified in radians.

Cot – retorna o cotangente de um ângulo especificado em radianos.Cot – Returns the cotangent of an angle specified in radians.

CountA – conta os registros da tabela que não estão vazios.CountA – Counts table records that aren't empty.

CountIf – conta registros da tabela que atendem a uma condição.CountIf – Counts table records that satisfy a condition.

CountRows – conta registros da tabela.CountRows – Counts table records.

DD

DataSourceInfo – fornece informações sobre uma fonte de dados.DataSourceInfo – Provides information about a data source.

Data – retorna um valor de data/hora, com base nos valores de Ano, Mês e Dia.Date – Returns a date/time value, based on Year, Month, and Day values.

DateAdd – adiciona dias, meses, trimestres ou anos a um valor de data/hora.DateAdd – Adds days, months, quarters, or years to a date/time value.

DateDiff – subtrai dois valores de data e mostra o resultado em dias, meses, trimestres ou anos.DateDiff – Subtracts two date values, and shows the result in days, months, quarters, or years.

ValorDataHora – converte uma cadeia de caracteres de data e hora em um valor de data/hora.DateTimeValue – Converts a date and time string to a date/time value.

ValorData – converte uma cadeia de caracteres de apenas data em um valor de data/hora.DateValue – Converts a date-only string to a date/time value.

Day – recupera a parte do dia de um valor de data/hora.Day – Retrieves the day portion of a date/time value.

Padrões – retorna os valores padrão para uma fonte de dados.Defaults – Returns the default values for a data source.

Graus – converte radianos em graus.Degrees - Converts radians to degrees.

Desabilitar – desabilita um sinal, como Local para ler o GPS.Disable – Disables a signal, such as Location for reading the GPS.

Distinto – resume os registros de uma tabela, removendo duplicatas.Distinct – Summarizes records of a table, removing duplicates.

Download – baixa um arquivo da web para o dispositivo local.Download – Downloads a file from the web to the local device.

DropColumns – retorna uma tabela com uma ou mais colunas removidas.DropColumns – Returns a table with one or more columns removed.

EE

EditForm – redefine um controle de formulário para edição de um item.EditForm – Resets a form control for editing of an item.

Habilitar – habilita um sinal, como uma Localização para ler o GPS.Enable – Enables a signal, such as Location for reading the GPS.

EndsWith – verifica se uma cadeia de texto termina com outra cadeia de texto.EndsWith – Checks whether a text string ends with another text string.

Erros – fornece informações de erro para alterações anteriores em uma fonte de dados.Errors – Provides error information for previous changes to a data source.

EncodeUrl – codifica caracteres especiais usando a codificação de URL.EncodeUrl – Encodes special characters using URL encoding.

Sair – sai do aplicativo em execução no momento.Exit – Exits the currently running app.

Exp – retorna e elevado a uma potência.Exp - Returns e raised to a power.

FF

Filtrar – retorna uma tabela filtrada com base em um ou mais critérios.Filter – Returns a filtered table based on one or more criteria.

Localizar – verifica se uma cadeia de caracteres aparece dentro de outra e retorna o local.Find – Checks whether one string appears within another and returns the location.

Primeiro – retorna o primeiro registro de uma tabela.First – Returns the first record of a table.

FirstN – retorna o primeiro conjunto de registros (N registros) de uma tabela.FirstN – Returns the first set of records (N records) of a table.

ForAll – calcula valores e executa ações para todos os registros de uma tabela.ForAll – Calculates values and performs actions for all records of a table.

GG

GroupBy – retorna uma tabela com registros agrupados juntos.GroupBy – Returns a table with records grouped together.

HH

HashTags – extrai as hashtags (#strings) de uma cadeia de caracteres.HashTags – Extracts the hashtags (#strings) from a string.

Hora – retorna a parte de hora de um valor de data/hora.Hour – Returns the hour portion of a date/time value.

II

If – retorna um valor se uma condição for verdadeira e outro valor se não for.If – Returns one value if a condition is true and another value if not.

IsBlank – procura por um valor em branco.IsBlank – Checks for a blank value.

IsEmpty – procura por uma tabela vazia.IsEmpty – Checks for an empty table.

IsMatch – verifica uma cadeia de caracteres em relação a um padrão.IsMatch – Checks a string against a pattern. Expressões regulares podem ser usadas.Regular expressions can be used.

IsNumeric – procura por um valor numérico.IsNumeric – Checks for a numeric value.

IsToday – verifica se um valor de data/hora é hoje.IsToday – Checks whether a date/time value is sometime today.

GL

Idioma – retorna a marcação de idioma para o usuário atual.Language – Returns the language tag of the current user.

Último – retorna o último registro de uma tabela.Last – Returns the last record of a table.

LastN – retorna o último conjunto de registros (N registros) de uma tabela.LastN – Returns the last set of records (N records) of a table.

Iniciar – inicia um endereço Web ou um aplicativo.Launch – Launches a web address or an app.

Esquerda – retorna a parte mais à esquerda de uma cadeia de caracteres.Left – Returns the left-most portion of a string.

Len – retorna o comprimento de uma cadeia de caracteres.Len – Returns the length of a string.

Ln – retorna o log natural.Ln – Returns the natural log.

CarregarDados – carrega uma coleção do armazenamento privado PowerApps.LoadData – Loads a collection from PowerApps private storage.

Localização – retorna o local como uma coordenada de mapa usando o sistema GPS (Global Positioning) e outras informações.Location – Returns your location as a map coordinate by using the Global Positioning System (GPS) and other information.

LookUp – pesquisa um único registro em uma tabela com base em um ou mais critérios.LookUp – Looks up a single record in a table based on one or more criteria.

Lower – converte todas as letras de uma cadeia de caracteres de texto em letras minúsculas.Lower – Converts letters in a string of text to all lowercase.

MM

Max – valor máximo de uma expressão de tabela ou um conjunto de argumentos.Max – Maximum value of a table expression or a set of arguments.

Mid – retorna a parte do meio de uma cadeia de caracteres.Mid – Returns the middle portion of a string.

Min – valor mínimo de uma expressão de tabela ou um conjunto de argumentos.Min – Minimum value of a table expression or a set of arguments.

Minuto – recupera a parte dos minutos de um valor de data/hora.Minute – Retrieves the minute portion of a date/time value.

Mod – retorna o resto após um dividendo ser dividido por um divisor.Mod – Returns the remainder after a dividend is divided by a divisor.

Mês – recupera a parte do mês de um valor de data/hora.Month – Retrieves the month portion of a date/time value.

NN

Navegar – altera qual tela é exibida.Navigate – Changes which screen is displayed.

NewForm – redefine um controle de formulário para criação de um item.NewForm – Resets a form control for creation of an item.

Not – operador lógico booliano NOT.Not – Boolean logic NOT. Retornará true se o argumento for false e retornará false se o argumento for true.Returns true if its argument is false, and returns false if its argument is true. Você também pode usar o operador !.You can also use the ! operator.

Now – retorna o valor de data/hora atual.Now – Returns the current date/time value.

OO

Or – operador lógico booliano OR.Or – Boolean logic OR. Retornará true se qualquer um dos argumentos for true.Returns true if any of its arguments are true. Você também pode usar o operador ||.You can also use the || operator.

PP

Param – fornece acesso aos parâmetros passados para o aplicativo quando o usuário o abriu.Param – Provides access to parameters passed to the app when the user opened it.

Pai – fornece acesso a propriedades de um controle de contêiner.Parent – Provides access to a container control's properties.

Patch – modifica ou cria um registro em uma fonte de dados ou mescla registros fora de uma fonte de dados.Patch – Modifies or creates a record in a data source, or merges records outside of a data source.

Pi – retorna o número π.Pi – Returns the number π.

PlainText – remove HTML e XML de uma cadeia de caracteres.PlainText – Removes HTML and XML tags from a string.

Power – retorna um número elevado a uma potência.Power – Returns a number raised to a power. Você também pode usar o operador ^.You can also use the ^ operator.

Próprio – converte a primeira letra de cada palavra em uma cadeia de caracteres de letras maiúsculas e converte o restante em letras minúsculas.Proper – Converts the first letter of each word in a string to uppercase, and converts the rest to lowercase.

RR

Radianos – converte graus em radianos.Radians - Converts degrees to radians.

RAND – retorna um número pseudoaleatório.Rand – Returns a pseudo-random number.

Atualizar – atualiza os registros de uma fonte de dados.Refresh – Refreshes the records of a data source.

Remover – remove um ou mais registros específicos de uma fonte de dados.Remove – Removes one or more specific records from a data source.

RemoverSe – remove registros de uma fonte de dados com base em uma condição.RemoveIf – Removes records from a data source based on a condition.

RenameColumns – renomeia colunas de uma tabela.RenameColumns – Renames columns of a table.

Substituir – substitui parte de uma cadeia de caracteres por outra cadeia de caracteres, iniciando a posição da cadeia de caracteres.Replace – Replaces part of a string with another string, by starting position of the string.

Redefinir – redefine um controle de entrada para seu valor padrão, descartando quaisquer alterações de usuário.Reset – Resets an input control to its default value, discarding any user changes.

ResetForm – redefine um controle de formulário para edição de um item existente.ResetForm – Resets a form control for editing of an existing item.

Reverter – recarrega e limpa erros dos registros de uma fonte de dados.Revert – Reloads and clears errors for the records of a data source.

RGBA – retorna um valor de cor para um conjunto de componentes vermelhos, verdes, azuis e alfabéticos.RGBA – Returns a color value for a set of red, green, blue, and alpha components.

Direita – retorna a parte mais à direita de uma cadeia de caracteres.Right – Returns the right-most portion of a string.

Arredondar – arredonda para o número mais próximo.Round – Rounds to the closest number.

RoundDown – arredonda para baixo para o maior número anterior.RoundDown – Rounds down to the largest previous number.

RoundUp – arredonda para cima para o menor número mais próximo.RoundUp – Rounds up to the smallest next number.

PS

SalvarDados – salva uma coleção no armazenamento particular do PowerApps.SaveData – Saves a collection to PowerApps private storage.

Pesquisar – localiza registros em uma tabela que contém uma cadeia de caracteres em uma de suas colunas.Search – Finds records in a table that contain a string in one of their columns.

Segundo – recupera a segunda parte de um valor de data/hora.Second – Retrieves the second portion of a date/time value.

Definir – define o valor de uma variável global.Set – Sets the value of a global variable.

MostrarColunas – retorna uma tabela apenas com as colunas selecionadas.ShowColumns – Returns a table with only selected columns.

Embaralhar – reordena aleatoriamente os registros de uma tabela.Shuffle – Randomly reorders the records of a table.

Sin – retorna o seno de um ângulo especificado em radianos.Sin – Returns the sine of an angle specified in radians.

Classificar – retorna uma tabela classificada com base em uma fórmula.Sort – Returns a sorted table based on a formula.

SortByColumns – retorna uma tabela classificada com base em uma ou mais colunas.SortByColumns – Returns a sorted table based on one or more columns.

Split – divide uma cadeia de texto em uma tabela de subcadeias.Split – Splits a text string into a table of substrings.

Sqrt – retorna a raiz quadrada de um número.Sqrt – Returns the square root of a number.

StartsWith – verifica se uma cadeia de caracteres de texto começa com outra cadeia de caracteres de texto.StartsWith – Checks if a text string begins with another text string.

StdevP – retorna o desvio padrão dos seus argumentos.StdevP – Returns the standard deviation of its arguments.

Substituir – substitui parte de uma cadeia de caracteres por outra cadeia de caracteres, correspondendo cadeias de caracteres.Substitute – Replaces part of a string with another string, by matching strings.

SubmitForm – salva o item em um controle de formulário para a fonte de dados.SubmitForm – Saves the item in a form control to the data source.

Somar – calcula a soma de uma expressão de tabela ou de um conjunto de argumentos.Sum – Calculates the sum of a table expression or a set of arguments.

Switch – cria correspondências com um conjunto de valores e, em seguida, avalia uma fórmula correspondente.Switch – Matches with a set of values and then evaluates a corresponding formula.

TT

Tabela – cria uma tabela temporária.Table – Creates a temporary table.

Tan – retorna a tangente de um ângulo especificado em radianos.Tan - Returns the tangent of an angle specified in radians.

Texto – formata um número como uma cadeia de caracteres para exibição.Text – Formats a number as a string for display.

ThisItem – quando estiver em uma galeria ou formulário, retorna os dados para o item atual do contêiner.ThisItem – When in a gallery or form, returns the data for the current item from the container.

Hora – retorna um valor de data/hora, com base em valores de hora, minuto e segundo.Time – Returns a date/time value, based on Hour, Minute, and Second values.

ValorTempo – converte uma cadeia de caracteres de apenas hora em um valor de data/hora.TimeValue – Converts a time-only string to a date/time value.

TimeZoneOffset – retorna a diferença entre UTC e hora local do usuário em minutos.TimeZoneOffset – Returns the difference between UTC and the user's local time in minutes.

Hoje – retorna o valor de data/hora atual.Today – Returns the current date/time value.

Cortar – remove espaços extras de extremidades e do interior de uma cadeia de caracteres de texto.Trim – Removes extra spaces from the ends and interior of a string of text.

TrimEnds – remove espaços extras de extremidades de uma cadeia de caracteres de texto apenas.TrimEnds – Removes extra spaces from the ends of a string of text only.

UU

Desagrupar – remove um agrupamento.Ungroup – Removes a grouping.

Atualizar – substitui um registro em uma fonte de dados.Update – Replaces a record in a data source.

UpdateContext – define o valor de uma ou mais variáveis de contexto da tela atual.UpdateContext – Sets the value of one or more context variables of the current screen.

AtualizarSe – modifica um conjunto de registros em uma fonte de dados com base em uma condição.UpdateIf – Modifies a set of records in a data source based on a condition.

Upper – converte todas as letras de uma cadeia de caracteres de texto em letras maiúsculas.Upper – Converts letters in a string of text to all uppercase.

Usuário – retorna informações sobre o usuário atual.User – Returns information about the current user.

VV

Validar – verifica se o valor de uma única coluna ou um registro completo é válido para uma fonte de dados.Validate – Checks whether the value of a single column or a complete record is valid for a data source.

Valor – converte uma cadeia de caracteres em um número.Value – Converts a string to a number.

VarP – retorna a variância dos seus argumentos.VarP – Returns the variance of its arguments.

ViewForm – redefine um controle de formulário para exibição de um item existente.ViewForm – Resets a form control for viewing of an existing item.

WW

Dia útil – recupera a parte do dia da semana de um valor de data/hora.Weekday – Retrieves the weekday portion of a date/time value.

YY

Ano – recupera a parte do ano de um valor de data/hora.Year – Retrieves the year portion of a date/time value.