Transforma algarismos em texto por extenso, observando as regras gramaticais
Project description
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ões Na 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, 2541 Rua do Riachuelo, 164 ap. 404 Rua 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/
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for por_extenso-0.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1a69efe37b63b6cc036b36618d7cb5157ce7fd4950984b050119010fec35437c |
|
MD5 | 1bcc56b77cfc54f8e058618895466423 |
|
BLAKE2b-256 | 914c97c5f2dbf2508ea046fb1f947e51b73dd04390b3a2b4b0f06af4df841746 |