La función Number.FromText devuelve un valor numérico a partir de un texto.
Number.FromText(
text as nullable text,
optional culture as nullable text
) as nullable number
- text: texto a convertir a valor numérico
- culture: (opcional) cadena de texto con información sobre la configuración regional a aplicar
El texto deberá contener un número con un formato reconocible (entero, decimal, exponencial...). En otro caso la función devuelve un mensaje de error.
Podemos convertir un texto conteniendo la representación de un número entero en número entero:
Number.FromText("18")
18
Si el texto contiene la representación de un número real, por defecto será interpretado de acuerdo a la configuración regional del equipo. Si se trata de la configuración de España ("es-es"):
Number.FromText("3,1415")
3,1415
Sin embargo, si el número representado en el texto tuviese una configuración regional diferente, sería necesario especificarlo usando el parámetro culture:
Number.FromText("3.1415", "en-US")
3,1415
...pues, en otro caso, la conversión no se realizaría correctamente:
Number.FromText("3.1415")
31415
El número representado en text puede tener formato científico:
Number.FromText("3,14E+01")
31,4
Si el texto no contiene un número o éste no tiene un formato reconocible, se devolverá un mensaje de error:
Number.FromText("+ 2")
Error
En el ejemplo anterior se ha introducido un espacio en blanco entre el signo + y el número, lo que impide su correcta interpretación.
