Comentários

Função Value no Power Apps

  • Artigo
  • 2 minutos para o fim da leitura

Converte uma cadeia de texto em número.

Descrição

A função Value converte uma cadeia de texto que contém carateres numéricos em valor numérico. Utilize esta função quando necessitar de efetuar cálculos em números que foram introduzidos como texto por um utilizador.

Vários idiomas interpretam , e . de forma diferente. Por predefinição, o texto é interpretado no idioma do utilizador atual. 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.

Notas sobre o formato da cadeia:

  • A cadeia poderá ser antecedida pelo símbolo de moeda do idioma atual. O símbolo de moeda é ignorado. Não são ignorados os símbolos de moeda de outros idiomas.
  • A cadeia poderá incluir um sinal de percentagem (%) no fim, que indica que é uma percentagem. O número será dividido por 100 antes de ser devolvido. Não é possível misturar percentagens e símbolos de moeda.
  • A cadeia poderá estar em notação científica, com 12 x 103 expresso como "12e3".

Se o número não estiver no formato correto, a função Value devolverá um valor blank.

Para converter valores de data e hora, utilize as funções DateValue, TimeValue ou DateTimeValue.

Sintaxe

Value( Cadeia [, LanguageTag ] )

  • Cadeia – Obrigatório. Cadeia a converter num valor numérico.
  • LanguageTag – Opcional. A etiqueta do idioma no qual pretende analisar a cadeia. Se não for especificado, será utilizado o idioma do utilizador atual.

Exemplos

O utilizador que executa estas fórmulas encontra-se nos Estados Unidos e selecionou inglês como idioma. A função Language está a devolver "en-US".

Fórmula Descrição Resultado
Value( "123.456" ) Será utilizado o idioma predefinido de "en-US", que utiliza um ponto como separador decimal. 123.456
Value( "123.456", "es-ES" ) "es-ES" é a etiqueta de idioma para o espanhol de Espanha. Em Espanha, a vírgula é o separador dos milhares. 123456
Value( "123,456" ) Será utilizado o idioma predefinido de "en-US", que utiliza uma vírgula como separador de milhares. 123456
Value( "123,456", "es-ES" ) "es-ES" é a etiqueta de idioma para o espanhol de Espanha. Em Espanha, a vírgula é o separador decimal. 123.456
Value( "12.34%" ) O símbolo de percentagem no fim da cadeia indica que se trata de uma percentagem. 0.1234
Value( "$ 12.34" ) O símbolo de moeda do idioma atual é ignorado. 12.34
Value( "24e3" ) Notação científica de 24 x 103. 24000

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).