Early Access: The content on this website is provided for informational purposes only in connection with pre-General Availability Qlik Products.
All content is subject to change and is provided without warranty.
Ir para conteúdo principal Pular para conteúdo complementar

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
ArgumentoDescriçã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 de carregamento 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 de carregamento 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.

thou_sep String especificando o separador de número milhar. Se omitida, o valor da variável ThousandSep definido no script de carregamento 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.

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

Exemplo: expressões de gráfico
ExemploResultados (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

Exemplo – Cenário de Num

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!