前面几章问的是这个值进不进得去、传不传得到、要不要被记下来。这一篇换一个问题:进去了的那个值代表什么。
一张单据上的数量、单价、金额、折扣率、汇率,在 TableSchema 那份定义里长得几乎一样,都是一个十进制数加一组精度。真正的差别在三个地方:要显示几位、写进去的时候要不要舍、位数由谁说了算。多数系统把这三件事分别交给数据表的 DDL、界面上的格式字符串、业务逻辑里的 Math.Round,三处各改各的。要好维护,这三件事得由同一套机制来管。
本篇说明:
- 数值字段上标的是语义而不是位数
- 金额的位数依币种而定
- 数量与重量的位数依计量单位而定
- 明细先舍再加还是加完再舍,这个顺序决定合计对不对
一、标的是语义,不是位数
数据表声明 decimal(19,4) 之后,你知道这一列最多放得下四位小数。但你不知道它该显示几位、算出来的值要不要舍,也不知道客户要求单价只显示两位时,该改这一列还是别的地方。
框架的做法是在 FormSchema 的字段(FormField)上声明一个语义分类 NumberKind,要留几位、要不要舍,都由它决定:
NumberKind |
语义 | 舍入策略 | 位数来源 |
|---|---|---|---|
Quantity |
数量 | Round |
计量单位 |
Weight |
重量 | Round |
计量单位 |
Amount |
金额 | Round |
币种 |
Percent |
百分比 | Round |
公司 |
UnitPrice |
单价 | Preserve |
公司 |
Cost |
成本 | Preserve |
公司 |
ExchangeRate |
汇率 | Preserve |
系统固定 |
算出来的数字要舍,拿去算的不舍。金额要印在单据上、加进合计、记进账,得舍到该有的位数;单价、成本、汇率是拿去乘的,舍了就会把误差带进后面每一次计算。所以框架的舍入方法 RoundByKind 遇到这三种会原样送回。单价显示四位只是给人看,框架不会因此把它舍成四位。
没标 NumberKind 的字段,框架不给格式也不舍入,漏标了也不会报错。
位数能不能先算好,看它在用户操作单据的过程中会不会变。百分比、单价、成本的位数由公司订,汇率由框架固定五位,这四种都不会变,所以送定义的时候就先把格式算好,前端照着印。
金额、数量与重量的位数会变:金额跟着币种走,数量与重量跟着单位走,分别是后面两节。
二、金额的位数由币种决定
币种的小数位是币种自己的性质,不是公司政策:日元没有分、美元有两位、巴林第纳尔有三位,这是 ISO 4217 订的,不会因为换一家公司就不一样。所以币种位数放在一张全系统共用的主表里,个别公司动不了它。公司能决定的是本币用哪一种,以及最终应付金额要不要再对齐一个现金舍入单位(后面会谈)。
那张主表就是一份定义文件,跟表单定义放在同一个地方、走同一套缓存(Day 4 那十三种定义都是这样),也跟着一起送给前端(节选自框架附的 CurrencySettings.xml):
xml
<CurrencyItem Code="USD" Numeric="840" Rounding="0.01" Symbol="$" Name="US Dollar" />
<CurrencyItem Code="JPY" Numeric="392" Rounding="1" Symbol="¥" Name="Japanese Yen" />
<CurrencyItem Code="BHD" Numeric="048" Rounding="0.001" Symbol="BD" Name="Bahraini Dinar" />
它存的不是位数,而是「自然最小单位」,位数再从它换算(0.01 是两位、1 是零位)。最小单位才是货币真正存在的东西,后面的现金舍入用到的也是它。
金额的位数不能先算好,因为用户可能在界面上把币种从美元改成日元。所以定义里不写金额的位数,只写「我的币种在哪一列」;没指定就用单据上的币种列,等那一列有值再算。
于是同一列的每一行可以有不同的位数。美元加日元没有意义,页脚只在整列都是同一种币种时才显示合计;换算成公司本币的那一列只有一种币种,一定加得出来。
币种列没填,就用公司的本币。本币是公司必填的设置,没设的话,框架算金额时会直接抛出异常,而不是退回默认位数。
三、数量与重量的位数由单位决定
数量也是同样的道理:填「件」不该有小数,填「公斤」就可以是 0.375。能不能有小数,看的是这一行填了哪个单位,不是看字段。
单位主表也是全系统共用的定义文件,每个单位的位数是那个单位自己的性质,不归公司管(节选自框架附的 UnitSettings.xml):
xml
<UnitItem Code="PCS" Decimals="0" Dimension="count" Name="Pieces" />
<UnitItem Code="KG" Decimals="3" Dimension="weight" Name="Kilogram" />
两张主表的差别在存法:计量单位直接存位数;币种存的是最小单位,再换算成位数,因为现金舍入要用到最小单位。
做法和金额一致:数量列只写「我的单位在哪一列」,位数依那一列的值查单位主表。差别在没填的时候:
| 代码从哪一列来 | 那一列没填 | 公司层的默认 | |
|---|---|---|---|
| 金额 | 金额列指定的币种列,没指定就用单据上的币种列 | 用公司本币 | 本币(必填) |
| 数量/重量 | 数量列指定的单位列 | 没有可以顶上的 | 没有默认单位 |
公司有本币,却不会有默认单位,因为同一张单的明细本来就可以一行公斤、一行箱。
原则是:标成 Quantity 或 Weight 的字段就必须指定单位列;不需要单位的数字,用一般数值,不标 NumberKind。
四、先舍再加,还是加完再舍
三笔明细,每笔都是一件乘以单价 10.3333。直觉上全精度加完再舍一次比较精确。用案例 FormSchema 的算式实际跑一次:
| 做法 | 每行显示 | 合计 |
|---|---|---|
| 先舍再加 | 10.33 | 30.99 |
| 加完再舍 | 10.33 | 31.00 |
差了一分钱,错的是看起来比较精确的那一个。单上印着三个 10.33,用户自己加是 30.99,表头却写 31.00,这张单自己就对不上。ERP 要求表头合计必须等于明细加总,一分都不能差,因为单据要被打印、对账、审计。
框架的做法是每一行算完就先舍,合计拿到的都是舍过的值,加起来自然相等,这条规则叫 round-then-sum。框架只在这里自动舍入,用户手填的数字不会被舍。
舍入分成两层
明细每一行舍到币种的自然小数,这一层全系统一致。单据最后的应付金额可以再加一层:对齐公司设置的现金舍入单位。例如瑞士法郎没有一分的硬币,公司可以设成 0.05,12.34 就收 12.35、12.32 收 12.30。
两层的性质不同。第一层是去掉不存在的精度;第二层会刻意产生差额,多收的一分或少收的两分都要记进舍入科目。所以框架这一层只返回应付金额,差额由调用端自己算、自己记。
数据库那一格是容量,不是位数
数据表字段也有精度,但那是容量上限,只表示最多放得下几位,跟这个值该显示或舍到几位无关。同一个金额类型,在五家数据库分别建成 decimal(19,4)、numeric(19,4)、DECIMAL(19,4)、NUMBER(19,4)、NUMERIC(19,4),写法不同,数字相同。
上限刻意订得比业务位数高很多,否则每加一家公司、每多一种货币就要 ALTER TABLE 一次,没办法运维。
超出容量的位数,框架目前不处理。值送进数据库时只带值、类型、长度与允不允许 NULL,不带精度,写入前也不会把值舍到字段的容量。
所以超出的部分由各家数据库自己决定。往四位小数的字段写入 1.234567,SQLite 原样保存(实测),其他数据库会依自己的规则收掉,同一笔数据存进不同数据库,精度就不一样。
数据库可以用 CHECK 约束限制位数,但那只会挡下不合的数据,不会舍入。要以正确的位数存进去,得由框架在写入前处理,这一步还没有做。
回到 Northwind
案例的 FormSchema 只有两个字段标了语义,而且正好一边一个(节选自 Order.FormSchema.xml):
xml
<FormField FieldName="unit_price" DbType="Currency" NumberKind="UnitPrice" />
<FormField FieldName="amount" DbType="Currency" NumberKind="Amount" ReadOnly="true"
ValueExpression="quantity * unit_price * (1 - discount)" />
第一个是单价,位数由公司订。送定义时 unit_price 会拿到四位的格式,但案例手写的布局那一列没有带标记,界面上显示的仍是原值;填 10.33335 进去,跑完一轮求值还是 10.33335,没有被舍。
第二个是 Day 8 那个计算列,属于币种那一类。案例没有币种列,所以用公司本币 USD,从币种主表查出两位,框架求完值就舍到两位。送定义时 amount 的格式留空,也没有指向币种列;界面上的两位,是布局那一列的标记依本币算出来的。多币种和计量单位都示范不出来,ExchangeRate 也没用到。
表头总额不在定义里,是 OrderBO 保存前把明细的 amount 加起来。那些 amount 在加总前已经由框架逐行舍过,所以符合 round-then-sum:框架负责舍,应用负责加。Day 8 说过跨行加总是算式目前写不出来的,舍入这一半框架已经做了,剩下的只有加总。
小结
这一篇从字段上的语义标记讲到数据表的容量,都在回答同一件事:一个数字的位数由谁决定。
答案分散在不同地方,而且是刻意的:单价、成本、百分比与汇率由公司或框架订,因为那是政策;金额由币种决定,数量与重量由单位决定,因为那是币种和单位本身的性质;应付金额要不要再对齐,由公司决定,因为那是收款政策;字段放得下几位由数据表决定,因为那只是容量。
把这几件事混在一起就会出错:位数绑在数据表上,换一种货币就要改结构;位数绑在显示上,单价与汇率会被舍掉精度;加总之后才舍入,表头就对不上明细。
位数之外还有值本身。框架只会自动舍它自己算出来的值,用户填的单价、折扣、手输的金额一律不动。舍入是针对计算结果的规则,不是去修正用户的输入;框架一旦替用户改数字,账上就会多出一笔没人知道是谁改的差额。
明天换一种数据。数字至少看起来都一样,时间却不是:同一个 CLR 类型里装着语义不同的几种值,类型系统分不出来。
本文为 2026 iThome 铁人赛参赛文章,原文为繁体中文。
系列完整目录:ERP 架构师笔记:定义驱动的框架设计