Referência de fórmulas para o PowerAppsFormula reference for PowerApps

As fórmulas combinam muitos elementos.Formulas combine many elements. Abaixo, encontram-se descritos:Listed below are:

  • As funções aceitam parâmetros, executam uma operação e devolvem um valor.Functions take parameters, perform an operation, and return a value. Por exemplo, Sqrt(25) devolve 5.For example, Sqrt(25) returns 5. As funções são modeladas com base nas funções do Microsoft Excel.Functions are modeled after Microsoft Excel functions. Algumas funções têm efeitos secundários, tais como SubmitForm, que são adequadas apenas numa 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.
  • Os sinais devolvem informações sobre o ambiente.Signals return information about the environment. Por exemplo, Localização devolve as coordenadas GPS atuais do dispositivo.For example, Location returns the device's current GPS coordinates. Os sinais não aceitam parâmetros nem têm efeitos secundários.Signals don't take parameters or have side effects.
  • As enumerações devolvem 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, etc.For example, Color is an enumeration that has pre-defined values for Color.Red, Color.Blue, and so forth. 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.Common enumerations are included here; function-specific enumerations are described with the function.
  • Os operadores com nome, tais como ThisItem e Parent, proporcionam acesso a informações de um contentor.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.

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

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

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

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

E – o valor lógico booleano AND.And – Boolean logic AND. Devolve verdadeiro se todos os argumentos forem verdadeiros.Returns true if all arguments are true. Também pode utilizar o operador &&.You can also use the && operator.

Aplicação – devolve informações sobre a aplicação em execução, tais como que ecrã é atualmente apresentado.App – Returns information about the currently running app, such as which screen is currently displayed.

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

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

Atan2 – devolve o arco de tangente com base numa 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 conjunto de argumentos.Average – Calculates the average of a table expression or a set of arguments.

BB

Anterior – mostra o ecrã anterior.Back – Displays the previous screen.

Em branco – devolve um valor em branco que pode ser utilizado para inserir um valor NULO numa origem de dados.Blank – Returns a blank value that can be used to insert a NULL value in a data source.

CC

Calendário – obtém informações sobre o calendário para a região atual.Calendar – Retrieves information about the calendar for the current locale.

Char – converte um código do caráter numa cadeia.Char – Translates a character code into a string.

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

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

Relógio –obtém as informações sobre o relógio para a região atual.Clock – Retrieves information about the clock for the current locale.

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

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

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

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

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

Bússola – devolve o cabeçalho de bússola.Compass – Returns your compass heading.

Concat – concatena cadeias numa origem de dados.Concat – Concatenates strings in a data source.

Concatenar – concatena cadeias.Concatenate – Concatenates strings.

Ligação – devolve informações sobre a ligação de rede.Connection – Returns information about your network connection.

Contar – conta os registos de tabela que contêm números.Count – Counts table records that contain numbers.

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

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

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

CountIf – conta os registos de tabela que satisfazem uma condição.CountIf – Counts table records that satisfy a condition.

CountRows – conta os registos de tabela.CountRows – Counts table records.

DD

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

Data – devolve 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.

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

DateValue – converte uma cadeia só de data num valor de data/hora.DateValue – Converts a date-only string to a date/time value.

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

Predefinições – devolve os valores predefinidos para uma origem de dados.Defaults – Returns the default values for a data source.

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

Desativar – desativa um sinal, tal como Localização para ler o GPS.Disable – Disables a signal, such as Location for reading the GPS.

Distinct – resume os registos de uma tabela, removendo os duplicados.Distinct – Summarizes records of a table, removing duplicates.

Transferir – transfere um ficheiro da Web para o dispositivo local.Download – Downloads a file from the web to the local device.

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

EE

EditForm – repõe um controlo de formulário para a edição de um item.EditForm – Resets a form control for editing of an item.

Ativar – ativa um sinal, tal como 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.

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

EncodeUrl – codifica carateres especiais com codificação do URL.EncodeUrl – Encodes special characters using URL encoding.

Sair – fecha a aplicação que estiver em execução.Exit – Exits the currently running app.

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

FF

Filtrar – devolve 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 é apresentada dentro de outra e devolve a localização.Find – Checks whether one string appears within another and returns the location.

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

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

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

GG

GroupBy – devolve uma tabela com registos agrupados.GroupBy – Returns a table with records grouped together.

HH

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

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

II

Se – devolve 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 – verifica a existência de um valor em branco.IsBlank – Checks for a blank value.

IsEmpty – verifica a existência de uma tabela vazia.IsEmpty – Checks for an empty table.

IsMatch – verifica uma cadeia em relação a um padrão.IsMatch – Checks a string against a pattern. Podem ser utilizadas expressões regulares.Regular expressions can be used.

IsNumeric – verifica a existência de um valor numérico.IsNumeric – Checks for a numeric value.

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

LL

Idioma – devolve a etiqueta de idioma do utilizador atual.Language – Returns the language tag of the current user.

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

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

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

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

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

Ln – devolve o registo natural.Ln – Returns the natural log.

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

