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:
| Argumento | Descriçã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. |
A tabela a seguir mostra o resultado de Num#( A, '#', '.' , ',') para diferentes valores de A.
| Exemplo | Resultado (string) | Resultado (número) |
|---|---|---|
| Num#( '35,648.31', '#', '.' , ',' ) | 35,648.31 | 35648.31 |
| Num#( ‘35 648.312’, '#', '.' , ',' ) | 35 648.312 | 35648.312 |
| Num#( '35.648,3123', '#', '.' , ',' ) | 35.648,3123 | - |
| Num#( '35 648,31234', '#', '.' , ',' ) | 35 648,31234 | - |
| Num#('1,234.56', '#,##0.00') | 1,234.56 | 1234.56 |
| Num#('$1,230.45', '$#,##0.00') | $1,230.45 | 1230.45 |
| Num#('20220315', 'YYYYMMDD') | 20220315 | 20220315 |