Java CompactNumberFormat 怎样按 Locale 格式化大数字

Java 按 Locale 格式化大数字，通常使用 NumberFormat.getCompactNumberInstance(locale, style) 创建格式器，再调用 format(number)。Locale 决定本地化的数字和单位表达，style 选择 SHORT 或 LONG；需要小数时再明确配置小数位。标准本地化场景无需手写“除以一千再拼 K”的规则。

官方地址：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/text/CompactNumberFormat.html

从定时报告的显示任务确定 Locale

假设系统定时生成访问量摘要，同一个原始计数要分别出现在中文、英语和德语报告中。应把接收者的语言地区作为任务输入，而不是让服务器默认 Locale 决定报告样式。没有指定地区的后台任务，应使用产品约定的默认值，并在任务配置中固定下来。

紧凑数字是展示策略：概览卡片空间有限时使用 SHORT，较完整的文字报告可以选择 LONG。这里无需增加文件权限或外部服务授权，格式化发生在进程内；读取业务数据的权限仍归原来的数据层管理。下面只展示本地数字格式化，不连接数据库或发送报告。

通过工厂创建格式器，再配置小数位

CompactNumberFormat 从 Java 12 提供。应用若只需 format 和通用配置方法，变量声明为 NumberFormat 即可。工厂返回的具体子类可能受本地化服务提供者影响，不应无条件强制转换为 CompactNumberFormat；若确实使用子类特有能力，应先检查类型。

下面是 Java 17+ 的完整单文件示例，可保存为 CompactCounts.java。它保留 long 原值并打印配置与展示文字，未在本文执行，因此不列出假装来自当前机器的输出。

import java.math.RoundingMode;
import java.text.NumberFormat;
import java.util.List;
import java.util.Locale;

public final class CompactCounts {
    private static NumberFormat formatter(Locale locale,
                                           NumberFormat.Style style) {
        // 工厂负责本地化模式，不自行拼接 K、万等后缀。
        NumberFormat format = NumberFormat.getCompactNumberInstance(locale, style);
        format.setMinimumFractionDigits(0);
        format.setMaximumFractionDigits(1);
        format.setRoundingMode(RoundingMode.HALF_EVEN);
        return format;
    }

    public static void main(String[] args) {
        // 明确选择受支持的业务语言，不依赖运行机器的默认 Locale。
        List locales = List.of(
                Locale.forLanguageTag("zh-CN"), Locale.US, Locale.GERMANY);
        long[] counts = {0L, 999L, 12500L, 1234567L};

        for (Locale locale : locales) {
            for (NumberFormat.Style style : NumberFormat.Style.values()) {
                // 每个配置组合持有自己的实例，仅在当前线程内复用。
                NumberFormat format = formatter(locale, style);
                for (long count : counts) {
                    String display = format.format(count);
                    System.out.printf(
                            "locale=%s style=%s raw=%d display=%s%n",
                            locale.toLanguageTag(), style, count, display);
                }
            }
        }
        // 数值仍为 long；display 仅用于界面和报表中的展示列。
    }
}

示例把最少小数位设为零、最多设为一：允许需要时显示一位小数，但不要求每条文字都补上“.0”。如果报告约定始终保留一位，应同时把最少和最多设为一。只设置最多位数，不等于固定小数位数。

HALF_EVEN 是这里明确选择的显示舍入方式。它用于紧凑表达，不修改 count，也不定义任何金额结算规则。较大的整数应直接按 long 传入，不必为了格式化先转成 double，以免无端引入精度损失。

SHORT 和 LONG 不只是相同后缀的长短版

官方文档举例，美国英语环境中，10000 在 SHORT 样式下可表示为 10K，LONG 样式为 10 thousand。其他语言不能简单把 K 替换成同一个翻译词：数量级、词形和本地模式都可能不同，SHORT 与 LONG 也不保证在所有 Locale 下有肉眼可见的差异。

本地化数据还可能存在父级回退。不要把“传入一个 Locale”理解成该地区一定有独立专属模式。部署环境或本地化数据变更后，文字细节也可能变化；对输出有严格快照要求的产品，应把 JDK 和本地化配置纳入发布管理。

自动任务复用实例时，保留配置边界

一个任务串行处理同一 Locale 与 style 的多条记录，可以创建一次格式器再循环使用。不要把同一个可变 NumberFormat 实例放到无锁的全局缓存里，让多个线程同时 format 或修改小数位。官方说明数字格式器通常不同步；并行任务应分别持有实例，或在确实共享时提供外部同步。

示例没有把每次 format 都封装成重新创建格式器，也没有跨线程缓存对象。若任务按用户语言分组，缓存键至少应体现 Locale、style 和实际显示配置；仅按语言代码缓存，可能把不同地区或不同小数位要求混在一起。

失败处理和报告记录要围绕原始输入

对用户可选语言，优先从产品允许的 Locale 列表中选择；没有匹配时按产品约定回退，不把任意传入文本直接当作已经审核的语言配置。style 和小数位由受控配置提供，避免同一张报告中途随意变化。

如果数字输入为空、类型不合适，或显示配置不符合产品规则，应在格式化边界报告输入问题。不要捕获所有错误后直接显示零，因为缺失数据与真实零值不是一回事。对于示例中的 long 数组，输入类型已经固定，因此没有添加与实际示例无关的外部失败分支。

自动报告可记录任务编号、Locale 标签、style 和小数位策略，必要时连同原始数值追踪显示差异。这是应用运行记录的建议，不是本例已经执行的测试或通知。展示文字包含的空白和本地符号也不应被简单的 ASCII 清洗规则破坏。

常见问题

为什么 12500 没有显示我想要的小数？

默认紧凑格式不显示小数，先检查最大小数位配置。再确认当前 Locale 和所选样式的缩放规则；不能先假定所有地区都会得到同一组系数和后缀。

LONG 可以替代普通数字格式化吗？

不能。LONG 仍属于紧凑表达。如果需要完整数值的本地化展示，应选择普通 NumberFormat，例如 getIntegerInstance(locale)，而不是依赖 LONG 恢复每一位数字。

能否把展示文字重新解析后存回数据库？

不应这样设计。紧凑表达可能舍入，显示后的文字无法可靠恢复原始细节。存储、比较、排序和统计继续使用原始值；展示列只负责让读者快速理解数量级。

参考资料：CompactNumberFormat 本地化模式、NumberFormat 工厂与线程同步说明。