Primitiva formatar() para tipo número

[leonelsanchesdasilva]

Hoje Delégua ainda não possui uma forma de formatar um número como texto, definindo, por exemplo, quantas casas decimais antes e após a vírgula devem ser usadas, ou símbolos de separação de decimais e unidades de milhar.

Aprendendo como outros dialetos fazem, levantei os seguintes operadores e formas de uso:

VisuAlg

Escreval("Variável: ", minhaVariavel:5:2) // Imprime 5 casas inteiras (ou espaços, se não houver as casas inteiras correspondentes)
                                                              // e duas casas decimais

Portugol Studio

Aparentemente não possui um recurso de formatação.

Potigol

123.45 formato "%.1f"             # "123.4"

Mapler

Aparentemente não possui um recurso de formatação.

Qual seria uma boa forma de formatar números em Delégua? Deixo abaixo algumas ideias. Fique à vontade para sugerir qualquer outra alternativa.

• Usar a mesma notação do VisuAlg
• número ganharia uma primitiva (método) .formatar(), podendo trabalhar com quatro argumentos:
  • número de casas antes do separador decimal (obrigatório)
  • número de casas após o separador decimal (obrigatório)
  • separador decimal (opcional, padrão ',')
  • separador de milhar (opcional, padrão '.')
• A primitiva .formatar() podendo trabalhar com uma máscara de formatação, como Potigol

[ItaloCobains]

Referente à Delégua, gostei bastante de sua ideia. Uma melhoria interessante seria utilizar um objeto configurável como parâmetro em vez de múltiplos parâmetros posicionais. Se não me engano, Delégua tem suporte a tipos, então essa abordagem combinaria bem com os recursos da linguagem.

Ex:

num.formatar({
  minimoAntes: 1,
  depois: 2,
  dec: ",",
  mil: "."
})

[leonelsanchesdasilva]

Gosto muito da ideia de passar um objeto também. Obrigado!

[pablotdv]

Acredito que, por se tratar de uma iniciativa de uma linguagem de programação em português, seja importante levar em consideração os principais formatos de números nos países que falam a língua portuguesa:

País	Separador decimal	Separador de milhar	Exemplo de número	População estimada (2024)
Brasil	Vírgula (,)	Ponto (.)	1.234,56	203 milhões
Portugal	Vírgula (,)	Espaço ( )	1 234,56	10,2 milhões
Angola	Vírgula (,)	Espaço ou ponto	1 234,56	36 milhões
Moçambique	Vírgula (,)	Espaço ou ponto	1 234,56	34 milhões
Cabo Verde	Vírgula (,)	Espaço ou ponto	1 234,56	0,6 milhão (600 mil)
Guiné-Bissau	Vírgula (,)	Espaço ou ponto	1 234,56	2,1 milhões
São Tomé e Príncipe	Vírgula (,)	Espaço ou ponto	1 234,56	0,2 milhão (220 mil)
Timor-Leste	Vírgula (,)	Ponto ou espaço	1.234,56	1,4 milhão

Fonte: ChatGPT

Eu usaria essa informação para definir a formatação padrão para a linguagem, e adicionaria também a ideia do @ItaloCobains de ter um método para possibilitar a customização.
Mas talvez só faria de uma forma onde alteraria a cultura global da aplicação, que serviria para todo e qualquer novo formatador ou pros já existentes (data, moeda...).

[leonelsanchesdasilva]

Obrigado pelo insight. Quero tratar a implementação de culturas em outra discussão, mas tudo isso é ótimo.

[JohnPetros]

Além de formatar a parte decimal do número, ser possível formatar moedas e para porcentagem também.
O Intl.Numberformat do JS pode servir de inspiração.

const number = 1234567.89;

// Formato padrão para o Brasil (separador decimal vírgula, separador de milhar ponto)
console.log(new Intl.NumberFormat('pt-BR').format(number)); // Ex: 1.234.567,89

// Formato de moeda para os EUA (símbolo de dólar, separador decimal ponto)
console.log(new Intl.NumberFormat('en-US', { style: 'currency', currency: 'USD' }).format(number)); // Ex: $1,234,567.89

// Formato de porcentagem para o Brasil
console.log(new Intl.NumberFormat('pt-BR', { style: 'percent' }).format(0.75)); // Ex: 75%

[leonelsanchesdasilva]

É exatamente o que imaginei usar para culturas. Obrigado!