La función Currency.From devuelve un valor tipo moneda a partir de un elemento.
Currency.From(
value as any,
optional culture as nullable text,
optional roundingMode as nullable number
) as nullable number
- value: valor a transformar
- culture: (opcional) cadena de texto con información sobre la configuración regional a aplicar
- roundingMode: (opcional) modo de redondeo
El intervalo válido tipo moneda (o currency) es de -922.337.203.685.477,5808 a 922.337.203.685.477,5807. Si el elemento value es un número en este rango, se redondea a cuatro decimales y se devuelve. Véase Number.Round para obtener más información sobre los métodos de redondeo.
Si value es un elemento de otro tipo, la función Currency.From intentará convertirlo a un número. Si esta conversión es posible, redondeará el resultado a cuatro cifras decimales y lo devolverá. Si no es posible, la función devolverá un error. Véase Number.FromText para obtener información sobre la conversión de textos en números.
Si value es un null, la función devolverá un null también.
Podemos convertir el número PI a un valor de tipo moneda con la siguiente instrucción:
Currency.From(Number.PI)
3,1416
Si el valor a transformar es una cadena de texto representando un número con formato regional de inglés-Estados Unidos, podemos usar la siguiente instrucción:
Currency.From("18.123456789", "en-us")
18,1235
