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

Num() da formato a un número, es decir, convierte el valor numérico de la entrada para mostrar texto en vez, 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(number[, 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 el valor numérico de la expresión introducida y genera una cadena que representa el número.

Argumentos:

Argumentos

| Argumento | Descripción |
| --- | --- |
| number | El número al que se ha de dar formato. |
| format | Cadena que describe qué formato habrá de tener la cadena resultante. 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. |

Para obtener más información sobre el formato de números, vea [Convenciones para formatos de número y tiempo](https://help.qlik.com/es-ES/sense/November2024/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm).

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm)

#### Ejemplo: Expresión de gráfico

Ejemplo:

La tabla siguiente muestra los resultados cuando el campo A es igual a 35648.312.

Resultados

| A | Resultado |
| --- | --- |
| Num(A) | 35648.312 (depende de las variables de entorno en el script) |
| Num(A, '0.0', '.') | 35648.3 |
| Num(A, '0,00', ',') | 35648,31 |
| Num(A, '#,##0.0', '.', ',') | 35,648.3 |
| Num(A, '# ##0', ',', ' ') | 35 648 |

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm)

#### Ejemplo: Script de carga

Script de carga

Num se puede usar en el script de carga para dar formato a un número, incluso si los separadores de miles y decimales ya están configurados en el script. El script de carga siguiente incluye separadores de miles y decimales específicos, pero luego usa Num para dar formato a los datos de diferentes maneras.

En el Editor de carga de datos, cree una nueva sección y luego agregue el script de ejemplo y ejecútelo. A continuación, agregue como mínimo los campos de la columna de resultados en una hoja de su app para ver el resultado.

```
SET ThousandSep=',';
SET DecimalSep='.';
Transactions:
Load
*,
Num(transaction_amount) as [No formatting],
Num(transaction_amount,'0') as [0],
Num(transaction_amount,'#,##0') as [#,##0],
Num(transaction_amount,'# ###,00') as [# ###,00],
Num(transaction_amount,'# ###,00',',',' ') as [# ###,00 , ',' , ' '],
Num(transaction_amount,'#,###.00','.',',') as [#,###.00 , '.' , ','],
Num(transaction_amount,'$#,###.00') as [$#,###.00],
;
Load * Inline [
transaction_id, transaction_date, transaction_amount, transaction_quantity, discount, customer_id, size, color_code
3750, 20180830, 12423.56, 23, 0,2038593, L, Red
3751, 20180907, 5356.31, 6, 0.1, 203521, m, orange
3752, 20180916, 15.75, 1, 0.22, 5646471, S, blue
3753, 20180922, 1251, 7, 0, 3036491, l, Black
3754, 20180922, 21484.21, 1356, 75, 049681, xs, Red
3756, 20180922, -59.18, 2, 0.333333333333333, 2038593, M, Blue
3757, 20180923, 3177.4, 21, .14, 203521, XL, Black
];
```

Tabla de Qlik SenseQlik Sense que muestra los resultados de la función NumNum en el script de carga. La cuarta columna de la tabla contiene un uso de formato incorrecto, a modo de ejemplo.

| No formatting | 0 | #,##0 | # ###,00 | # ###,00 , ',' , ' ' | #,###.00 , '.' , ',' | $#,###.00 |
| --- | --- | --- | --- | --- | --- | --- |
| -59.18 | -59 | -59 | -59###,00 | -59,18 | -59.18 | $-59,18 |
| 15.75 | 16 | 16 | 16###,00 | 15,75 | 15.75 | $15,75 |
| 1251 | 1251 | 1,251 | 1251###,00 | 1 251,00 | 1,251.00 | $1,251.00 |
| 3177.4 | 3177 | 3,177 | 3177###,00 | 3 177,40 | 3,177.40 | $3,177.40 |
| 5356.31 | 5356 | 5,356 | 5356###,00 | 5 356,31 | 5,356.31 | $5,356.31 |
| 12423.56 | 12424 | 12,424 | 12424###,00 | 12 423,56 | 12,423.56 | $12,423.56 |
| 21484.21 | 21484 | 21,484 | 21484###,00 | 21 484,21 | 21,484.21 | $21,484.21 |

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm)

#### Ejemplo: Script de carga

Script de carga

Num se puede utilizar en un script de carga para dar formato a un número como un porcentaje.

En el Editor de carga de datos, cree una nueva sección y luego agregue el script de ejemplo y ejecútelo. A continuación, agregue como mínimo los campos de la columna de resultados en una hoja de su app para ver el resultado.

```
SET ThousandSep=',';
SET DecimalSep='.';
Transactions:
Load
*,
Num(discount,'#,##0%') as [Discount #,##0%]
;
Load * Inline [
transaction_id, transaction_date, transaction_amount, transaction_quantity, discount, customer_id, size, color_code
3750, 20180830, 12423.56, 23, 0,2038593, L, Red
3751, 20180907, 5356.31, 6, 0.1, 203521, m, orange
3752, 20180916, 15.75, 1, 0.22, 5646471, S, blue
3753, 20180922, 1251, 7, 0, 3036491, l, Black
3754, 20180922, 21484.21, 1356, 75, 049681, xs, Red
3756, 20180922, -59.18, 2, 0.333333333333333, 2038593, M, Blue
3757, 20180923, 3177.4, 21, .14, 203521, XL, Black
];
```

Tabla de Qlik SenseQlik Sense que muestra los resultados de la función NumNum utilizada en el script de carga para dar formato de porcentajes.

| Discount | Discount #,##0% |
| --- | --- |
| 0.333333333333333 | 33% |
| 0.22 | 22% |
| 0 | 0% |
| .14 | 14% |
| 0.1 | 10% |
| 0 | 0% |
| 75 | 7,500% |