如何使用DateTimeFormatter.ofPattern定制符合国人习惯的日期格式-java教程-PHP中文网

datetimeformatter.ofpattern 直接用中文“年月日”会抛异常，因它只识别模式字母（如y/m/d），不识别未转义的中文字符；正确写法是用单引号包裹字面量，如"yyyy'年'mm'月'dd'日'"，且中文星期、am/pm需配合.withlocale(locale.china)才能正常显示。

如何使用datetimeformatter.ofpattern定制符合国人习惯的日期格式

为什么 `DateTimeFormatter.ofPattern` 直接用中文“年月日”会抛异常

因为 DateTimeFormatter.ofPattern 默认不识别中文文字字面量（如“年”“月”“日”），它只解析预定义的模式字母（如 y、M、d）和 Unicode 字符。直接写 "yyyy年MM月dd日" 看似合理，但 Java 8+ 的默认实现会把“年”“月”“日”当作**未转义的非法字符**，抛出 DateTimeParseException 或编译期不报错、运行时报 IllegalArgumentException: Unknown pattern letter: 年。

解决办法是用单引号将中文文字包裹为字面量：

"yyyy'年'MM'月'dd'日'" ✅ 正确 —— 单引号内内容原样输出
"yyyy年MM月dd日" ❌ 错误 —— “年”被当成模式字母，无对应含义
注意：单引号本身要成对出现，嵌套时需用两个单引号 '' 表示一个字面单引号

如何让星期几也显示为“星期一”“星期二”而非英文或数字

默认 EEEE 模式输出英文（如 “Monday”），即使系统 Locale 是中文，也不自动本地化中文星期——因为 DateTimeFormatter.ofPattern 本身**不依赖 Locale 渲染文字内容**，它只控制字段宽度和顺序；中文星期、月份名必须靠 DateTimeFormatter.withLocale() 显式指定。

正确组合方式：

先用纯模式字符串定义结构，例如 "yyyy'年'MM'月'dd'日' EEEE"
再链式调用 .withLocale(Locale.CHINA)，否则 EEEE 仍输出英文

完整写法：

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy'年'MM'月'dd'日' EEEE").withLocale(Locale.CHINA);

验证：传入 LocalDate.of(2024, 6, 12) → 输出 "2024年06月12日星期三"

“上午/下午”和12小时制怎么安全适配中文习惯

国人日常虽少用“上午8点”，但在某些表单、日志场景仍需显示。关键点在于：hh（12小时制）必须搭配 a（AM/PM 标记），且 a 的中文渲染同样依赖 Locale.CHINA。

错误示范："a hh:mm" → 不加 withLocale 会输出 “AM 08:30”
正确写法：DateTimeFormatter.ofPattern("a hh:mm").withLocale(Locale.CHINA) → 输出 “上午 08:30”
注意空格：模式中 a 和 hh 之间建议留空格，否则可能粘连成“上午08:30”，视觉不自然
更推荐 24 小时制：HH:mm 更符合国内通用习惯（如交通、政务系统），避免歧义

为什么 `DateTimeFormatter.ofPattern` 不推荐用于解析含中文的字符串

虽然你能用 "yyyy'年'MM'月'dd'日'" 格式化输出，但反过来用它去 parse 用户输入的“2024年06月12日”，大概率失败——因为 parse 时单引号内的字面量必须**严格匹配**，而用户可能输“2024年6月12日”（无前导零）、“二〇二四年六月十二日”（汉字数字）、甚至“2024-06-12”（混用符号）。