# Num Função de script e de 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
| Argumento | Descrição |
| --- | --- |
| number | A string de texto a ser avaliada. |
| format | String que especifica como a string resultante deve ser formatada. Se omitida, os separadores decimais e de milhar definidos no script da carga de dados serão usados.
A função `Num` aceita muitas opções de formato para diferentes estruturas numéricas, por exemplo:
`#,##0`: exibe um número sem casas decimais.
`#,##0.00`: exibe um número com duas casas decimais.
`##0.00%`: exibe um número como uma porcentagem com duas casas decimais.
`#,##0;(#,##0)`: formata números negativos para que apareçam entre parênteses.
`$#,##0.00`: formata os números como moeda com o símbolo $.
`0.00E+0`: exibe números em notação científica. |
| dec\_sep | String especificando o separador de número decimal. Se omitida, o valor da variável DecimalSep definido no script da carga de dados será usado.
A função `Num` é compatível com muitos formatos de separadores decimais de números, por exemplo:
Vírgula ' `,` ': por exemplo, `$1,000,00` para mil dólares.
Ponto ' `.` ': por exemplo, `€ 1,000.00`.
Hífen ' `-` ': quando usado no lugar do ponto tradicional ou da vírgula como separador decimal, mostra valores como `¥1,000-00`.
Para obter mais informações, consulte [DecimalSep](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/NumberInterpretationVariables/DecimalSep.htm). |
| thou\_sep | String especificando o separador de número milhar. Se omitida, o valor da variável ThousandSep definido no script de carga de dados será usado.
A função `Num` oferece suporte a várias opções para o separador de milhares de números:
Ponto ' `.` ': usa um ponto para o separador de milhares (comum em alguns formatos europeus), exibido como `$1.000,00` se combinado com um separador decimal com vírgula.
Espaço ' ': usa um espaço para o separador de milhares, o que é comum em alguns países europeus. É exibido como `€ 1 000.00`.
Sublinhado '`_`': usa um sublinhado para o separador de milhares, que às vezes é usado em formatos técnicos ou regionais específicos. Exibe valores como `$1_000.00`.
Para obter mais informações, consulte [ThousandSep](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/NumberInterpretationVariables/ThousandSep.htm). |
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/May2026/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm).
Exemplo: expressões de gráfico
| Exemplo | Resultados (valor de String retornado) |
| --- | --- |
| `Num(35648.312)` | Retorna `35648.312` (depende das variáveis de ambiente no script) |
| `Num(35648.312, '0.0', '.')` | Retorna `35648.3` |
| `Num(35648.312, '0,00', ',')` | Retorna `3,56,48` |
| `Num(35648.312, '#,##0.0', '.', ',')` | Retorna `35,648.3` |
| `Num(35648.312, '# ##0', ',', ' ')` | Retorna `35 648` |
## Exemplo – Fundamentos de Num
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm)
#### Expressão de gráfico
Visão geral
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.
O script de carregamento contém:
* Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`.
* O seguinte campo em uma tabela de dados:
* `InputValue`
Script de carregamento
```
Example:
Load * inline [
InputValue
35648
3564800
356.48
];
```
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:
* ` InputValue
`
Crie as seguintes medidas:
* `=Num(InputDate)` para visualizar o valor como um número formatado usando as configurações do sistema.
* `=Num(InputValue, '0.0', '.')` para visualizar o valor como um número formatado usando o formato fornecido na função.
* `=Num(InputValue, '0,00', ',')` para visualizar o valor como um número formatado usando o formato fornecido na função.
* `=Num(InputValue, '#,##0.0', '.', ',')` para visualizar o valor como um número formatado usando o formato fornecido na função.
* `=Num(InputValue, '# ##0', ',', ' ')` para visualizar o valor como um número formatado usando o formato fornecido na função.
Results table
| InputValue | Num(InputDate) | Num(InputValue, '0.0', '.') | Num(InputValue, '0,00', ',') | Num(InputValue, '#,##0.0', '.', ',') | Num(InputValue, '# ##0', ',', ' ') |
| --- | --- | --- | --- | --- | --- |
| 356.48 | 356.48 | 356.5 | 3,56 | 356.5 | 356 |
| 35648 | 35648 | 35648.0 | 3,56,48 | 35,648.0 | 35 648 |
| 3564800 | 3564800 | 3564800.0 | 3,56,48,00 | 3,564,800.0 | 3 564 800 |
Os resultados mostram como a função `Num` pode exibir os valores do campo `InputValue` com base no formato fornecido na expressão da função.
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm)
#### Script de carregamento
A função `Num` pode ser usada 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.
Script de carregamento
No Editor da carga 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 tabela 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
];
```
Resultados
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 formatação incorreta 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 |
## Exemplo – Cenário de Num
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm)
#### Expressão de gráfico
Visão geral
Um conjunto de dados contém dados de vendas que você deseja apresentar usando um formato numérico mais simples.
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.
O script de carregamento contém:
* Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`.
* Os campos a seguir na tabela de dados:
* `Customer`
* `Sales`
Script de carregamento
```
Example:
Load * inline [
Customer, Sales
Customer A, 2550000
Customer B, 12500
Customer C, 15000
Customer D, 250
];
```
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:
* ` Customer
`
Crie a seguinte medida:
* `=If(Sales > 1000000, Num(Sales/1000000, '#,##0.00M'), If(Sales > 1000, Num(Sales/1000, '#,##0.00K'), Num(Sales, '#,##0.00')))` para definir a representação numérica dos valores.
Results table
| Customer | If(Sales > 1000000, Num(Sales/1000000, '#,##0.00M'), If(Sales > 1000, Num(Sales/1000, '#,##0.00K'), Num(Sales, '#,##0.00'))) |
| --- | --- |
| Customer A | 2.55M |
| Customer B | 12.50K |
| Customer C | 15.00K |
| Customer D | 250.00 |
A expressão de medida na coluna 2 usa a função `Num` para apresentar os dados em um formato numérico simplificado.
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm)
#### Script de carregamento
A função `Num` pode ser usada em um script de carregamento para formatar um número como uma porcentagem.
Script de carregamento
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 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 `Num`Num sendo usada no script de carregamento para formatar porcentagens.
| Discount | Discount #,##0% |
| --- | --- |
| 0 | 0% |
| 0.1 | 10% |
| 0.22 | 22% |
| 0 | 0% |
| 75 | 7,500% |
| 0.333333333333333 | 33% |
| .14 | 14% |