util-helpers

import { isNaN } from 'ut2';
import { checkBoundary } from './utils/math.util';
import devWarn from './utils/devWarn';
// 简体
const chnNumberChar = ['零', '一', '二', '三', '四', '五', '六', '七', '八', '九'];
const chnUnitChar = ['', '十', '百', '千'];
// 繁体
const big5NumberChar = ['零', '壹', '贰', '叁', '肆', '伍', '陆', '柒', '捌', '玖'];
const big5UnitChar = ['', '拾', '佰', '仟'];
// 数字字符、计数单位
let numberChar;
let unitChar;
let unitSection;
/**
 * 每个小节的内部进行转化
 *
 * @private
 * @param {number} section 数字
 * @returns {string} 转化的数字
 */
function sectionToChinese(section) {
    let str = '';
    let chnstr = '';
    let zero = false; //zero为是否进行补零， 第一次进行取余由于为个位数，默认不补零
    let unitPos = 0;
    while (section > 0) {
        // 对数字取余10，得到的数即为个位数
        const v = section % 10;
        //如果数字为零，则对字符串进行补零
        if (v == 0) {
            if (zero) {
                //如果遇到连续多次取余都是0，那么只需补一个零即可
                zero = false;
                chnstr = numberChar[v] + chnstr;
            }
        }
        else {
            //第一次取余之后，如果再次取余为零，则需要补零
            zero = true;
            str = numberChar[v];
            str += unitChar[unitPos];
            chnstr = str + chnstr;
        }
        unitPos++;
        section = Math.floor(section / 10);
    }
    return chnstr;
}
/**
 * 转换整数
 *
 * @private
 * @param {number} num 要转换的数字
 * @returns {string} 中文数字
 */
function convertInteger(num) {
    let numInt = Math.floor(num);
    let unitPos = 0;
    let strIns = '';
    let chnStr = '';
    let needZero = false;
    if (numInt === 0) {
        return numberChar[0];
    }
    while (numInt > 0) {
        const section = numInt % 10000;
        if (needZero) {
            chnStr = numberChar[0] + chnStr;
        }
        strIns = sectionToChinese(section);
        strIns += section !== 0 ? unitSection[unitPos] : unitSection[0];
        chnStr = strIns + chnStr;
        needZero = section < 1000 && section > 0;
        numInt = Math.floor(numInt / 10000);
        unitPos++;
    }
    return chnStr;
}
/**
 * 转换小数
 *
 * @private
 * @param {number} num 要转换的数字
 */
function convertDecimal(num) {
    const strNum = num + '';
    const index = strNum.indexOf('.');
    let ret = '';
    if (index > -1) {
        const decimalStr = strNum.slice(index + 1);
        ret = mapNumberChar(decimalStr);
    }
    return ret;
}
/**
 * 映射为中文数字
 *
 * @private
 * @param {number|string} num 要处理的数字
 * @returns {string} 返回中文数字的映射
 */
function mapNumberChar(num) {
    const strNum = num + '';
    let ret = '';
    for (let i = 0, len = strNum.length; i < len; i++) {
        ret += numberChar[parseInt(strNum[i])];
    }
    return ret;
}
/**
 * 数字转中文数字
 *
 * 如果数字不在安全数字 -9007199254740991～9007199254740991 范围内，处理会有异常。
 *
 * @alias module:Processor.numberToChinese
 * @since 1.2.0
 * @see {@link https://openstd.samr.gov.cn/bzgk/gb/newGbInfo?hcno=F5DAC3377DA99C8D78AE66735B6359C7 出版物上数字用法}
 * @param {number} num 数字
 * @param {Object} [options] 配置项
 * @param {boolean} [options.big5=false] 繁体，默认`false`
 * @param {boolean} [options.unit=true] 计数单位，默认`true`
 * @param {string} [options.decimal="点"] 中文小数点。默认`点`，当`big5=true`时，默认`點`
 * @param {string} [options.zero="零"] 设置0，默认`零`。常用配置 〇
 * @param {string} [options.negative="负"] 负数前面的字，默认`负`
 * @param {Object} [options.unitConfig] 节点单位配置
 * @param {string} [options.unitConfig.w="万"] 设置计数单位万，默认`万`。常用配置 萬
 * @param {string} [options.unitConfig.y="亿"] 设置计数单位亿，默认`亿`。常用配置 億
 * @returns {string} 中文数字
 * @example
 *
 * numberToChinese(100); // 一百
 * numberToChinese(100.3); // 一百点三
 * numberToChinese(1234567890); // 一十二亿三千四百五十六万七千八百九十
 * numberToChinese(1234567890.11); // 一十二亿三千四百五十六万七千八百九十点一一
 *
 * // 繁体
 * numberToChinese(100, {big5: true}); // 壹佰
 * numberToChinese(100.3, {big5: true}); // 壹佰點叁
 * numberToChinese(1234567890.11, {big5: true}); // 壹拾贰亿叁仟肆佰伍拾陆万柒仟捌佰玖拾點壹壹
 *
 * // 不带计数单位
 * numberToChinese(1990, {unit: false}); // 一九九零
 *
 * // 不带计数单位，修改0
 * numberToChinese(1990, {unit: false, zero:'〇'}); // 一九九〇
 *
 */
function numberToChinese(num, options = {}) {
    const { big5 = false, unit = true, zero = '', negative = '负', unitConfig = {} } = options;
    let { decimal = '' } = options;
    // 非数字 或 NaN 不处理
    if (typeof num !== 'number' || isNaN(num)) {
        devWarn(`参数错误 ${num}，请传入数字`);
        return '';
    }
    // 超过安全数字提示
    checkBoundary(num);
    // 设置数字字符和计数单位
    if (big5) {
        numberChar = big5NumberChar.slice();
        unitChar = big5UnitChar.slice();
        decimal = decimal || '點';
    }
    else {
        numberChar = chnNumberChar.slice();
        unitChar = chnUnitChar.slice();
        decimal = decimal || '点';
    }
    // 设置节点计数单位，万、亿、万亿
    const unitWan = unitConfig.w || '万';
    const unitYi = unitConfig.y || '亿';
    const unitWanYi = unitWan + unitYi;
    unitSection = ['', unitWan, unitYi, unitWanYi];
    // 设置0
    if (zero) {
        numberChar[0] = zero;
    }
    // 前置字符，负数处理
    const preStr = num < 0 ? negative : '';
    // 整数
    let chnInteger;
    const numAbs = Math.abs(num);
    if (unit) {
        chnInteger = convertInteger(numAbs);
    }
    else {
        chnInteger = mapNumberChar(Math.floor(numAbs));
    }
    // 小数
    const chnDecimal = convertDecimal(numAbs);
    return chnDecimal ? `${preStr}${chnInteger}${decimal}${chnDecimal}` : `${preStr}${chnInteger}`;
}
export default numberToChinese;
numberToChinese.js
