sc_format_num({Meu_Campo}, "Simb_Grp", "Simb_Dec", "Qtde_Dec", "Enche_Zeros", "Lado_Neg", "Simb_Monetário", "Lado_Simb_Monetario")

Esta macro tem por objetivo a formatação de valores numéricos.

Parâmetro
Descrição
Meu_Campo Variável ou campo que contena o valor a ser formatado (O retorno será na própria variável).
Simb_Grp Símbolo de agrupamento dos valores inteiros.
Simb_Dec Símbolo para o separador de decimais.
Qtde_Dec Quantidade de decimais a ser exibida.
Enche_Zeros Completa com zeros as decimais inexistentes (S = sim e N = não).
Lado_Neg Lado onde o sinal de negativo deve ser exibido (1 = esquerdo e 2 = direito).
Simb_Monetário Símbolo monetário a ser exibido.
Lado_Simb_Monetário Lado onde o símbolo monetário será exibido (1 = esquerdo e 2 = direito).

 

 

Ex. 1: Formatando um número inteiro.
sc_format_num({meu_valor}, '.', '', 0, 'N', '1', '');
Valor de entrada = 001234567890
Valor de saída = 1.234.567.890

Ex. 2: Formatando um valor negativo e desprezando as casas decimais.
sc_format_num({meu_valor}, '.', '', 0, 'N', '1', '');
Valor de entrada = -0012345678.90
Valor de saída = -12.345.678

Ex. 3: Formatando um valor com 4 casas decimais e prenchendo com zeros.
sc_format_num({meu_valor}, '.', ',', '4', 'S', '1', '');
Valor de entrada = 0012345678.9
Valor de saída = 12.345.678,9000

Ex. 4: Formatando um valor com 2 casas decimais, prenchendo com zeros e utilizando símbolo monetário.
sc_format_num({meu_valor}, '.', ',', '2', 'S', '1', 'R$');
Valor de entrada = 0012345678.9
Valor de saída = R$ 12.345.678,90

Ex. 5: Formatando um valor com 2 casas decimais, prenchendo com zeros.
sc_format_num({meu_valor}, '.', ',', '2', 'S', '1', '');
Valor de entrada = .9
Valor de saída = 0,90