Função Value no PowerAppsValue function in PowerApps

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

DescriçãoDescription

A função Value converte uma cadeia de texto que contém carateres numéricos em valor numérico.The Value function converts a string of text that contains number characters to a number value. Utilize esta função quando necessitar de efetuar cálculos em números que foram introduzidos como texto por um utilizador.Use this function when you need to perform calculations on numbers that were entered as text by a user.

Vários idiomas interpretam , e .Different languages interpret , and . de forma diferente.differently. Por predefinição, o texto é interpretado no idioma do utilizador atual.By default, the text is interpreted in the language of the current user. Pode especificar o idioma a utilizar com uma etiqueta de idioma ao utilizar as mesmas etiquetas de idioma que são devolvidas 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.

Notas sobre o formato da cadeia:Notes on the format of the string:

  • A cadeia poderá ser antecedida pelo símbolo de moeda do 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. Não são ignorados os símbolos de moeda de outros idiomas.Currency symbols for other languages are not ignored.
  • A cadeia poderá incluir um sinal de percentagem (%) no fim, que indica que é uma percentagem.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 ser devolvido.The number will be divided by 100 before being returned. Não é possível misturar percentagens e símbolos de moeda.Percentages and currency symbols cannot be mixed.
  • A cadeia poderá estar 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 no formato correto, a função Value devolverá um valor em branco.If the number is not in a proper format, Value will return blank.

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

SintaxeSyntax

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

  • Cadeia – necessário.String - Required. Cadeia a converter num valor numérico.String to convert to a numeric value.
  • LanguageTag – Opcional.LanguageTag - Optional. A etiqueta do idioma no qual pretende analisar a cadeia.The language tag in which to parse the string. Se não for especificado, será utilizado o idioma do utilizador atual.If not specified, the language of the current user is used.

ExemplosExamples

O utilizador que executa estas fórmulas encontra-se nos Estados Unidos e selecionou 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á a devolver "en-US".The Language function is returning "en-US".

FórmulaFormula DescriçãoDescription ResultadoResult
Value( "123.456" )Value( "123.456" ) Será utilizado o idioma predefinido de "en-US", que utiliza um ponto como separador decimal.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 etiqueta de idioma para o espanhol de Espanha."es-ES" is the language tag for Spanish in Spain. Em Espanha, a vírgula é o separador dos milhares.In Spain, a period is a thousands separator. 123456123456
Value( "123,456" )Value( "123,456" ) Será utilizado o idioma predefinido de "en-US", que utiliza uma vírgula como separador de milhares.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 etiqueta de idioma para o espanhol de Espanha."es-ES" is the language tag for Spanish in Spain. Em Espanha, a vírgula é o separador decimal.In Spain, a comma is the decimal separator. 123.456123.456
Value( "12,34%" )Value( "12.34%" ) O símbolo de percentagem no fim da cadeia indica que se trata de uma percentagem.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 de 12 x 103.Scientific notation for 12 x 103. 2400024000