Конвертер юаней в китайский формальный формат

Конвертер RMB в финансовую пропись превращает числовые денежные суммы в официальную китайскую запись для жэньминьби. Такой стиль использует единицы 元, 角 и 分, а также финансовые китайские цифры, чтобы суммы в счетах, квитанциях, договорах, платежных формах и бухгалтерских документах было труднее подделать. Инструмент полезен, когда числовую сумму нужно быстро записать в проверяемом китайском формате. Это не калькулятор курса, не налоговый инструмент и не бухгалтерское утверждение. Перед официальным использованием важны округление, отрицательные суммы, нули, десятичные разряды и требования организации к окончаниям вроде 整 или 正. Ошибки лучше проверять по исходной цифре. Для формального использования нужно явно фиксировать исходную единицу, правило округления и требуемую точность.

Китайская финансовая пропись соответствует стандарту GB/T 28805 и правилам Народного банка Китая для платёжных документов. Каждая арабская цифра отображается на устойчивый к подделке иероглиф (0→零, 1→壹, 2→贰, 3→叁, 4→肆, 5→伍, 6→陆, 7→柒, 8→捌, 9→玖), а разрядные единицы используют 拾, 佰, 仟 для десятков, сотен и тысяч, затем 万 и 亿 для группировки каждых четырёх цифр. Суффиксы единиц суммы: 元 для юаней, 角 для первого десятичного разряда и 分 для второго — единственные два десятичных разряда, которые несёт жэньминьби. Конвертер обрабатывает целую часть от старшего разряда к младшему. Число разбивается на группы по четыре (разделитель 万), вторая группа до позиции 12 (разделитель 亿) и третья группа далее. Внутри группы последовательные нули сворачиваются в один маркер 零, а ноль в конце группы отбрасывается — поэтому 10 001 читается как 壹万零壹元, а не 壹万零零壹元. Десятичная часть отображается попозиционно как 角 и 分; если один из разрядов нулевой, правило записывает 零角 или 零分, чтобы читатель не мог подделать лишнюю цифру, а когда оба десятичных разряда равны нулю, целая часть замыкается терминатором 整 (или его вариантом 正). Граничные случаи определяют большую часть поверхности реализации. Отрицательные суммы получают префикс 负. Нулевая сумма юаней с ненулевым цзяо или фэнем опускает элемент 元 и читается как 壹角, а не 零元壹角. Максимальная поддерживаемая величина ограничена Number.MAX_SAFE_INTEGER (2^53 - 1), но правило GB/T само по себе простирается примерно до 14 целых цифр (порядка 99 триллионов юаней), за которыми обход числа в строковом представлении заменяет арифметику с плавающей запятой. Округление третьего десятичного разряда вверх до колонки 分 также должно соответствовать политике принимающей организации до того, как пропись будет проставлена на официальном чеке.

• Таблица цифр: 0-9 → 零壹贰叁肆伍陆柒捌玖, устойчивые к подделке формы, стандартизированные GB/T 28805 и правилами PBOC для платёжных документов.
• Разрядные единицы: 拾 (10), 佰 (100), 仟 (1 000), 万 (10^4), 亿 (10^8); группировка по четыре, а не по три, как на Западе.
• Свёртка нулей: последовательные нули внутри 4-значной группы сворачиваются в один 零, конечные нули группы отбрасываются (10 001 → 壹万零壹元, а не 壹万零零零壹元).
• Десятичные разряды: только 角 (1/10 юаня) и 分 (1/100 юаня); целые суммы замыкаются 整, отсутствующие десятичные разряды записываются как 零角 или 零分 для предотвращения вставки.
• Знак и нулевая сумма: префикс 负 для отрицательных; 0.10 читается как 壹角 (а не 零元壹角); 0.00 читается как 零元整.
• Ограничение по величине: правила GB/T покрывают ≈ 14 целых цифр (макс. ≈ 99 999 999 999 999,99 юаней); при превышении Number.MAX_SAFE_INTEGER требуется обход числа в строковом представлении для избежания дрейфа плавающей точки.