# Num – função de script e gráfico

Num() formata um número, ou seja, converte o valor numérico da entrada para exibir texto usando o formato especificado no segundo parâmetro. Se o segundo parâmetro for omitido, ele usará os separadores decimais e de milhar definidos no script de carregamento de dados. Símbolos de separadores decimais e de milhar personalizados são parâmetros opcionais.

Sintaxe:

Num(number[, format[, dec\_sep [, thou\_sep]]])

Tipo de dados de retorno: dual

A função Num retorna um valor duplo como a string e o valor numérico. Ela usa o valor numérico da expressão de entrada e gera uma string representando o número.

Argumentos:

Argumentos

| Argumento | Descrição |
| --- | --- |
| number | O número a ser formatado. |
| format | String que especifica como a string resultante deve ser formatada. Se omitida, os separadores decimais e de milhar definidos no script de carregamento de dados serão usados. |
| dec\_sep | String que especifica o separador de número decimal. Se omitida, o valor da variável DecimalSep definido no script de carregamento de dados será usado. |
| thou\_sep | String que especifica o separador de número milhar. Se omitida, o valor da variável ThousandSep que é definido no script de carregamento de dados será usado. |

Para obter mais informações sobre a formatação de números, consulte [Convenções para formatos de número e hora](https://help.qlik.com/pt-BR/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)

#### Exemplo: Expressão de gráfico

Exemplo:

A tabela a seguir mostra os resultados quando o campo A é igual a 35648.312.

Resultados

| A | Resultado |
| --- | --- |
| Num(A) | 35648.312 (depende de variáveis de ambiente no 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)

#### Exemplo: Script de carregamento

Script de carregamento

Num pode ser usado no script de carregamento para formatar um número, mesmo que os separadores de milhar e decimal já estejam definidos no script. O script de carregamento abaixo inclui separadores de milhar e decimal específicos, mas depois usa Num para formatar dados de maneiras diferentes.

No Editor de carregamento de dados, crie uma nova seção e, em seguida, adicione o script de exemplo e execute-o. Em seguida, adicione pelo menos os campos listados na coluna de resultados a uma pasta em seu aplicativo para ver o 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
];
```

Tabela Qlik SenseQlik Sense mostrando os resultados de diferentes usos da função NumNum no script de carregamento. A quarta coluna da tabela contém um uso de formatação incorreto, para fins de exemplo.

| 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)

#### Exemplo: Script de carregamento

Script de carregamento

Num pode ser usado em um script de carregamento para formatar um número como uma porcentagem.

No Editor de carregamento de dados, crie uma nova seção e, em seguida, adicione o script de exemplo e execute-o. Em seguida, adicione pelo menos os campos listados na coluna de resultados a uma pasta para ver o 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
];
```

Tabela Qlik SenseQlik Sense mostrando os resultados da função NumNum sendo usada no script de carregamento para formatar porcentagens.

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