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 valornumber
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 paratrue
, 0 parafalse
.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 devalue
.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