Compartilhar via


Number.From

Sintaxe

Number.From(value as any, optional culture as nullable text) as nullable number

Sobre

Retorna um valor number do value especificado. Uma culture opcional também pode ser fornecida (por exemplo, "pt-BR"). Se o value fornecido for null, Number.From retornará null. Se o value fornecido for number, value será retornado. Os valores dos seguintes tipos podem ser convertidos em um valor number:

  • text: Um valor number da representação textual. Os formatos de texto comuns são tratados ("15", "3.423,10", "5.0E-10"). Veja o Number.FromText para obter detalhes.
  • logical: 1 para true, 0 para false.
  • datetime: Um número de ponto flutuante de precisão dupla que contém uma data de Automação OLE equivalente.
  • datetimezone: Um número de ponto flutuante de precisão dupla que contém uma data de Automação OLE equivalente da data e hora local de value.
  • date: Um número de ponto flutuante de precisão dupla que contém uma data de Automação OLE equivalente.
  • time: Expresso em dias fracionários.
  • duration: Expresso em dias inteiros e fracionários.

Se value for de qualquer outro tipo, um erro será retornado.

Exemplo 1

Obtenha o valor number de "4".

Usage

Number.From("4")

Saída

4

Exemplo 2

Obtenha o valor number de #datetime(2020, 3, 20, 6, 0, 0).

Usage

Number.From(#datetime(2020, 3, 20, 6, 0, 0))

Saída

43910.25

Exemplo 3

Obtenha o valor number de "12.3%".

Usage

Number.From("12.3%")

Saída

0.123