Java中的`SimpleDateFormat`类用于日期的格式化和解析，它允许将日期对象（`Date`）格式化为指定模式的字符串，也能将符合模式的字符串解析为日期对象[ref_3]。以下是其核心用法、示例及注意事项的详细说明。 ### 一、核心用法与模式字母 `SimpleDateFormat`的使用主要围绕其构造方法和两个核心方法：`format()`（格式化）和`parse()`（解析）[ref_3]。其功能通过**模式字母**定义，这些字母决定了日期时间字符串的最终格式[ref_2]。常用的模式字母及其含义如下表所示： | 模式字母 | 含义 | 示例 | | :--- | :--- | :--- | | `yyyy` | 年份（4位） | 2023 | | `MM` | 月份（2位，不足补零） | 07 | | `dd` | 月份中的天数（2位，不足补零） | 05 | | `HH` | 小时（24小时制，2位） | 14 | | `hh` | 小时（12小时制，2位） | 02 | | `mm` | 分钟（2位） | 08 | | `ss` | 秒（2位） | 45 | | `S` | 毫秒（1-3位） | 156 | | `D` | 年份中的天数（1-3位） | 186 | | `E` | 星期几（文本） | 星期二 | | `a` | 上午/下午标记 | 下午 | *表1：SimpleDateFormat常用模式字母表[ref_2][ref_6]* ### 二、格式化与解析实战示例 #### 1. 格式化（Date -> String） 使用`format()`方法可以将`Date`对象转换为指定格式的字符串。 ```java import java.text.SimpleDateFormat; import java.util.Date; public class DateFormatExample { public static void main(String[] args) { // 创建一个表示当前时间的Date对象 Date now = new Date(); // 1. 创建指定模式的SimpleDateFormat对象 SimpleDateFormat sdf1 = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); // 格式化并输出 String formattedDate1 = sdf1.format(now); System.out.println("格式1: " + formattedDate1); // 输出：格式1: 2023-07-05 14:30:45 // 2. 使用包含星期和上下午的复杂格式 SimpleDateFormat sdf2 = new SimpleDateFormat("yyyy年MM月dd日 E HH时mm分ss秒 a"); String formattedDate2 = sdf2.format(now); System.out.println("格式2: " + formattedDate2); // 输出：格式2: 2023年07月05日 星期三 14时30分45秒 下午 // 3. 仅显示日期部分 SimpleDateFormat sdf3 = new SimpleDateFormat("yyyy/MM/dd"); String formattedDate3 = sdf3.format(now); System.out.println("格式3: " + formattedDate3); // 输出：格式3: 2023/07/05 } } ``` *代码1：使用SimpleDateFormat进行日期格式化[ref_3][ref_4]* #### 2. 解析（String -> Date） 使用`parse()`方法可以将符合模式的字符串转换回`Date`对象。此过程必须处理`ParseException`。 ```java import java.text.ParseException; import java.text.SimpleDateFormat; import java.util.Date; public class DateParseExample { public static void main(String[] args) { // 定义日期字符串 String dateString = "2023-07-05 14:30:45"; // 创建与字符串格式匹配的SimpleDateFormat对象 SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); try { // 将字符串解析为Date对象 Date parsedDate = sdf.parse(dateString); System.out.println("解析后的Date对象: " + parsedDate); // 通常输出为：解析后的Date对象: Wed Jul 05 14:30:45 CST 2023 // 可以再次用其他格式格式化输出，验证解析正确性 SimpleDateFormat outputSdf = new SimpleDateFormat("yyyy年MM月dd日 HH点mm分"); System.out.println("重新格式化后: " + outputSdf.format(parsedDate)); // 输出：重新格式化后: 2023年07月05日 14点30分 } catch (ParseException e) { System.err.println("日期字符串格式解析错误！"); e.printStackTrace(); } } } ``` *代码2：使用SimpleDateFormat进行日期解析[ref_3][ref_5]* ### 三、高级应用与常见场景 #### 1. 处理时间戳 `Date`对象可以通过`getTime()`方法获得自1970年1月1日以来的毫秒数（时间戳）[ref_1]。`SimpleDateFormat`可以方便地将时间戳格式化为可读的日期字符串。 ```java import java.text.SimpleDateFormat; import java.util.Date; public class TimestampExample { public static void main(String[] args) { // 获取当前时间戳（毫秒） long currentTimestamp = System.currentTimeMillis(); System.out.println("当前时间戳: " + currentTimestamp); // 将时间戳转换为Date对象 Date dateFromTimestamp = new Date(currentTimestamp); // 格式化输出 SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss.SSS"); String formatted = sdf.format(dateFromTimestamp); System.out.println("格式化后的时间: " + formatted); // 示例输出：格式化后的时间: 2023-07-05 14:30:45.123 } } ``` *代码3：时间戳的格式化输出[ref_1][ref_2]* #### 2. 使用Calendar进行复杂日期计算 虽然`SimpleDateFormat`专注于格式转换，但结合`Calendar`类可以进行复杂的日期计算，例如获取特定日期[ref_1]。 ```java import java.text.SimpleDateFormat; import java.util.Calendar; import java.util.Date; public class CalendarExample { public static void main(String[] args) { // 获取Calendar实例，并设置为当前时间 Calendar calendar = Calendar.getInstance(); // 计算7天后的日期 calendar.add(Calendar.DAY_OF_MONTH, 7); Date dateInFuture = calendar.getTime(); // 格式化输出 SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd"); System.out.println("一周后的日期是: " + sdf.format(dateInFuture)); // 获取上个月的最后一天 calendar.setTime(new Date()); // 重置为当前时间 calendar.add(Calendar.MONTH, -1); // 上个月 calendar.set(Calendar.DAY_OF_MONTH, calendar.getActualMaximum(Calendar.DAY_OF_MONTH)); // 最后一天 Date lastDayOfLastMonth = calendar.getTime(); System.out.println("上个月的最后一天是: " + sdf.format(lastDayOfLastMonth)); } } ``` *代码4：结合Calendar进行日期计算后格式化[ref_1]* ### 四、关键注意事项与线程安全问题 1. **模式字母大小写敏感**：模式字母是严格区分大小写的。`MM`代表月份，而`mm`代表分钟；`HH`代表24小时制的小时，`hh`代表12小时制的小时[ref_6]。错误使用会导致格式化或解析失败。 2. **解析时的严格性**：默认情况下，`parse()`方法并不严格。例如，对于格式`yyyy-MM-dd`，它可能会成功解析`2023-13-01`（无效的月份13）[ref_3]。在生产环境中，建议进行额外的数据校验。 3. **线程安全问题（极其重要）**：`SimpleDateFormat`是**非线程安全**的类[ref_3]。其内部状态（如`Calendar`实例）会在`format`和`parse`过程中被修改。在多线程环境下共享同一个`SimpleDateFormat`实例会导致数据混乱、解析异常等问题。 * **错误示例（多线程下不安全）**： ```java // 全局共享的SimpleDateFormat实例 private static final SimpleDateFormat unsafeSdf = new SimpleDateFormat("yyyy-MM-dd"); // 多个线程同时调用unsafeSdf.format()或parse()会导致不可预知的结果。 ``` * **解决方案**： * **局部创建**：每次使用时在方法内部创建新的`SimpleDateFormat`实例（性能开销可接受时）。 * **使用ThreadLocal**：为每个线程创建独立的实例副本。 * **使用新的DateTime API**：在Java 8及以上版本中，优先使用`java.time.format.DateTimeFormatter`，它是**线程安全**的。 ### 五、与Java 8+新日期时间API的对比 从Java 8开始，引入了全新的日期时间API（`java.time`包），其核心格式化类是`DateTimeFormatter`。下表对比了二者的主要区别： | 特性 | `SimpleDateFormat` (旧API) | `DateTimeFormatter` (新API) | | :--- | :--- | :--- | | **线程安全** | **否**，非线程安全[ref_3] | **是**，不可变对象，线程安全 | | **设计** | 可变类，易于出错 | 不可变类，函数式设计 | | **解析严格性** | 默认宽松，可设置 | 默认严格，可配置 | | **时区处理** | 依赖于`Calendar`，有时混乱 | 明确分离本地时间、时区时间 | | **推荐使用场景** | 遗留系统维护，Java 8以下环境 | **Java 8及以上版本的所有新项目** | *表2：SimpleDateFormat与DateTimeFormatter核心对比* **迁移示例**：将上述格式化示例改为使用`DateTimeFormatter`。 ```java import java.time.LocalDateTime; import java.time.format.DateTimeFormatter; public class NewDateTimeExample { public static void main(String[] args) { LocalDateTime now = LocalDateTime.now(); // 创建线程安全的格式化器 DateTimeFormatter formatter1 = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"); System.out.println("新API格式1: " + now.format(formatter1)); DateTimeFormatter formatter2 = DateTimeFormatter.ofPattern("yyyy年MM月dd日 E HH时mm分ss秒"); System.out.println("新API格式2: " + now.format(formatter2)); // 解析同样安全 String dateStr = "2023-07-05 14:30:45"; LocalDateTime parsedDateTime = LocalDateTime.parse(dateStr, formatter1); System.out.println("解析后的LocalDateTime: " + parsedDateTime); } } ``` *代码5：使用Java 8的DateTimeFormatter（推荐）* **总结**：`SimpleDateFormat`是Java早期处理日期格式化的核心类，其核心在于通过模式字母定义格式，并使用`format`和`parse`方法进行转换[ref_3][ref_5]。然而，其**非线程安全**的特性[ref_3]和相对陈旧的设计，使得在新项目（尤其是Java 8+环境）中，更推荐使用`java.time.format.DateTimeFormatter`。如果必须在多线程环境中使用`SimpleDateFormat`，务必通过`ThreadLocal`或每次新建实例的方式来保证线程安全。