Currency.From

Sintaxe

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

Sobre

Retorna um valor currency do value especificado. Se o value fornecido for null, Currency.From retornará null. Se o value especificado for number dentro do intervalo de moeda, a parte fracionária do value será arredondada para quatro dígitos decimais e retornada. Se value for de qualquer outro tipo, ele será convertido primeiro em um number usando Number.FromText. O intervalo válido para a moeda é -922,337,203,685,477.5808 para 922,337,203,685,477.5807. Veja Number.Round para ver os modos de arredondamento disponíveis. O padrão é RoundingMode.ToEven. Uma culture opcional também pode ser fornecida (por exemplo, "pt-BR").

Exemplo 1

Obtenha o valor currency de "1.23455".

Usage

Currency.From("1.23455")

Saída

1.2346

Exemplo 2

Obtenha o valor currency de "1.23455" usando RoundingMode.Down.

Usage

Currency.From("1.23455", "en-US", RoundingMode.Down)

Saída

1.2345