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