Função Value no PowerAppsValue function in PowerApps

Converte uma cadeia de texto em um número.Converts a string of text to a number.

DescriçãoDescription

A função Value converte uma cadeia de texto que contém caracteres numéricos em um valor numérico.The Value function converts a string of text that contains number characters to a number value. Use essa função quando você precisar realizar cálculos em números inseridos como texto por um usuário.Use this function when you need to perform calculations on numbers that were entered as text by a user.

Idiomas diferentes interpretam , e .Different languages interpret , and . de forma diferente.differently. Por padrão, o texto é interpretado no idioma do usuário atual.By default, the text is interpreted in the language of the current user. Você pode especificar o idioma a ser usado com uma marca de idioma, usando as mesmas marcas de idioma retornadas pela função Language.You can specify the language to use with a language tag, using the same language tags that are returned by the Language function.

Observações sobre o formato da cadeia de caracteres:Notes on the format of the string:

  • A cadeia de caracteres pode ser prefixada com o símbolo de moeda para o idioma atual.The string may be prefixed with the currency symbol for the current language. O símbolo de moeda é ignorado.The currency symbol is ignored. Símbolos de moeda de outros idiomas não são ignorados.Currency symbols for other languages are not ignored.
  • A cadeia de caracteres pode incluir um sinal de porcentagem (%) no final, indicando que é uma porcentagem.The string may be include a percent sign (%) at the end, indicating that it is a percentage. O número será dividido por 100 antes de retornar.The number will be divided by 100 before being returned. Porcentagens e símbolos de moeda não podem ser combinados.Percentages and currency symbols cannot be mixed.
  • A cadeia de caracteres pode ser em notação científica, com 12 x 103 expresso como "12e3".The string may be in scientific notation, with 12 x 103 expressed as "12e3".

Se o número não estiver em um formato adequado, Value retornará em branco.If the number is not in a proper format, Value will return blank.

Para converter valores de data e hora, use as funções DateValue, TimeValue ou DateTimeValue.To convert date and time values, use the DateValue, TimeValue, or DateTimeValue functions.

SintaxeSyntax

Value( String [, LanguageTag ] )Value( String [, LanguageTag ] )

  • String - obrigatório.String - Required. Cadeia de caracteres para converter em um valor numérico.String to convert to a numeric value.
  • LanguageTag – Opcional.LanguageTag - Optional. A marca de idioma na qual analisar a cadeia de caracteres.The language tag in which to parse the string. Se não for especificada, o idioma do usuário atual será utilizado.If not specified, the language of the current user is used.

ExemplosExamples

O usuário que executa essas fórmulas está localizado nos Estados Unidos e selecionou o inglês como idioma.The user running these formulas is located in the United States and has selected English as their language. A função Idioma está retornando "en-US".The Language function is returning "en-US".

FórmulaFormula DescriçãoDescription ResultadoResult
Value( "123.456" )Value( "123.456" ) O idioma padrão de "en-US", que usa um ponto como separador decimal, será usado.The default language of "en-US" will be used, which uses a period as the decimal separator. 123.456123.456
Value( "123.456", "es-ES" )Value( "123.456", "es-ES" ) "es-ES" é a marca de idioma para espanhol da Espanha."es-ES" is the language tag for Spanish in Spain. Na Espanha, um ponto é um separador de milhares.In Spain, a period is a thousands separator. 123456123456
Value( "123,456" )Value( "123,456" ) O idioma padrão de "en-US", que usa uma vírgula como separador de milhares, será usado.The default language of "en-US" will be used, which uses a comma as a thousands separator. 123456123456
Value( "123,456", "es-ES" )Value( "123,456", "es-ES" ) "es-ES" é a marca de idioma para espanhol da Espanha."es-ES" is the language tag for Spanish in Spain. Na Espanha, uma vírgula é o separador decimal.In Spain, a comma is the decimal separator. 123.456123.456
Value( "12.34%" )Value( "12.34%" ) O sinal de porcentagem no final da cadeia de caracteres indica que esta é uma porcentagem.The percentage sign at the end of the string indicates that this is a percentage. 0.12340.1234
Value( "$ 12.34" )Value( "$ 12.34" ) O símbolo de moeda do idioma atual é ignorado.The currency symbol for the current language is ignored. 12.3412.34
Value( "24e3" )Value( "24e3" ) Notação científica para 12 x 103.Scientific notation for 12 x 103. 2400024000