中文金额

函数名：cw_中文金额 / cw_AmountToChinese

功能描述

将数字金额转换为中文大写金额，支持人民币前缀和"整"字后缀。使用标准中文数字字符（零壹贰叁肆伍陆柒捌玖）和单位（元拾佰仟万亿），适用于财务凭证、发票开具等场景。金额上限为 999,999,999,999.99（千亿级别）。

会员等级：🟢 免费版（Free）

语法

=cw_中文金额(金额, 人民币前缀, 整后缀)

参数

参数名	类型	必填	默认值	说明
金额	Double	是	—	需要转换的数字金额
人民币前缀	Boolean	否	FALSE	是否包含"人民币"前缀
整后缀	Boolean	否	FALSE	是否在末尾添加"整"字

返回值

String — 中文大写金额字符串

使用示例

示例一：基本转换

将带角分的金额转换为中文大写。

公式：

=cw_中文金额(1234.56)

结果：

壹仟贰佰叁拾肆元伍角陆分

示例二：包含人民币前缀

转换金额并添加"人民币"前缀，适用于正式财务凭证。

公式：

=cw_中文金额(1234.56, TRUE)

结果：

人民币壹仟贰佰叁拾肆元伍角陆分

示例三：整后缀

转换整数金额并添加"整"字后缀。当金额无角分时，添加"整"字符合财务规范。

公式：

=cw_中文金额(10005, FALSE, TRUE)

结果：

壹万零伍元整

示例四：负数转换

处理负数金额，自动添加"负"字前缀。

公式：

=cw_中文金额(-1234.56)

结果：

负壹仟贰佰叁拾肆元伍角陆分

技术说明

转换规则

• 数字字符集：零、壹、贰、叁、肆、伍、陆、柒、捌、玖
• 单位字符集：分、角、元、拾、佰、仟、万、拾、佰、仟、亿、拾、佰、仟
• 支持负数转换，自动在结果前添加"负"字
• 金额上限为 999,999,999,999.99，超出返回错误提示
• 内部采用"分"为单位进行计算，避免浮点精度问题
• 自动处理连续零的显示，避免多余零字符
• 当结果以"壹拾"开头时，自动简化为"拾"（如"壹拾贰万" → "拾贰万"）

零值处理

• 金额为 0 时，根据前缀参数返回"人民币零元整"或"零元整"
• 连续的零仅保留一个"零"字
• 万位、亿位的零根据上下文智能处理

错误处理

错误场景	返回值
金额超出 999,999,999,999.99	金额超出转换范围
转换过程发生异常	错误: {异常信息}