Package: por-extenso
Por ExtensoTransforma algarismos em texto por extenso, observando as regras gramaticaisUtilizaçã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)"RegrasValores em moeda nacional ou estrangeiraSeparam-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 reaisR$ 132.010.098,00: cento e trinta e dois milhões, dez mil e noventa e oito reaisQuando 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 extensoCasoExemploNúmeros de um a dezcinco zebras;dois tamanduás;nove formigas.Números de primeiro a décimoprimeiro lugar;quarta posição;décimo piso.Números cem e milcem cadernos;mil viaturas.Início das frasesQuinze passageiros desembarcaram.Vinte e seis visitantes chegaram.Sessenta funcionários despedidos.Números fracionáriosdois terços dos eleitores;um quarto da população;um quinto dos alunos.Transcrição de documentosAos 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 algorismosCasoExemploNúmeros a partir de 1135 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 fraseCompre, 15 maçãs, 8 peras, 12 bananas e 3 melõesNa amostra 25 solteiras e 4 viúvas.Números decimais10,3 habitantes por quilômetro quadrado;1,2 celular por pessoa;1,8 filho por casal.Números grandes quebrados2985 participantes;223 487 eleitores;6598 documentos.Horasàs 8 horas;às 17h30;das 9h às 12h.Datasdia 9;24/11/1980;década de 90.Idades6 anos;10 anos;8 meses.EndereçosRua Santa Clara, 2541Rua do Riachuelo, 164 ap. 404Rua do Pila, 27 3.º andarValores monetários8 reais;2 centavos;5 dólares.Porcentagens1%5%10%Seriação4.º Congresso Nacional;8.ª Feira do Livro;2.ª Conferência Financeira.Sequênciacapítulo 6;canal 9;modelo 3.Temperatura8 graus;34 graus;2 graus negativos.Latitudes e longitudes10 graus de latitude;2 graus de longitude.Comprimentos1 metro;3 centímetros;6 quilômetros.Pesos5 quilos;7 toneladas;3 quilogramas.Capacidades5 mililitros;8 decilitros;6 litros.Áreas9 metros quadrados;6 quilômetros quadrados;10 centímetros quadrados.Volumes2 metros cúbicos;3 decímetros cúbicos;8 metros cúbicos.Resultados esportivosganhou por 3 a 1;venceu por 7 a 4;perdeu por 5 a 2.Resultados de votação9 votos a 8;15 votos a 4;10 votos a 2.MistosCasoExemploNúmeros grandes redondos620 mil;70 milhões;5 bilhões.Números acima de mil mesmo que não inteiros2 mil;1,3 mil;4,6 mil.Referênciashttps://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/numeroshttps://www.professornews.com.br/component/content/article/6872-como-escrever-valor-por-extensohttps://museulinguaportuguesa.org.br/numeros-por-extenso/