A função Formatar Número retorna uma sequência que é um número formatado para se ajustar ao padrão especificado.
Parâmetro: número
O número a ser formatado. Isto pode vir de um nó de origem, o resultado de uma outra função ou um valor especificado.
Parâmetro: cadeia
Retorna: cadeia
O primeiro parâmetro reformatado para refletir o padrão especificado pelo segundo parâmetro.
Os padrões podem ter texto constante como um prefixo, sufixo ou ambos. Os usos comuns são para especificar o símbolo monetário ou alguma unidade de medida.
Exemplo 1$#,##0.00 – formata um número no formato padrão para dólares americanos com o sinal de dólar, vírgulas para separadores e pelo menos um dígito para dólar e dois dígitos para centavos.
format-number(12345.6789,'$#,##0.00') = '$12,345.67'#0.000% – formata um número decimal como uma porcentagem com pelo menos três posições decimais.
format-number(.67890123,'#0.000%') = '67.890%'Quando o símbolo de porcentagem está presente, o número de entrada é multiplicado por 100.
Exemplo 3#,##0.00;(#,##0.00) – formata número negativo com parênteses, um formato normalmente usado em contabilidade.
format-number(-12345.6789,'#,##0.00;(#,##0.00)') = '(12,345.67)'