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.

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

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

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%

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!

Deixe seu feedback aqui