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. |
| 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. |
| 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 tabla siguiente muestra el resultado de Num#( A, '#', '.' , ',') para diferentes valores de A.
| Ejemplo | Resultado (cadena de caracteres) | Resultado (número) |
|---|---|---|
| Num#( '35,648.31', '#', '.' , ',' ) | 35,648.31 | 35648.31 |
| Num#( ‘35 648.312’, '#', '.' , ',' ) | 35 648.312 | 35648.312 |
| Num#( '35.648,3123', '#', '.' , ',' ) | 35.648,3123 | - |
| Num#( '35 648,31234', '#', '.' , ',' ) | 35 648,31234 | - |
| Num#('1,234.56', '#,##0.00') | 1,234.56 | 1234.56 |
| Num#('$1,230.45', '$#,##0.00') | $1,230.45 | 1230.45 |
| Num#('20220315', 'YYYYMMDD') | 20220315 | 20220315 |