Java DecimalStyle 怎样为日期格式配置非拉丁数字

如果日期已经格式化成功，但界面仍需要显示阿拉伯-印度数字、波斯数字或其他本地化数字，不必手动替换字符串。Java 的 DecimalStyle 专门描述日期时间格式化所使用的数字符号：设置零字符后，数字 1 到 9 会按同一连续字符范围推导；正号、负号和小数点也可以分别配置。

真正的关键是把样式绑定到 DateTimeFormatter：格式化和解析都使用同一个 formatter，输入输出才会保持一致。

官方资料：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/time/format/DecimalStyle.html

先分清 DecimalStyle 负责哪些符号

DecimalStyle 是日期时间格式化中的本地化十进制样式，不负责改变日期对象本身，也不负责把公历切换成另一种历法。它主要描述四类字符：

这些 with... 方法都会返回一个新对象。DecimalStyle 本身是不可变且线程安全的，因此可以把配置好的实例作为 formatter 的一部分长期复用。

用 withZeroDigit 配置非拉丁数字

配置数字时只需要指定目标数字系统的“零”字符。例如阿拉伯-印度数字的零是 ٠，对应的 1 到 9 是连续字符。DecimalStyle 会根据这个起点推导其他数字，不需要逐个建立替换表。

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.format.DecimalStyle;

public class LocalizedDigitsDemo {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2026, 3, 8);

        // 只设置数字系统的零字符，1 到 9 会按连续字符自动推导。
        DecimalStyle arabicDigits = DecimalStyle.STANDARD
                .withZeroDigit('٠');

        // uuuu 使用完整年份，MM 和 dd 保留两位数字。
        DateTimeFormatter formatter = DateTimeFormatter
                .ofPattern("uuuu-MM-dd")
                .withDecimalStyle(arabicDigits);

        // 输出示例：٢٠٢٦-٠٣-٠٨。
        System.out.println(date.format(formatter));
    }
}

这里的模式仍然是 uuuu-MM-dd，改变的是模式产生的数字字符，而不是模式字母本身。日期仍然是同一个 LocalDate，只是展示层采用了另一套数字符号。

需要正负号或小数点时继续组合配置

日期格式中常见的年份和月份通常不涉及小数点，但时间、秒小数或带偏移的值可能会用到其他符号。可以在同一个 DecimalStyle 上继续链式调用：

import java.time.OffsetDateTime;
import java.time.ZoneOffset;
import java.time.format.DateTimeFormatter;
import java.time.format.DecimalStyle;

public class DecimalSymbolsDemo {
    public static void main(String[] args) {
        OffsetDateTime value = OffsetDateTime.of(
                2026, 3, 8, 9, 5, 7, 120_000_000, ZoneOffset.ofHours(3));

        // 每次 with... 都返回副本，原来的 STANDARD 不会被修改。
        DecimalStyle style = DecimalStyle.STANDARD
                .withZeroDigit('٠')
                .withPositiveSign('＋')
                .withNegativeSign('−')
                .withDecimalSeparator('٫');

        // SSS 输出秒的小数部分，用于观察小数点配置。
        DateTimeFormatter formatter = DateTimeFormatter
                .ofPattern("uuuu-MM-dd HH:mm:ss.SSS XXX")
                .withDecimalStyle(style);

        System.out.println(value.format(formatter));
    }
}

如果业务只想本地化数字，不要随意替换正负号和小数点。符号是协议的一部分时，先确认接收端能识别这些字符；展示层和接口层可以使用不同的 formatter。

用同一套 DecimalStyle 解析非拉丁数字

withDecimalStyle 不只影响输出，官方 API 也明确说明 DecimalStyle 的符号同时用于格式化和解析。因此，解析用户输入时要复用同一个 formatter，不能只在 format 端配置。

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.format.DecimalStyle;

public class ParseLocalizedDigits {
    public static void main(String[] args) {
        DecimalStyle arabicDigits = DecimalStyle.STANDARD
                .withZeroDigit('٠');
        DateTimeFormatter formatter = DateTimeFormatter
                .ofPattern("uuuu-MM-dd")
                .withDecimalStyle(arabicDigits);

        String input = "٢٠٢٦-٠٣-٠٨";

        // 解析端必须使用同一套数字样式，否则输入字符可能无法匹配数字字段。
        LocalDate parsed = LocalDate.parse(input, formatter);
        System.out.println(parsed);
    }
}

如果输入来自外部系统，建议把格式化器按“协议输入”“用户界面输出”分开命名，并为每种格式固定一套样式，避免默认 Locale 随部署环境变化。

Locale 适合做默认值，显式样式适合做协议

如果目标是跟随语言环境的本地化约定，可以通过 DecimalStyle.of(locale) 获取样式。Locale 还可以带有 Unicode 的数字系统扩展，例如 nu；但当输入输出格式是跨系统协议时，更适合显式保存 DecimalStyle，而不是依赖服务器默认 Locale。

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.format.DecimalStyle;
import java.util.Locale;

public class LocaleDecimalStyleDemo {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2026, 3, 8);
        Locale locale = Locale.forLanguageTag("ar-EG-u-nu-arab");

        // 根据 Locale 的数字系统扩展获取本地化 DecimalStyle。
        DecimalStyle style = DecimalStyle.of(locale);
        DateTimeFormatter formatter = DateTimeFormatter
                .ofPattern("uuuu-MM-dd", locale)
                .withDecimalStyle(style);

        System.out.println(date.format(formatter));
    }
}

Locale 方案的优点是遵循运行库提供的本地化数据；显式 withZeroDigit 方案的优点是结果可预测。选择哪一种，取决于你是在做用户界面，还是在实现固定格式的文件与接口。

常见问题排查清单

1. 只改了 Locale，数字仍是拉丁数字：检查 Locale 是否真的包含目标数字系统扩展；如果要求完全可控，直接用 DecimalStyle.STANDARD.withZeroDigit(...)。
2. 格式化成功但解析失败：确认 parse 使用的是同一个带 withDecimalStyle 的 formatter，而不是重新创建的默认 formatter。
3. 连模式字母也换成本地数字：不要改 yyyy、MM、dd 等模式字母。DecimalStyle 改的是输出字符，不是模式语法。
4. 并发复用是否安全：DecimalStyle 和由它构造的 DateTimeFormatter 都是不可变、线程安全的；DateTimeFormatterBuilder 则是可变构建器，应在单线程中完成构建后再共享 formatter。
5. 小数点改了但没有效果：检查模式是否真的包含秒小数或其他小数字段；单纯的年月日模式没有小数点可替换。

小结

Java DecimalStyle 的最小用法是：选择一个零字符，调用 withZeroDigit 得到新样式，再用 DateTimeFormatter.withDecimalStyle 绑定到格式化器。若还要改变正负号或小数点，可以继续组合对应的 with... 方法。需要输入输出闭环时，format 和 parse 必须共享同一 formatter；需要跟随用户环境时使用 DecimalStyle.of(Locale)，需要固定协议结果时使用显式样式。

相关问题

DecimalStyle 会修改 LocalDate 的值吗？

不会。它只改变日期时间格式化和解析时使用的符号，LocalDate 的年月日数值不变。

可以只设置数字而保留标准负号吗？

可以。只调用 withZeroDigit 即可，其他符号沿用基础样式。

DecimalStyle 和 DateTimeFormatterBuilder 是一回事吗？

不是。DecimalStyle 描述数字相关符号，Builder 负责组装字段、文字、可选段和字面量；构建完成后再把 DecimalStyle 绑定到 DateTimeFormatter。