Compartilhar via


Value.FromText

Sintaxe

Value.FromText(text as any, optional culture as nullable text) as any

Sobre

Decodifica um valor de uma representação textual e o interpreta como um valor com um tipo apropriado.

  • text: o texto a ser interpretado.
  • culture (Opcional) Uma cultura específica usada para interpretar o texto (por exemplo, "en-US").

Essa função usa um valor de texto e retorna um valor de tiponumber, , logical, null, datetime, ou durationtext. Um valor de texto vazio é interpretado como um null valor.

Exemplo 1

Converta o texto que representa um número em seu valor numérico correspondente.

Uso

Value.FromText("12345.6789")

Saída

12345.6789

Exemplo 2

Converta o texto que representa uma porcentagem em seu valor de número correspondente.

Uso

Value.FromText("25.4%")

Saída

0.254

Exemplo 3

Converta o texto que representa um valor em euros francês no seu valor numérico correspondente.

Uso

Value.FromText("€1,190", "fr-FR")

Saída

1.19

Exemplo 4

Converta o texto que representa uma data e hora no formato alemão para seu valor de data e hora correspondente.

Uso

Value.FromText("24 Dez 2024 14:33:20", "de-DE")

Saída

#datetime(2024, 12, 24, 14, 33, 20)