Skip to content

devNumberToChinese 数字转中文

devNumberToChinese 是一个将数字转换为中文的工具函数,支持将数字转换为中文大写、中文小写、中文金额等多种格式。

功能特点

  • 支持多种格式:支持将数字转换为中文大写、中文小写、中文金额等多种格式。
  • 支持小数:支持将小数转换为中文大写、中文小写、中文金额等多种格式。
  • 支持自定义格式:支持自定义格式,可根据需求自定义转换格式。

核心功能

devNumberToChinese(number: number, options?: Options): string 将数字转换为中文。

参数

  • number: 要转换的数字。
  • options: 可选参数,包含以下属性:
    • 默认参数: {textType: 'modern', semanticType: 'verbal'}
    • textType: 可选值为 traditional(中文大写)、modern(中文小写)。
    • semanticType: 可选值为 verbal(口语化)、literal(直译)、money(金额) 。

使用示例

ts
import {devNumberToChinese} from 'devecoui-plus'
// 示例 1:字面转换(literal)
// 输入数字:123.45,使用现代(简体)样式
console.log(devNumberToChinese(123.45, { textType: 'modern', semanticType: 'literal' }));
// 输出:一二三点四五

// 示例 2:口语化转换(verbal)
// 输入数字:1234,使用传统(繁体)样式
console.log(devNumberToChinese(1234, { textType: 'traditional', semanticType: 'verbal' }));
// 输出:壹仟贰佰叁拾肆

// 示例 3:金额转换(money)
// 输入金额:1234.56,使用现代(简体)样式
console.log(devNumberToChinese(1234.56, { textType: 'modern', semanticType: 'money' }));
// 输出:壹仟贰佰叁拾肆元伍角陆分

// 示例 4:特殊情况处理(零)
// 输入数字:0,使用现代(简体)样式
console.log(devNumberToChinese(0, { textType: 'modern', semanticType: 'verbal' }));
// 输出:零

// 示例 5:没有小数部分
// 输入数字:1001,使用现代(简体)样式
console.log(devNumberToChinese(1001, { textType: 'modern', semanticType: 'verbal' }));
// 输出:一千零一