Day 26:数值语义、多币种与计量单位

前面几章问的是这个值进不进得去、传不传得到、要不要被记下来。这一篇换一个问题:进去了的那个值代表什么。

一张单据上的数量、单价、金额、折扣率、汇率,在 TableSchema 那份定义里长得几乎一样,都是一个十进制数加一组精度。真正的差别在三个地方:要显示几位、写进去的时候要不要舍、位数由谁说了算。多数系统把这三件事分别交给数据表的 DDL、界面上的格式字符串、业务逻辑里的 Math.Round,三处各改各的。要好维护,这三件事得由同一套机制来管。

本篇说明:

  1. 数值字段上标的是语义而不是位数
  2. 金额的位数依币种而定
  3. 数量与重量的位数依计量单位而定
  4. 明细先舍再加还是加完再舍,这个顺序决定合计对不对

一、标的是语义,不是位数

数据表声明 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 铁人赛参赛文章,原文为繁体中文。

iThome 原文 | HackMD 版

系列完整目录:ERP 架构师笔记:定义驱动的框架设计

相关推荐
风云16 小时前
两条 Pipe、五个命门:Vane.NET 内核为什么长这样
开源·网络编程·.net·架构设计·vane.net
宝桥南山20 小时前
Visual Studio 2026新特性 - 可以直接连接DeepSeek(使用Custom Endpoint Provider配置项)
ide·microsoft·微软·aigc·.net·visual studio
Jeff-Tsai1 天前
Day 25:审计轨迹与变更的前后值
.net·架构设计·erp·definition-driven
IT规划师1 天前
Redis 核心机制 | 事务:执行序列的原子性、乐观锁与 8.x 条件写
redis·.net
Jeff-Tsai2 天前
Day 24:权限的三轴:动作、行与列
.net·架构设计·erp·definition-driven
BruceNeter2 天前
C# winform卡死问题分析1——线程池子线程创建句柄
c#·.net
隔窗听雨眠2 天前
高可用不止于数据库的全栈工程实践
数据库·架构设计·高可用
Jeff-Tsai3 天前
Day 23:API Payload 安全管道:顺序、保护等级与密钥
.net·架构设计·erp·definition-driven