Nzh

Nzh используется для преобразования арабских цифр в китайские и наоборот.
Особенности:

• преобразование происходит в виде строк, нет проблем с очень большими числами и десятичными дробями (пожалуйста, самостоятельно округлите исходные данные);
• поддерживается преобразование научных обозначений;
• поддерживает разговорный стиль;
• поддерживает пользовательские настройки (можно использовать как «兆», так и «京»);
• для очень больших чисел вместо «亿亿» рекомендуется использовать «万万»;
• конечно, вы также можете преобразовать китайские цифры обратно в арабские.

Установка

$ npm install nzh --save
$ bower install nzh --save

Использование

var Nzh = require("nzh");
var nzhcn = require("nzh/cn"); //使用简体中文
var nzhhk = require("nzh/hk"); //繁体中文

Примечание: при использовании в браузере рекомендуется использовать файлы из папки dist/ (поддерживаются CMD,AMD).

Пример

var nzhcn = Nzh.cn;                 // 使用简体中文,  另外有 Nzh.hk -- 繁体中文

nzhcn.encodeS(100111);              // 转中文小写 >> 十万零一百一十一
nzhcn.encodeB(100111);              // 转中文大写 >> 壹拾万零壹佰壹拾壹
nzhcn.encodeS("1.23456789e+21");    // 科学记数法字符串 >> 十二万三千四百五十六万万七千八百九十万亿
nzhcn.toMoney("100111.11");         // 转中文金额 >> 人民币壹拾万零壹佰壹拾壹元壹角壹分

API

Nzh.cn / Nzh.hk

Для удобства использования по умолчанию реализованы два объекта:

• Nzh.cn — упрощённый китайский;
• Nzh.hk — традиционный китайский (упрощённый китайский).

Оба содержат следующие методы:

• encodeS(num,options) — преобразование в китайский язык в нижнем регистре;
• encodeB(num,options) — преобразование в китайский язык в верхнем регистре;
• toMoney(num,options) — конвертация в китайскую валюту;
• decodeS(zh_num) — преобразование китайских цифр нижнего регистра в числа;
• decodeB(zh_num) — преобразование китайских цифр верхнего регистра в числа.

// options.tenMin

// encodeS默认true
nzhcn.encodeS("13.5");                 // 十三点五
nzhcn.encodeS("13.5", {tenMin:false}); // 一十三点五
// encodeB默人false
nzhcn.encodeB("13.5");                 // 壹拾叁點伍
nzhcn.encodeB("13.5", {tenMin:true});  // 拾叁點伍

// options.ww

//Nzh.cn和Nzh.hk未引入兆、京等单位，超千万亿位时，默认以争议较少的万万亿为单位
nzhcn.encodeS(1e16);                // 一万万亿
nzhcn.encodeS(1e16, {ww: false});   // 一亿亿


// options.outputString

console.log(nzhcn.decodeS('一万万万万亿', {outputString: false}));   // 1e+24
console.log(nzhcn.decodeS('一万万万万亿', {outputString: true}));    // "1000000000000000000000000"

// options.complete

nzhcn.toMoney("1");                        //人民币壹元整
nzhcn.toMoney("1",{complete:true});        //人民币壹元零角零分
nzhcn.toMoney("0.1");                      //人民币壹角
nzhcn.toMoney("0.1",{unOmitYuan:true});    //人民币零元壹角
nzhcn.toMoney("0.1",{complete:true});      //人民币零元壹角零分

//outSymbol  默认 true
nzhcn.toMoney("1");                        //人民币壹元整
nzhcn.toMoney("1",{outSymbol:false});      //壹元整

Описание параметров

• tenMin: переключатель для разговорного стиля, связанного с числом «десять», значение по умолчанию — false;
  Примечание: в методах encodeS объектов Nzh.cn и Nzh.hk значение по умолчанию равно true.
• ww: переключатель «万万», значение по умолчанию — true;
• outputString — при преобразовании китайских цифр в арабские цифры выводит результат в виде строки, решает проблему вывода научного обозначения при преобразовании очень больших чисел, значение по умолчанию — false;
• unOmitYuan: не опускать «元» при значении «0», используется только в методе toMoney, значение по умолчанию — false;
• complete: переключатель полного отображения валюты, используется только в методе toMoney, значение по умолчанию — false;
• forceZheng: добавлять «整» после результата, если в результате нет десятичной дроби, используется только в методе toMoney, значение по умолчанию — false;
• outSymbol: выводить символ перед валютой, используется только в методе toMoney, значение по умолчанию — true.

new Nzh(langs) — пользовательская настройка

var nzh = new Nzh({
    ch: "〇壹贰叁肆伍陆柒捌玖",      // 数字字符
    ch_u: "个十百千万亿兆京",       // 数位单位字符，万以下十进制，万以上万进制，个位不能省略
    ch_f: "负",                   // 负字符
    ch_d: "点",                   // 小数点字符
    m_u: "元角分厘",              // 金额单位
    m_t: "人民币",                // 金额前缀
    m_z: "正"                    // 金额无小数后缀
});
nzh.encode("10001000000000000"); // 壹京〇壹兆
nzh.decode("壹兆");              // 1000000000000
nzh.toMoney("1.234");           // 人民币壹元贰角叁分肆厘

nzh.encode(num,options)

Преобразование числа в китайские цифры.

nzh.decode(zh_num,options)

Преобразование китайских цифр в число.

nzh.toMoney(num,options)

Конвертация числа в валюту.

Справочные материалы

• Разговорный стиль
• Китайские цифры