Conversor de Yuan para Chinês Formal

O conversor de RMB em maiúsculas transforma valores numéricos na escrita financeira formal chinesa usada para renminbi. Esse estilo usa unidades como 元, 角 e 分 junto com numerais financeiros chineses para dificultar alterações em faturas, recibos, contratos, formulários de pagamento e documentos contábeis. A ferramenta é útil quando um valor em dígitos precisa ser escrito rapidamente em formato chinês verificável. Ela não é conversor de câmbio, ferramenta fiscal nem aprovação contábil. Antes de usar em documento oficial, verifique arredondamento, valores negativos, posições de zero, casas decimais e finais exigidos pela organização, como 整 ou 正.

A escrita financeira maiúscula chinesa segue a GB/T 28805 e as regras do Banco Popular da China para títulos negociáveis. Cada numeral arábico mapeia para um caractere maiúsculo resistente a adulteração (0→零, 1→壹, 2→贰, 3→叁, 4→肆, 5→伍, 6→陆, 7→柒, 8→捌, 9→玖), e os valores posicionais usam 拾, 佰, 仟 para dezenas, centenas e milhares, depois 万 e 亿 para agrupar cada quatro dígitos. Os sufixos de unidade de valor são 元 para yuan, 角 para o primeiro decimal e 分 para o segundo decimal — os únicos dois decimais carregados pelo renminbi. O conversor percorre a parte inteira do dígito mais significativo para o menos significativo. Divide o número em grupos de quatro (a quebra 万), com o segundo grupo até a posição 12 (a quebra 亿) e o terceiro grupo além disso. Dentro de um grupo, zeros consecutivos colapsam em um único marcador 零 e um zero no final do grupo é descartado, é por isso que 10.001 é lido como 壹万零壹元 e não 壹万零零壹元. A parte decimal é renderizada posição a posição como 角 e 分; se qualquer posição for zero, a regra escreve 零角 ou 零分 para impedir que o leitor insira um dígito extra, e quando ambos os decimais são zero a escrita inteira é fechada com o terminador 整 (ou sua variante 正). Casos extremos conduzem a maior parte da superfície de implementação. Valores negativos prefixam 负. Zero yuan com jiao ou fen diferente de zero descarta o elemento 元 e lê 壹角 em vez de 零元壹角. A magnitude máxima suportada é limitada por Number.MAX_SAFE_INTEGER (2^53 - 1), mas a própria regra GB/T se estende a cerca de 14 dígitos inteiros (aproximadamente 99 trilhões de yuan), além dos quais uma caminhada baseada em string com bignum substitui a aritmética de ponto flutuante. O arredondamento do terceiro decimal para cima na coluna de 分 também deve corresponder à política da organização receptora antes que a escrita seja estampada em um recibo formal.

• Tabela de dígitos: 0-9 → 零壹贰叁肆伍陆柒捌玖, formas maiúsculas anti-adulteração padronizadas pela GB/T 28805 e regras de títulos negociáveis do PBOC.
• Valores posicionais: 拾 (10), 佰 (100), 仟 (1.000), 万 (10^4), 亿 (10^8); o agrupamento é em quartetos, não em terços ocidentais.
• Colapso de zeros: zeros consecutivos dentro de um grupo de 4 dígitos colapsam em um único 零, zeros à direita em um grupo são descartados (10.001 → 壹万零壹元, não 壹万零零零壹元).
• Casas decimais: apenas 角 (1/10 de yuan) e 分 (1/100 de yuan); valores inteiros de yuan fecham com 整, posições decimais ausentes são escritas como 零角 ou 零分 para impedir inserção.
• Sinal e zero yuan: 负 prefixa negativos; 0,10 lê 壹角 (não 零元壹角); 0,00 lê 零元整.
• Limite de magnitude: as regras GB/T cobrem cerca de 14 dígitos inteiros (máx. ≈ 99.999.999.999.999,99 yuan); além de Number.MAX_SAFE_INTEGER é necessária uma caminhada baseada em string para evitar deriva de ponto flutuante.