Números por extenso

Escrever por extenso

• JavaScript, biblioteca
• Python, biblioteca
• Go, biblioteca
• Ruby, biblioteca
• Rust, biblioteca
• .NET, biblioteca2 casos falham
• Erlang, biblioteca

Escreve um inteiro por extenso em português, como número cardinal. Por exemplo, 1235 é "mil duzentos e trinta e cinco".

• Aceita inteiros de -999 999 999 999 999 a 999 999 999 999 999. A função trunca um não inteiro em direção a zero e coloca "menos" antes de um número negativo.
• options.gender ("masculine" por padrão, ou "feminine") faz "um/uma", "dois/duas" e as centenas ("duzentos/duzentas") concordarem com o substantivo que o número qualifica.
• O último grupo leva um "e" antes dele só quando é menor que 100 ou uma centena redonda: 1200 é "mil e duzentos" e 1100 é "mil e cem", enquanto 1235 é "mil duzentos e trinta e cinco" e 1101 é "mil cento e um".
• Retorna uma string vazia para um valor fora desse intervalo, não finito ou que não é número.
• Zero é "zero", e também qualquer valor que trunca para 0 (-0.5, nunca "menos zero"). O resultado é sempre em minúsculas.
• Com "feminine", só o grupo dos milhares e o último grupo mudam (2000 é "duas mil", 21 é "vinte e uma"). O multiplicador de "milhão", "bilhão" e "trilhão" continua no masculino (2 000 000 é "dois milhões").

import { convertNumberToWords } from '@brazilian-utils/brazilian-utils';

convertNumberToWords(123); // "cento e vinte e três"
convertNumberToWords(1001); // "mil e um"
convertNumberToWords(2000000); // "dois milhões"
convertNumberToWords(-42); // "menos quarenta e dois"
convertNumberToWords(2, { gender: 'feminine' }); // "duas"
convertNumberToWords(12.9); // "doze" (truncado em direção a zero)
convertNumberToWords(NaN); // ""