Java DateFormatSymbols 怎样读取指定 Locale 的月份名称

Java 需要显示指定地区的月份名称时，可以先调用 DateFormatSymbols.getInstance(locale)，再从返回对象读取 getMonths() 或 getShortMonths()。关键是让 Locale 显式进入 API，并用 Calendar.JANUARY 到 Calendar.DECEMBER 这些月份常量取数组元素，不要把一月误当成下标 1。

本文只讨论 Java java.text 中的本地化日期符号读取。官方文档：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/text/DateFormatSymbols.html。

用指定 Locale 获取符号对象

DateFormatSymbols 封装了月份、星期、上午下午和时区等日期格式化数据。使用无参构造器或 getInstance() 时，数据会跟随运行环境的默认格式区域；服务端、容器和用户电脑的默认值可能不同。

如果页面、报表或导出文件需要固定地区，直接把目标 Locale 传给 getInstance(Locale)。这个静态方法返回与指定地区对应的符号对象，之后的月份读取就不再依赖进程默认 Locale。

import java.text.DateFormatSymbols;
import java.util.Locale;

public class MonthNames {
    public static void main(String[] args) {
        // Locale 决定本地化数据来源，示例中故意不读取默认 Locale。
        Locale locale = Locale.FRANCE;
        DateFormatSymbols symbols = DateFormatSymbols.getInstance(locale);

        // 先取得完整月份数组，后续按 Calendar 的月份常量读取。
        String[] months = symbols.getMonths();
        System.out.println(months.length);
    }
}

如果 locale 为 null，getInstance(Locale) 会抛出 NullPointerException。在配置驱动的程序里，应该在读取配置时就把 Locale 建好并传入，而不是等到拼接字符串时才临时判断。

用 getMonths 按月份常量读取完整名称

getMonths() 返回完整月份名称数组。Java 的 Calendar.JANUARY 值是 0，Calendar.FEBRUARY 值是 1，因此使用月份常量比手写数字更清楚，也能避免把自然月份编号和 Java 数组下标混在一起。

官方 API 说明这个数组通常有 12 或 13 个元素，是否包含第 13 个位置取决于运行环境是否支持 Calendar.UNDECIMBER。业务只要读取一月至十二月，就应以月份常量为边界；不要把数组长度直接解释成“实际月份数量”。

import java.text.DateFormatSymbols;
import java.util.Calendar;
import java.util.Locale;

public class FullMonthName {
    public static String readMonth(Locale locale, int calendarMonth) {
        // 指定 Locale，避免完整月份名称受机器默认设置影响。
        DateFormatSymbols symbols = DateFormatSymbols.getInstance(locale);
        String[] months = symbols.getMonths();

        // Calendar 的月份常量从 JANUARY=0 开始，正好对应数组索引。
        if (calendarMonth  Calendar.DECEMBER) {
            throw new IllegalArgumentException("月份必须在 JANUARY 到 DECEMBER 之间");
        }
        return months[calendarMonth];
    }
}

这个方法的参数名使用 calendarMonth 而不是 monthNumber，是为了强调它接收的是 Calendar 体系的下标。如果调用方手里是 1 到 12 的业务月份，应先减 1，再传给这个方法，并在边界处完成校验。

需要紧凑展示时读取短月份

表格列、筛选器或日志通常不需要完整月份名，这时可以使用 getShortMonths()。它和 getMonths() 使用同样的月份常量索引规则，但返回的是该 Locale 的缩写形式；缩写不应该由业务代码自行截取完整名称，因为不同语言的缩写习惯并不相同。

import java.text.DateFormatSymbols;
import java.util.Calendar;
import java.util.Locale;

public class ShortMonthName {
    public static String readShortMonth(Locale locale, int calendarMonth) {
        // 完整名称和缩写名称必须来自同一个 Locale。
        String[] shortMonths = DateFormatSymbols
                .getInstance(locale)
                .getShortMonths();

        // 只允许标准的十二个月，避免误把 UNDECIMBER 当成普通月份。
        if (calendarMonth  Calendar.DECEMBER) {
            throw new IllegalArgumentException("不支持的月份下标");
        }
        return shortMonths[calendarMonth];
    }
}

完整名称和短名称都可能包含语言特有的格式形式。代码只负责读取 API 提供的数据，不应假设每个 Locale 都能按英文的首字母规则缩写。

让格式化器与月份符号使用同一个 Locale

如果目标只是把日期格式化成文本，优先使用 DateFormat 的工厂方法，让格式化器根据 Locale 自动准备符号数据。只有在需要单独展示月份列表、替换少量符号，或需要和现有格式模式配合时，才直接操作 DateFormatSymbols。

import java.text.DateFormat;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Locale;

public class LocalizedDate {
    public static String format(Date value, Locale locale) {
        // 格式模式和 Locale 一起固定，输出不会跟随服务器默认地区漂移。
        DateFormat formatter = new SimpleDateFormat("d MMMM yyyy", locale);
        return formatter.format(value);
    }
}

不要一边用 Locale.US 取得月份列表，一边让 SimpleDateFormat 使用默认 Locale；这样下拉选项和最终日期文本可能来自两套语言规则。更稳妥的做法是把 Locale 作为一次请求或一次报表任务的输入，在读取符号和格式化日期时都复用它。

常见问题

为什么不直接写一个 January 到 December 的数组？

手写数组只能覆盖一种语言，而且会忽略短月份、地区差异和本地化格式形式。需要支持多个 Locale 时，使用 DateFormatSymbols 能把数据来源交给 Java 的本地化实现。

getMonths()[1] 代表几月？

按 Calendar 的规则，索引 1 对应 Calendar.FEBRUARY，也就是二月。不要把索引 1 当成一月；对外部传入的 1 到 12 月份编号应先转换为 0 到 11。

可以用 getInstance() 省略 Locale 吗？

可以，但它会使用默认格式 Locale。桌面程序跟随用户设置时可能合适；服务端、缓存键、导出任务和测试更建议显式传入 Locale，让输出契约稳定。

实际使用可以记住三点：先用 DateFormatSymbols.getInstance(locale) 固定本地化数据来源；完整名称用 getMonths()，缩写用 getShortMonths()；取值时使用 Calendar.JANUARY 等常量，并让格式化器复用同一个 Locale。这样既能正确读取指定地区的月份，也能避免默认环境改变文本结果。