Go x/text/currency Rounding 怎样取得金额显示舍入位数

如果你只想知道某种货币应该显示几位小数，不要先在业务代码里写一张“货币代码到位数”的静态表。golang.org/x/text/currency 已经把这类规则封装在 Kind.Rounding 中：调用它可以得到 scale 和 increment，前者是小数位数，后者是按该小数位换算后的舍入步长。

官方地址：https://pkg.go.dev/golang.org/x/text/currency

先理解 Rounding 的两个返回值

Rounding 的签名是 func (k Kind) Rounding(cur Unit) (scale, increment int)。其中 scale 是小数部分的位数；increment 是以 10^(-scale) 为一个单位时，要按多少个单位进行舍入。

例如查询结果为 scale=2、increment=5，它表达的步长就是 5 × 10^(-2)，也就是 0.05。这里的返回值是规则元数据，不是已经舍入完成的金额。金额计算仍应使用项目选定的数值类型，避免把二进制浮点数直接当作账务存储。

用 Standard、Cash 和 Accounting 查询同一货币

currency 包提供了 Standard、Cash 和 Accounting 三个 Kind。它们表达的不是三种货币，而是三类舍入和呈现语境。查询时把场景作为显式参数传入，调用方就能把“普通价格显示”和“现金交易显示”区分开。

package main

import (
    "fmt"

    "golang.org/x/text/currency"
)

// printRounding 只打印规则元数据，不把它误当成最终金额格式化结果。
func printRounding(label string, kind currency.Kind, unit currency.Unit) {
    scale, increment := kind.Rounding(unit)
    // increment 是以 10^(-scale) 为单位的数量，组合后才能理解舍入步长。
    fmt.Printf("%s: currency=%s scale=%d increment=%d\n", label, unit, scale, increment)
}

func main() {
    // 同一个货币可以按不同业务场景查询，避免把规则散落在调用方常量里。
    printRounding("standard", currency.Standard, currency.USD)
    printRounding("cash", currency.Cash, currency.USD)
    printRounding("accounting", currency.Accounting, currency.USD)
}

示例故意只输出 scale 和 increment，没有写死某个货币的结果。这样做的好处是规则由依赖包维护，业务代码只负责选择场景并消费查询结果。

把查询结果交给调用方的显示策略

拿到返回值后，常见做法是把 scale 交给金额格式化层，把 increment 交给需要现金步长或价格粒度的业务层。不要把 scale 理解成“所有运算都必须保留这么多位”，它描述的是当前 Kind 和货币组合的舍入特征。

package main

import (
    "fmt"

    "golang.org/x/text/currency"
)

// displayPolicy 把查询到的规则转成界面或格式化配置需要的简单结构。
type displayPolicy struct {
    DecimalPlaces int
    StepUnits     int
}

// policyForDisplay 返回显示层需要的元数据，不在这里修改原始金额。
func policyForDisplay(kind currency.Kind, unit currency.Unit) displayPolicy {
    scale, increment := kind.Rounding(unit)
    return displayPolicy{
        DecimalPlaces: scale,
        StepUnits:     increment,
    }
}

func main() {
    // 业务层可以把 policy 交给自己的十进制定点格式化器或输入控件。
    policy := policyForDisplay(currency.Standard, currency.EUR)
    fmt.Printf("显示小数位=%d，舍入单位数=%d\n", policy.DecimalPlaces, policy.StepUnits)
}

如果页面只是需要展示小数位，可以只消费 DecimalPlaces；如果还需要把金额限制到现金最小单位，则必须同时消费 StepUnits。这两个字段不能互相替代。

处理未知货币与兼容策略

货币单位应当来自 currency.Unit，例如包内提供的 currency.USD 或通过 ParseISO 解析得到的单位。调用方不要把未知代码静默映射成默认货币；如果来源是用户输入或外部接口，应先保留解析错误，再决定是否回退到人工处理。

package main

import (
    "fmt"

    "golang.org/x/text/currency"
)

// roundingForISO 解析 ISO 4217 三字母代码后查询标准舍入特征。
func roundingForISO(code string) (int, int, error) {
    // ParseISO 会对格式错误或不认识的货币代码返回 error。
    unit, err := currency.ParseISO(code)
    if err != nil {
        return 0, 0, fmt.Errorf("解析货币代码 %q 失败: %w", code, err)
    }
    scale, increment := currency.Standard.Rounding(unit)
    return scale, increment, nil
}

func main() {
    // 外部代码不可信，先处理错误，再把规则传给显示层。
    scale, increment, err := roundingForISO("JPY")
    if err != nil {
        panic(err)
    }
    fmt.Printf("scale=%d increment=%d\n", scale, increment)
}

这段代码的重点是接口边界：ParseISO 负责识别三字母 ISO 4217 代码，Rounding 负责查询规则，格式化器负责生成最终文本。拆开这三层后，依赖升级或货币规则变化时不必修改业务表。

常见问题

Rounding 返回的 scale 就是金额最终保留的小数位吗？

它是该货币和 Kind 组合的舍入小数位特征，可以作为显示层的重要输入，但最终金额文本还要由调用方的格式化策略生成。

为什么还要看 increment？

只有小数位数还不足以表达 0.05 这类舍入步长。increment 与 scale 组合后，才能得到实际按多少个最小单位舍入。

Standard、Cash、Accounting 能随便选一个吗？

不建议。它们对应不同的舍入和呈现语境，应该由业务场景决定，并在接口边界处显式传入。

Rounding 会直接把 12.345 变成字符串吗？

不会。它返回的是两个整数规则值，不负责金额运算或字符串格式化；金额计算和展示仍要交给调用方的数值与格式化层。