GitLocker: The Coding Marketplace

Description:

porextenso 0.0.1

Por Extenso
Transforma algarismos em texto por extenso, observando as regras gramaticais
Utilização
>>> import por_extenso
>>> por_extenso.numeros(2_980_033)
"dois milhões, novecentos e oitenta mil e trinta e três"
>>> por_extenso.moeda(193_034_001.01, moeda="real")
"R$ 193.034.001,01 (cento e noventa e três milhões, trinta e quatro mil e um reais e um centavo)"

Regras
Valores em moeda nacional ou estrangeira
Separam-se com vírgula as classes de números (milhar, milhão, bilhão etc.), já os algarismos dentro de cada classe são ligados com a conjunção "e" e, também, com os centavos.
Exemplos em reais:

R$ 385,62: trezentos e oitenta e cinco reais e sessenta e dois centavos.
R$ 28.385,62: vinte e oito mil, trezentos e oitenta e cinco reais e sessenta e dois centavos.
R$ 7.442.928.385,62: sete bilhões, quatrocentos e quarenta e dois milhões, novecentos e vinte e oito mil, trezentos e oitenta e cinco reais e sessenta e dois centavos.
R$ 1.000,00: mil reais.
R$ 5.000.000,00: cinco milhões de reais.
R$ 5.123.450,00: cinco milhões, cento e vinte e três mil, quatrocentos e cinquenta reais.

Exemplos em moeda estrangeira:

US$ 2.564.823,38: dois milhões, quinhentos e sessenta e quatro mil, oitocentos e vinte e três dólares americanos e trinta e oito centavos.
€ 825.236,15: oitocentos e vinte e cinco mil, duzentos e trinta e seis euros e quinze centavos.
¥ 10.815.018: dez milhões, oitocentos e quinze mil e dezoito ienes.
US$ 54.000.000,00: cinquenta e quatro milhões de dólares americanos.
€ 5.022.600,32: cinco milhões, vinte e dois mil e seiscentos euros e trinta e dois centavos.

Entre o milhão e o milhar se o valor é inferior a 101, a separação é feita com a conjunção "e".
Exemplos em reais:

R$ 2.612.100,00: dois milhões, seiscentos e doze mil e cem reais
R$ 132.010.098,00: cento e trinta e dois milhões, dez mil e noventa e oito reais

Quando o valor apresenta "zero centavo" (exemplos 4, 5 e 6), os algarismos "00" correspondentes aos centavos não são lidos nem escritos por extenso.
Exemplo:

Não se diz, vinte reais e zero centavo.

Valores redondos de milhão para cima (exemplos 5 e 10) são grafados com a preposição "de".
Exemplos:

5 milhões de reais;
42,8 bilhões de dólares.

Quando a centena é redonda ou inicia com zero, utiliza-se a preposição "e".
Exemplos:

R$ 5.018,00 (cinco mil e dezoito reais);
R$ 2.600,00 (dois mil e seiscentos reais).

Se a fração da moeda não estiver precedida de um valor inteiro, deve-se mencionar a moeda à qual a fração pertence.
Exemplos:

R$ 0,01: um centavo de real.
R$ 0,62: sessenta e dois centavos de real.
R$ 0,624: seiscentos e vinte e quatro milésimos de real.
R$ 8,056: oito reais e cinquenta e seis milésimos.
R$ 38,5328: trinta e oito reais e cinco mil, trezentos e vinte e oito décimos de milésimo.
R$ 0,03380: três mil, trezentos e oitenta centésimos de milésimo de real.
US$ 0,02: dois centavos de dólar americano (2 cents).
US$ 9,81452: nove dólares americanos e oitenta e um mil, quatrocentos e cinquenta e dois centésimos de milésimo.
€ 0,28: vinte e oito centavos de euro (28 euro cents).
€ 1.459,238562: mil, quatrocentos e cinquenta e nove euros e duzentos e trinta e oito mil, quinhentos e sessenta e dois milionésimos.

Por extenso

Caso
Exemplo

Números de um a dez
cinco zebras;dois tamanduás;nove formigas.

Números de primeiro a décimo
primeiro lugar;quarta posição;décimo piso.

Números cem e mil
cem cadernos;mil viaturas.

Início das frases
Quinze passageiros desembarcaram.Vinte e seis visitantes chegaram.Sessenta funcionários despedidos.

Números fracionários
dois terços dos eleitores;um quarto da população;um quinto dos alunos.

Transcrição de documentos
Aos vinte e dois dias do mês de abril de mil e quinhentos;Aos quinze dias do mês de julho de mil novecentos e cinquenta e dois.

Com algorismos

Caso
Exemplo

Números a partir de 11
35 zebras;17 tamanduás;62 formigas.

Números a partir de 11º
53.º lugar;78.º posição;24.º piso.

Números inferiores e superiores a dez na mesma frase
Compre, 15 maçãs, 8 peras, 12 bananas e 3 melõesNa amostra 25 solteiras e 4 viúvas.

Números decimais
10,3 habitantes por quilômetro quadrado;1,2 celular por pessoa;1,8 filho por casal.

Números grandes quebrados
2985 participantes;223 487 eleitores;6598 documentos.

Horas
às 8 horas;às 17h30;das 9h às 12h.

Datas
dia 9;24/11/1980;década de 90.

Idades
6 anos;10 anos;8 meses.

Endereços
Rua Santa Clara, 2541Rua do Riachuelo, 164 ap. 404Rua do Pila, 27 3.º andar

Valores monetários
8 reais;2 centavos;5 dólares.

Porcentagens
1%5%10%

Seriação
4.º Congresso Nacional;8.ª Feira do Livro;2.ª Conferência Financeira.

Sequência
capítulo 6;canal 9;modelo 3.

Temperatura
8 graus;34 graus;2 graus negativos.

Latitudes e longitudes
10 graus de latitude;2 graus de longitude.

Comprimentos
1 metro;3 centímetros;6 quilômetros.

Pesos
5 quilos;7 toneladas;3 quilogramas.

Capacidades
5 mililitros;8 decilitros;6 litros.

Áreas
9 metros quadrados;6 quilômetros quadrados;10 centímetros quadrados.

Volumes
2 metros cúbicos;3 decímetros cúbicos;8 metros cúbicos.

Resultados esportivos
ganhou por 3 a 1;venceu por 7 a 4;perdeu por 5 a 2.

Resultados de votação
9 votos a 8;15 votos a 4;10 votos a 2.

Mistos

Caso
Exemplo

Números grandes redondos
620 mil;70 milhões;5 bilhões.

Números acima de mil mesmo que não inteiros
2 mil;1,3 mil;4,6 mil.

Referências
https://www.normaculta.com.br/escrever-numeros-por-extenso-ou-em-algarismos/
https://www.normaculta.com.br/numeros-por-extenso/
https://www12.senado.leg.br/manualdecomunicacao/estilos/numeros
https://www.professornews.com.br/component/content/article/6872-como-escrever-valor-por-extenso
https://museulinguaportuguesa.org.br/numeros-por-extenso/