当前位置：首页 > 文章列表 > 文章 > java教程 > Java ChoiceFormat 怎样把数字范围映射为提示文本

Java ChoiceFormat 怎样把数字范围映射为提示文本

来源：17golang原创 2026-10-29 18:08:51 0浏览收藏

Java ChoiceFormat 适合把一个数字直接映射成分段提示文本。最重要的规则是：limits 必须升序，数字会落入对应的半开区间；模式里的 # 包含下限， 则表示严格大于该边界。这样可以把散落在业务代码里的多层判断收拢成一份可读的区间配置。

官方参考：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/text/ChoiceFormat.html

下面用 0、1、2+ 三个计数档位做基线。目标不是比较某个 JVM 的绝对耗时，而是让 5 个边界样例都能按同一套规则得到稳定结果。

先理解 ChoiceFormat 的区间规则

ChoiceFormat 的每个 limit 对应一个格式文本。相邻 limit 形成半开区间：当前 limit 包含，下一 limit 不包含。limits 不升序时，格式结果就不可靠，因此配置应先按从小到大排列。

ChoiceFormat 的 limits、边界关系和提示文本静态结构说明图 — 图1：ChoiceFormat 区间说明图，查看数字边界与提示文本的对应关系。

模式字符串适合直接写出固定提示：

import java.text.ChoiceFormat;

public class ChoicePatternDemo {
    public static void main(String[] args) {
        // # 表示包含下限， " + format.format(sample));
        }
    }
}

这里的 1# 命中数字 1，而 1 只命中大于 1 的数字。若业务数据是整数计数，这种写法自然表达了 0、1、2 及以上；若数据包含小数，必须重新确认 1 到 2 之间的值应该归入哪一档。

用数组构造复用动态提示

当边界来自配置、常量或计算结果时，数组构造比拼接模式字符串更容易维护。limits 和 formats 长度必须相同，并且每个位置一一对应。

import java.text.ChoiceFormat;

public class ChoiceArrayDemo {
    public static void main(String[] args) {
        // 每个下限对应一个固定提示；limits 必须保持升序。
        double[] limits = {0, 1, 2};
        String[] formats = {"没有任务", "1 个任务", "多个任务"};
        ChoiceFormat format = new ChoiceFormat(limits, formats);

        // 计数 2 会进入 [2, 正无穷) 这一档。
        System.out.println(format.format(0));
        System.out.println(format.format(1));
        System.out.println(format.format(2));
    }
}

数组方式的改动点很明确：只改边界数组和文本数组，不动选择逻辑。不要把 formats 少写一项，也不要把未排序的边界直接传入；这两类错误会让结果与读者看到的业务规则不一致。

需要把数字带回提示文本时怎么写

ChoiceFormat 本身返回的是选中的文本。如果提示需要显示原始数字，例如“当前有 1273 条消息”，可以让它作为 MessageFormat 的参数格式。格式文本中的 {0} 会在选中对应档位后继续交给消息模板处理。

MessageFormat 与 ChoiceFormat、limits、formats 和参数占位关系说明图 — 图2：ChoiceFormat 与 MessageFormat 关系说明图，查看选择结果如何保留原始数字。

import java.text.ChoiceFormat;
import java.text.MessageFormat;

public class ChoiceMessageDemo {
    public static void main(String[] args) {
        // 0 和 1 使用固定文案，2 及以上保留参数中的实际数量。
        double[] limits = {0, 1, 2};
        String[] parts = {"没有消息", "1 条消息", "{0} 条消息"};
        ChoiceFormat choices = new ChoiceFormat(limits, parts);

        // 把第 0 个参数交给 ChoiceFormat，再由 MessageFormat 组合完整句子。
        MessageFormat message = new MessageFormat("收件箱：{0}");
        message.setFormatByArgumentIndex(0, choices);

        // 这些输入构成最小可复查样例集，重点观察 0、1、2 三个边界。
        for (int count : new int[] {0, 1, 2, 1273}) {
            System.out.println(message.format(new Object[] {count}));
        }
    }
}

这里需要注意一个容易忽略的事实：ChoiceFormat 依然按照 double 处理数字，long 的格式化也会走 double 能表示的范围。普通消息计数通常没有实际限制，但极大的精确整数应先评估是否适合直接交给它。