Percentage.From

La función Percentage.From devuelve un valor numérico a partir de un texto representando un porcentaje.

Sintaxis

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

Parámetros
  • value: valor a convertir
  • culture: (opcional) cadena de texto con información sobre la configuración regional a aplicar
Información adicional

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.

Ejemplos

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

Función Percentage.From

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

Función Percentage.From

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

Función Percentage.From

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

Función Percentage.From
Categoría
Funciones numéricas
Submitted by admin on Sun, 04/05/2020 - 09:19