当前位置：首页 > 文章列表 > Golang > Go问答 > Go x/text/currency 现金舍入位数为什么可能不同于记账位数

Go x/text/currency 现金舍入位数为什么可能不同于记账位数

来源：17golang原创 2026-10-27 07:31:31 0浏览收藏

currency.Cash 与 currency.Accounting 面向不同用途，因此同一币种的舍入参数可能不同。而且区别不一定体现在小数位数 scale 上，也可能体现在 increment 上。只比较“保留几位小数”，可能漏掉步长差异；正确做法是读取并保留这两个参数和对应用途。

官方文档：https://pkg.go.dev/golang.org/x/text/currency

同一币种可以有不同使用场景

一个常见疑问是：同一币种代码没有变化，现金展示与记账展示怎么会得到不同设置？这里的 Unit 说明“是哪种货币”，Kind 则说明“按哪种用途选择舍入和展示属性”。两者是独立维度，不应把一个币种固定成唯一小数位配置。

官方接口提供 Standard、Cash 和 Accounting。当前官方实现中 Accounting 使用标准舍入分支，Cash 使用现金分支的数据。这个实现细节说明两种用途可以从不同数据项取得参数，不意味着任意币种的结果都必须不同，也不意味着库负责给企业确定实际记账制度。

币种和使用用途共同关联舍入参数 — 结构图：同一 Unit 可以关联 Cash 和 Accounting，两种用途各自取得 scale 与 increment。

同时读取 scale 和 increment

Rounding 返回 scale 和 increment。scale 表示小数位，increment 的计量单位依赖 10 的负 scale 次方。举一个独立的参数解释：若某条规则是 scale=2、increment=5，则对应步长为 0.05；这只是公式示意，不是在声称某个币种当前必然采用这组参数。

下面完整程序查询几个币种的两种用途，只输出参数，不做浮点金额运算。具体返回值由项目使用的模块及其数据决定，本文没有把未执行的示例描述为实测结果。

package main

import (
    "fmt"
    "golang.org/x/text/currency"
)

type Rule struct {
    Use string
    Scale int
    Increment int
}

// Rules 同时查询两种用途，不在这里执行金额计算。
func Rules(code string) ([]Rule, error) {
    unit, err := currency.ParseISO(code)
    if err != nil {
        return nil, fmt.Errorf("解析币种代码: %w", err)
    }
    cashScale, cashStep := currency.Cash.Rounding(unit)
    bookScale, bookStep := currency.Accounting.Rounding(unit)
    return []Rule{
        {Use: "cash", Scale: cashScale, Increment: cashStep},
        {Use: "accounting", Scale: bookScale, Increment: bookStep},
    }, nil
}

func main() {
    // 固定一组代码作为观察对象，不预先硬编码任何返回值。
    for _, code := range []string{"CHF", "JPY", "USD"} {
        rules, err := Rules(code)
        if err != nil {
            fmt.Println(err)
            continue
        }
        for _, rule := range rules {
            fmt.Printf("%s use=%s scale=%d increment=%d\n",
                code, rule.Use, rule.Scale, rule.Increment)
        }
    }
}

比较结果	含义
scale 不同	小数位参数不同
scale 相同而 increment 不同	步长设置仍存在区别
两个参数都相同	这次查询的数值参数一致，不能推导所有币种都一致

不要把 increment 直接当成“分”的数量，它的单位必须结合 scale。也不要未经解释就把任意返回值拿来当除数，参数查询并不是一份完整舍入算法。