Localização – devolve a sua localização como uma coordenada de mapa através do GPS (Global Positioning System) e outras informações.Location – Returns your location as a map coordinate by using the Global Positioning System (GPS) and other information.

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

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

MM

Máx – 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.

Meio – devolve a parte do meio de uma cadeia.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 – obtém a parte do minuto de um valor de data/hora.Minute – Retrieves the minute portion of a date/time value.

Resto – devolve o resto depois de um dividendo ser dividido por um divisor.Mod – Returns the remainder after a dividend is divided by a divisor.

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

NN

Navegar – altera o ecrã que é apresentado.Navigate – Changes which screen is displayed.

NewForm – repõe um controlo de formulário para a criação de um item.NewForm – Resets a form control for creation of an item.

Não – o valor lógico booleano NOT.Not – Boolean logic NOT. Devolve verdadeiro se o respetivo argumento for falso e devolve falso se o respetivo argumento for verdadeiro.Returns true if its argument is false, and returns false if its argument is true. Também pode utilizar o operador !.You can also use the ! operator.

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

OO

Ou – o valor lógico booleano OR.Or – Boolean logic OR. Devolve verdadeiro se qualquer um dos respetivos argumentos for verdadeiro.Returns true if any of its arguments are true. Também pode utilizar o operador ||.You can also use the || operator.

PP

Param – fornece acesso aos parâmetros transmitidos para a aplicação quando o utilizador a abriu.Param – Provides access to parameters passed to the app when the user opened it.

Principal – proporciona acesso às propriedades de um controlo de contentor.Parent – Provides access to a container control's properties.

Patch – modifica ou cria um registo numa origem de dados ou une registos fora de uma origem de dados.Patch – Modifies or creates a record in a data source, or merges records outside of a data source.

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

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

Potência – devolve um número elevado a uma potência.Power – Returns a number raised to a power. Também pode utilizar o operador ^.You can also use the ^ operator.

Inicial.Maiúscula – converte a primeira letra de cada palavra numa cadeia em maiúsculas e converte o resto em 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.

Aleatório – devolve um número pseudo-aleatório.Rand – Returns a pseudo-random number.

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

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

RemoveIf – remove registos de uma origem de dados com base numa condição.RemoveIf – Removes records from a data source based on a condition.

RenameColumns – muda o nome de colunas de uma tabela.RenameColumns – Renames columns of a table.

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

Repor – repõe o valor predefinido de um controlo de entrada, eliminando quaisquer alterações do utilizador.Reset – Resets an input control to its default value, discarding any user changes.

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

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

RGBA – devolve um valor de cor para um conjunto de componentes vermelho, verde, azul e alfa.RGBA – Returns a color value for a set of red, green, blue, and alpha components.

Direita – devolve a parte mais à direita de uma cadeia.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 até ao número anterior maior.RoundDown – Rounds down to the largest previous number.

RoundUp – arredonda para cima até ao número seguinte mais pequeno.RoundUp – Rounds up to the smallest next number.

SS

SaveData – guarda uma coleção no armazenamento privado do PowerApps.SaveData – Saves a collection to PowerApps private storage.

Procurar – localiza registos numa tabela que contêm uma cadeia numa das respetivas colunas.Search – Finds records in a table that contain a string in one of their columns.

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

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

Shuffle – reordena de forma aleatória os registos de uma tabela.Shuffle – Randomly reorders the records of a table.

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

Ordenar – devolve uma tabela ordenada com base numa fórmula.Sort – Returns a sorted table based on a formula.

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

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

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

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

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

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

SubmitForm – guarda o item de um controlo de formulário numa origem de dados.SubmitForm – Saves the item in a form control to the data source.

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

Comutador – faz a correspondência 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 – devolve 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 para apresentação.Text – Formats a number as a string for display.

ThisItem – num formulário ou galeria, devolve os dados para o item atual a partir do contentor.ThisItem – When in a gallery or form, returns the data for the current item from the container.

Tempo – devolve um valor de data/hora, com base nos valores de Hora, Minuto e Segundo.Time – Returns a date/time value, based on Hour, Minute, and Second values.

TimeValue – converte uma cadeia só de hora num valor de data/hora.TimeValue – Converts a time-only string to a date/time value.

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

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

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

TrimEnds – remove os espaços extra das extremidades de uma cadeia só de texto.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 registo numa origem de dados.Update – Replaces a record in a data source.

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

UpdateIf – modifica um conjunto de registos numa origem de dados com base numa condição.UpdateIf – Modifies a set of records in a data source based on a condition.

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

Utilizador – devolve informações sobre o utilizador atual.User – Returns information about the current user.

VV

Validar – verifica se o valor de uma única coluna ou de um registo completo é válido para uma origem 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 num número.Value – Converts a string to a number.

VarP – devolve a variância dos respetivos argumentos.VarP – Returns the variance of its arguments.

ViewForm – repõe um controlo de formulário para a visualização de um item existente.ViewForm – Resets a form control for viewing of an existing item.

WW

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

YY

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