Converte uma cadeia de texto em um número.

Descrição

A função Value converte uma cadeia de texto que contém caracteres numéricos em um valor numérico. Use essa função quando você precisar realizar cálculos em números inseridos como texto por um usuário.

Idiomas diferentes interpretam , e . de forma diferente. Por padrão, o texto é interpretado no idioma do usuário atual. Você pode especificar o idioma a ser usado com uma marca de idioma, usando as mesmas marcas de idioma retornadas pela função Language.

Observações sobre o formato da cadeia de caracteres:

  • A cadeia de caracteres pode ser prefixada com o símbolo de moeda para o idioma atual. O símbolo de moeda é ignorado. Símbolos de moeda de outros idiomas não são ignorados.
  • A cadeia de caracteres pode incluir um sinal de porcentagem (%) no final, indicando que é uma porcentagem. O número será dividido por 100 antes de retornar. Porcentagens e símbolos de moeda não podem ser combinados.
  • A cadeia de caracteres pode ser em notação científica, com 12 x 103 expresso como "12e3".

Se o número não estiver em um formato adequado, Value retornará em branco.

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

Sintaxe

Value( String [, LanguageTag ] )

  • String - obrigatório. Cadeia de caracteres para converter em um valor numérico.
  • LanguageTag – Opcional. A marca de idioma na qual analisar a cadeia de caracteres. Se não for especificada, o idioma do usuário atual será utilizado.

Exemplos

O usuário que executa essas fórmulas está localizado nos Estados Unidos e selecionou o inglês como idioma. A função Idioma está retornando "en-US".

Fórmula Descrição Resultado
Value( "123.456" ) O idioma padrão de "en-US", que usa um ponto como separador decimal, será usado. 123.456
Value( "123.456", "es-ES" ) "es-ES" é a marca de idioma para espanhol da Espanha. Na Espanha, um ponto é um separador de milhares. 123456
Value( "123,456" ) O idioma padrão de "en-US", que usa uma vírgula como separador de milhares, será usado. 123456
Value( "123,456", "es-ES" ) "es-ES" é a marca de idioma para espanhol da Espanha. Na Espanha, uma vírgula é o separador decimal. 123.456
Value( "12.34%" ) O sinal de porcentagem no final da cadeia de caracteres indica que esta é uma porcentagem. 0.1234
Value( "$ 12.34" ) O símbolo de moeda do idioma atual é ignorado. 12.34
Value( "24e3" ) Notação científica para 12 x 103. 24000