@dtinsight/dt-utils/lib/toThousand/index.js

袋鼠云前端常用工具库

/**
 * 将数字或字符串转换为带千位分隔符的格式化字符串
 *
 * @category 转换
 * @description
 * 接收一个数字或字符串输入，返回一个使用逗号作为千位分隔符的格式化字符串。
 * 可以处理整数和小数。
 *
 * @param {string | number} num - 需要格式化的数字或字符串
 * @returns {string} 添加了千位分隔符的字符串
 *
 * @example
 * ```typescript
 * import { toThousand } from 'dt-utils';
 *
 * // 格式化整数
 * toThousand(1234567)     // => '1,234,567'
 * toThousand('1234567')   // => '1,234,567'
 *
 * // 格式化小数
 * toThousand(12345.67)    // => '12,345.67'
 * toThousand('12345.67')  // => '12,345.67'
 *
 * // 处理边界情况
 * toThousand(0)           // => '0'
 * toThousand('')          // => '0'
 * ```
 */
var toThousand = function (num) {
    if (num === null || num === undefined || num === '')
        return '0';
    var numStr = String(num);
    var _a = numStr.split('.'), integerPart = _a[0], decimalPart = _a[1];
    var formattedInteger = integerPart.replace(/(\d)(?=(\d{3})+(?!\d))/g, '$1,');
    return decimalPart ? "".concat(formattedInteger, ".").concat(decimalPart) : formattedInteger;
};
export default toThousand;