Formata o número de acordo com a máscara e a localidade.
Parâmetros de Entrada
Nome
Tipo
Doc
Parâmetro 1
String
Conteúdo a ser formatado.
Parâmetro 2
String
Máscara.
Parâmetro 3
String
Recebe a sigla da língua em minúsculo.
Parâmetro 4
String
Recebe a sigla do país em maiúsculo.
Retorno
Retorna uma String.
Compatibilidade
Servidor
Exemplo
A função abaixo recebe na variável "numeroFormatado" o blocoFormatar Número com Localidadecontendo um número e uma máscara seguido de sua Língua e País (Figura 1).
Figura 1 - Bloco Formatar Número com Localidade
Em seguida, imprime o retorno no console do depurador (Figura 2).
Figura 2 - Retorno no console da função referente à figura 1
Sobre máscara
A máscara realiza uma adequação do número para o formato desejado, ela pode adicionar traços, separadores, limitar a quantidade de dígitos exibidos e algumas outras mudanças. Os usos mais típicos são para datas, horários, números, moedas, entre outros.
O exemplo mostra 3 símbolos e na tabela abaixo está o que cada um representa.
Símbolo
Descrição
#
um dígito, zero aparece como ausente.
.
espaço reservado para um separador decimal.
,
espaço reservado para separador de agrupamento.
¤
sinal de moeda; substituído por símbolo de moeda; se duplicado, substituído pelo símbolo de moeda internacional; se estiver presente em um padrão, o separador decimal monetário é usado em vez do separador decimal.