中文金额大写
灵感:能力工具箱 nzh-amount(nzh 把报价金额转成壹圆整等中文大写)。
> 小四原创:金额数字 → toMoney → 展示/打印。
> 非法输入回落 —,避免抛错打断表单。
何时使用
- 报价单 / 合同金额大写栏
- 打印预览旁注
- Demo 金额确认文案
硬约束
- 依赖:
nzh。 - 使用人民币大写(
nzh.cn)。 - 非有限数字、负数需明确兜底或拒绝(本 Skill:回落
—)。 - 实现要点注释标 小四原创。
- 不做记账、发票开具、税务申报。
推荐实现
import nzh from 'nzh/cn'
// 小四原创:报价金额 → 中文大写
export function toCnMoneyUpper(amount: unknown): string {
const n = typeof amount === 'number' ? amount : Number(amount)
if (!Number.isFinite(n) || n < 0) return '—'
return nzh.toMoney(n, { outSymbol: false })
}
export function toCnMoneyLine(amount: unknown): string {
const upper = toCnMoneyUpper(amount)
if (upper === '—') return '—'
return `人民币${upper}`
}
Agent 步骤
npm i nzh。- 金额输入旁绑定大写只读展示。
- 自测:
123.45→ 含「壹佰贰拾叁元肆角伍分」类文案;空值—。
不要做
- 手写大写对照表却声称已用 nzh。
- 把负数静默转成正数。
附加
- README.md · reference.md · templates/usage.md