Ir para conteúdo principal Pular para conteúdo complementar

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

Num#() interpreta uma string de texto como um valor numérico, ou seja, converte a string de entrada em um número 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#(text[, 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. A função usa a representação textual da expressão de entrada e gera um número. Ela não altera o formato do número; a saída é formatada da mesma forma que a entrada.

Argumentos
ArgumentoDescrição
text A string de texto a ser avaliada.
format

String que especifica o formato de número usado no primeiro parâmetro. 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 definido no script de carregamento de dados será usado.

Exemplo: expressões de gráfico
ExemploResultado (string) Resultado (número)
Num#( '35,648.31', '#', '.' , ',' )35,648.3135648.31
Num#( ‘35 648.312’, '#', '.' , ',' )35 648.31235648.312
Num#( '35.648,3123', '#', '.' , ',' )35.648,3123-
Num#( '35 648,31234', '#', '.' , ',' )35 648,31234-
Num#('1,234.56', '#,##0.00')1,234.561234.56
Num#('$1,230.45', '$#,##0.00')$1,230.451230.45
Num#('20220315', 'YYYYMMDD')2022031520220315

Exemplo - Fundamentos 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!