La función Percentage.From devuelve un valor numérico a partir de un texto representando un porcentaje.
Percentage.From(
value as any,
optional culture as nullable text
) as nullable number
- value: valor a convertir
- culture: (opcional) cadena de texto con información sobre la configuración regional a aplicar
A pesar de lo que el nombre de esta función puede sugerir, el resultado devuelto no es un porcentaje (es decir, no es un valor que exprese una cifra como una fracción en 100 partes iguales). Por el contrario, la función convierte un valor expresado como porcentaje (por ejemplo 60%) en un valor real (0.6).
Aun así, si value es un número, la función devuelve el mismo número. La verdadera utilidad de la función la encontramos cuando value es una cadena de texto que contiene el símbolo % al final pues, en este caso, la función elimina el símbolo % y convierte el resultado en el valor correspondiente.
Si value es de otro tipo, se intenta convertir a número según los criterios determinados por la función Number.From.
Por último, si value es un NULL, la función también devuelve un NULL.
Si el número indicado como parámetro es un número, la función devuelve el mismo número:
Percentage.From(65.4)
65,4
Si el valor a convertir es una cadena de texto (sin el símbolo % al final), la función intenta convertirlo en número y lo devuelve:
Percentage.From("65.4", "en-us")
65,4
Si la cadena de texto a convertir incluye el símbolo % al final, la función lo considera un porcentaje y devuelve el valor equivalente:
Percentage.From("65.4%", "en-us")
0,654
La función va a interpretar correctamente la cadena de texto aun cuando existan espacios en blanco antes o después del símbolo %:
Percentage.From("65.4 % ", "en-us")
0,654
