Formatar Número com Localidade
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 bloco Formatar Número com Localidade contendo 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.
Saiba mais
Consulte a documentação Formatação de máscaras na camada servidor para entender mais.
Símbolos utilizados
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. |