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

Num() formata uma expressão numericamente no formato numérico definido nas variáveis de sistema no script de carga dos dados ou no sistema operacional, a não ser que uma string de formato seja fornecida, bem como separadores decimais e de milhar opcionais.

Syntax:

Num(number[, format[, dec_sep [, thou_sep]]])

Return data type: dual

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

Arguments:

Argumentos
Argumento	Descrição
number	O número a ser formatado.
format	String que descreve como a string resultante deve ser formatada. Se omitida, será usado o formato de número definido no sistema operacional.
dec_sep	String especificando o separador de número decimal. Se omitida, o valor MoneyDecimalSep definido no script de carregamento de dados será usado.
thou_sep	String especificando o separador de número milhar. Se omitida, o valor MoneyThousandSep definido no script de carregamento de dados será usado.

Os exemplos abaixo supõem as seguintes configurações padrão:

Configuração do formato de número 1: # ##0
Configuração do formato de número 2: #,##0

Para obter mais informações sobre a formatação de números, consulte Convenções para formatos de número e hora.

Example:

Num( 35648.375 , '0.0' )

Tabela de resultados
Resultados	Configuração 1	Configuração 2
String	35 648 375	35648.375
Número	35648375	35648.375

Example:

Num( 35648, '#,##0.##', '.' , ',' )

Tabela de resultados
Resultados	Configuração 1	Configuração 2
String	35,648.00	35,648.00
Número	35648	35648

Example:

Num( pi( ), '0,00' )

Tabela de resultados
Resultados	Configuração 1	Configuração 2
String	3,14	003
Número	3.141592653	3.141592653

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 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 Sense mostrando os resultados de diferentes usos da função Num no script de carregamento. A quarta coluna da tabela contém um uso de formatação incorreto, para fins de exemplo.
Nenhuma formatação	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

Script de carregamento

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

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 Sense mostrando os resultados da função Num 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%