Saltar al contenido principal Saltar al contenido complementario

Num# - función de script y de gráfico

Num#() interpreta una cadena de texto como un valor numérico, es decir, convierte la cadena de entrada en un número utilizando el formato especificado en el segundo parámetro. Si se omite el segundo parámetro, utiliza los separadores de decimal y de miles definidos en el script de carga de datos. Los símbolos de separador decimal o de miles personalizados son parámetros opcionales.

Sintaxis:  

Num#(text[, format[, dec_sep [, thou_sep ] ] ])

Tipo de datos que devuelve: dual

La función Num#() devuelve un valor dual con la cadena y el valor numérico. La función toma la representación textual de la expresión introducida y genera un número. No cambia el formato del número; el resultado de salida tiene el mismo formato que la entrada.

Argumentos
Argumento Descripción
text La cadena de texto que se ha de evaluar.
format Cadena que especifica el formato de número utilizado en el primer parámetro. Si se omite el segundo parámetro, utiliza los separadores de decimal y de miles definidos en el script de carga de datos.

La función Num# admite muchas opciones de formato para diferentes estructuras numéricas, por ejemplo:

#,##0: muestra un número sin decimales.

#,##0.00: muestra un número con dos decimales.

##0.00%: muestra un número como porcentaje con dos decimales.

​#,##0;(#,##0): da formato a los números negativos para que aparezcan entre paréntesis.

$#,##0.00: da formato los números como moneda con el símbolo $.

​0.00E+0: da formato a los números en notación científica.

dec_sep Cadena que especifica el separador numérico decimal. Si se omite, se utilizará el valor de la variable DecimalSep establecido en el script de carga de datos.

La función Num# admite muchos formatos de separador decimal de números, por ejemplo:

Signo de coma ",": por ejemplo, $1,000,00 para mil dólares.

Signo de punto "."': por ejemplo, € 1,000.00.

Signo de guión "-": cuando se utiliza en lugar del punto o la coma tradicionales como separador decimal, muestra valores como ¥1,000-00.

Para más información, consulte DecimalSep.

thou_sep Cadena que especifica el separador numérico de miles. Si se omite, se utilizará el valor de la variable ThousandSep establecido en el script de carga de datos.

La función Num# admite muchas opciones para el separador de miles:

Signo de punto ".": utiliza un punto como separador de miles (común en algunos formatos europeos), mostrándose como $1.000,00 si se combina con un separador decimal de coma.

Un espacio ​" ": utiliza un espacio como separador de miles, algo que es habitual en algunos países europeos. Se mostraría así: € 1 000.00.

Signo de guión bajo "_": utiliza un guión bajo como separador de miles, que a veces se utiliza en formatos técnicos o regionales específicos. Muestra valores como $1_000.00.

Para más información, consulte ThousandSep.

Ejemplo: Expresiones de gráficos
EjemploResultados (valor de cadena que devuelve)
Num#( '35,648.31', '#', '.' , ',' )Devuelve la cadena de 35,648.31 y el valor numérico de 35648.31.
Num#( ‘35 648.312’, '#', '.' , ',' ) Devuelve la cadena de 35 648.312 y el valor numérico de 35648.312.
Num#( '35.648,3123', '#', '.' , ',' )Devuelve la cadena de 35.648,3123 y el valor numérico de NULL (-).
Num#( '35 648,31234', '#', '.' , ',' )Devuelve la cadena de 35 648,31234 y el valor numérico de NULL (-).
Num#('1,234.56', '#,##0.00')Devuelve la cadena de 1,234.56 y el valor numérico de 1230.45.
Num#('$1,230.45', '$#,##0.00')Devuelve la cadena de $1,230.45 y el valor numérico de 1234.56.
Num#('20220315', 'YYYYMMDD')Devuelve la cadena de 20220315 y el valor numérico de 20220315.

Ejemplo: fundamentos de Num#

Ejemplo: escenario de Num#.

¿Esta página le ha sido útil?

No dude en indicarnos en qué podemos mejorar si encuentra algún problema en esta página o su contenido, como, por ejemplo, errores tipográficos, pasos que falta o errores técnicos.