Java SimpleDateFormat设置年月时，为何“yyyy-MM”格式化会抛异常？

Question

在使用Java的`SimpleDateFormat`时，如果仅设置“yyyy-MM”格式化日期字符串（如"2023-03"），可能会抛出`ParseException`异常。这是因为`SimpleDateFormat`默认要求完整的日期时间信息（年、月、日）。当输入字符串缺少“日”部分时，解析会失败。 例如，代码`new SimpleDateFormat("yyyy-MM").parse("2023-03")`会抛异常，因为格式化器期待一个完整的日期值（如"2023-03-01"）。解决方法有两种：一是补充完整日期（如"2023-03-01"），二是自定义解析逻辑，手动补全缺失的“日”部分（如设置为月初1号）。 此外，推荐使用`java.time`包中的`YearMonth`类替代`SimpleDateFormat`，因为它更现代化且线程安全。例如，`YearMonth.parse("2023-03", DateTimeFormatter.ofPattern("yyyy-MM"))`可直接解析年月字符串，无需担心异常问题。

Answer 1

深入解析Java日期格式化问题及解决方案

1. 问题描述与初步分析

在使用Java的SimpleDateFormat类时，如果仅设置“yyyy-MM”格式化日期字符串（如"2023-03"），可能会抛出ParseException异常。这是因为SimpleDateFormat默认要求完整的日期时间信息（年、月、日）。当输入字符串缺少“日”部分时，解析会失败。

例如，代码：

new SimpleDateFormat("yyyy-MM").parse("2023-03");

会抛出异常，因为格式化器期待一个完整的日期值（如"2023-03-01"）。

以下是问题的关键点：

• SimpleDateFormat不支持部分日期解析。
• 输入字符串必须严格匹配指定的格式。

2. 解决方案：补充完整日期或自定义逻辑

为了解决上述问题，可以采用以下两种方法：

2.1 方法一：补充完整日期

最直接的方法是将输入字符串补全为完整的日期格式。例如，将"2023-03"改为"2023-03-01"：

String dateStr = "2023-03-01";
Date date = new SimpleDateFormat("yyyy-MM-dd").parse(dateStr);

这种方式简单直观，但需要确保所有输入都经过预处理。

2.2 方法二：自定义解析逻辑

如果无法保证输入字符串始终包含完整日期，可以通过手动补全缺失的“日”部分来解决。例如，假设所有缺失的“日”部分都默认为月初1号：

String dateStr = "2023-03";
if (!dateStr.contains("-0")) {
    dateStr += "-01"; // 默认补全为月初1号
}
Date date = new SimpleDateFormat("yyyy-MM-dd").parse(dateStr);

3. 推荐替代方案：使用java.time包

从Java 8开始，推荐使用java.time包中的YearMonth类替代SimpleDateFormat。原因如下：

• SimpleDateFormat不是线程安全的，而java.time包中的类是线程安全的。
• YearMonth类专门用于处理年月数据，功能更强大且现代化。

示例代码：

YearMonth yearMonth = YearMonth.parse("2023-03", DateTimeFormatter.ofPattern("yyyy-MM"));
System.out.println(yearMonth); // 输出: 2023-03

4. 流程图与对比分析

以下是两种方法的流程图对比：

graph TD;
    A[输入日期字符串] --> B{是否包含"日"？};
    B -- 是 --> C[直接解析];
    B -- 否 --> D[补全为月初1号];
    D --> C;

以下是SimpleDateFormat和YearMonth的对比表格：

特性	SimpleDateFormat	YearMonth
线程安全性	否	是
功能范围	通用日期格式化	专注于年月处理
易用性	较复杂	简单直观

通过上述分析可以看出，java.time包提供了更优的解决方案。