# Java SimpleDateFormat 常用日期格式化模式详解 SimpleDateFormat 是 Java 中用于日期和时间格式化的核心类，它提供了一组格式化模式字符来定义日期和时间的显示方式。下面将详细介绍常用的格式化模式及其具体应用。 ## 一、常用日期格式化模式字符 ### 1.1 核心模式字符表 | 模式字符 | 含义 | 示例输出 | |---------|------|----------| | `yyyy` | 四位数的年份 | 2024 | | `yy` | 两位数的年份 | 24 | | `MM` | 两位数的月份（01-12） | 08 | | `M` | 一位或两位数的月份 | 8 | | `dd` | 两位数的日期（01-31） | 15 | | `d` | 一位或两位数的日期 | 15 | | `HH` | 24小时制的小时（00-23） | 14 | | `hh` | 12小时制的小时（01-12） | 02 | | `mm` | 分钟（00-59） | 30 | | `ss` | 秒钟（00-59） | 45 | | `SSS` | 毫秒（000-999） | 123 | | `E` | 星期几 | 星期四 | | `a` | 上午/下午标记 | 下午 | ### 1.2 完整格式化模式示例 ```java import java.text.SimpleDateFormat; import java.util.Date; public class DateFormatExample { public static void main(String[] args) { Date currentDate = new Date(); // 完整日期时间格式 SimpleDateFormat sdf1 = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); System.out.println("格式1: " + sdf1.format(currentDate)); // 输出: 2024-08-15 14:30:45 // 中文日期格式 SimpleDateFormat sdf2 = new SimpleDateFormat("yyyy年MM月dd日 HH时mm分ss秒"); System.out.println("格式2: " + sdf2.format(currentDate)); // 输出: 2024年08月15日 14时30分45秒 // 带星期的格式 SimpleDateFormat sdf3 = new SimpleDateFormat("yyyy-MM-dd EEEE"); System.out.println("格式3: " + sdf3.format(currentDate)); // 输出: 2024-08-15 星期四 // 12小时制格式 SimpleDateFormat sdf4 = new SimpleDateFormat("yyyy/MM/dd hh:mm:ss a"); System.out.println("格式4: " + sdf4.format(currentDate)); // 输出: 2024/08/15 02:30:45 下午 } } ``` ## 二、实际应用场景及代码示例 ### 2.1 日志记录场景 在日志系统中，通常需要将日期格式化为标准的字符串格式： ```java import java.text.SimpleDateFormat; import java.util.Date; public class LoggingExample { private static final SimpleDateFormat LOG_DATE_FORMAT = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss.SSS"); public void logMessage(String message) { String timestamp = LOG_DATE_FORMAT.format(new Date()); System.out.println("[" + timestamp + "] " + message); } public static void main(String[] args) { LoggingExample logger = new LoggingExample(); logger.logMessage("系统启动成功"); // 输出: [2024-08-15 14:30:45.123] 系统启动成功 } } ``` ### 2.2 文件命名场景 在生成文件时，经常需要在文件名中包含时间戳： ```java import java.text.SimpleDateFormat; import java.util.Date; public class FileNamingExample { public String generateFileName(String baseName) { SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMdd_HHmmss"); String timestamp = sdf.format(new Date()); return baseName + "_" + timestamp + ".txt"; } public static void main(String[] args) { FileNamingExample example = new FileNamingExample(); String fileName = example.generateFileName("report"); System.out.println("生成的文件名: " + fileName); // 输出: report_20240815_143045.txt } } ``` ### 2.3 数据库操作场景 在数据库操作中，日期格式的转换尤为重要： ```java import java.text.SimpleDateFormat; import java.text.ParseException; import java.util.Date; public class DatabaseExample { // 数据库日期格式通常为 yyyy-MM-dd private static final SimpleDateFormat DB_DATE_FORMAT = new SimpleDateFormat("yyyy-MM-dd"); public String formatDateForDB(Date date) { return DB_DATE_FORMAT.format(date); } public Date parseDateFromDB(String dateString) throws ParseException { return DB_DATE_FORMAT.parse(dateString); } public static void main(String[] args) { try { DatabaseExample dbExample = new DatabaseExample(); Date currentDate = new Date(); // 格式化为数据库格式 String dbDate = dbExample.formatDateForDB(currentDate); System.out.println("数据库日期: " + dbDate); // 输出: 2024-08-15 // 从数据库字符串解析为Date对象 Date parsedDate = dbExample.parseDateFromDB("2024-08-15"); System.out.println("解析后的日期: " + parsedDate); } catch (ParseException e) { e.printStackTrace(); } } } ``` ## 三、特殊格式处理 ### 3.1 季度格式化 虽然 SimpleDateFormat 没有直接的季度模式字符，但可以通过组合实现： ```java import java.text.SimpleDateFormat; import java.util.Calendar; import java.util.Date; public class QuarterFormatExample { public String formatWithQuarter(Date date) { SimpleDateFormat sdf = new SimpleDateFormat("yyyy"); Calendar cal = Calendar.getInstance(); cal.setTime(date); int month = cal.get(Calendar.MONTH); int quarter = (month / 3) + 1; return sdf.format(date) + "年第" + quarter + "季度"; } public static void main(String[] args) { QuarterFormatExample example = new QuarterFormatExample(); String quarterStr = example.formatWithQuarter(new Date()); System.out.println("季度格式: " + quarterStr); // 输出: 2024年第3季度 } } ``` ### 3.2 国际化日期格式 针对不同地区的日期显示需求： ```java import java.text.SimpleDateFormat; import java.util.Date; import java.util.Locale; public class InternationalDateFormat { public static void main(String[] args) { Date currentDate = new Date(); // 美国格式 SimpleDateFormat usFormat = new SimpleDateFormat("MM/dd/yyyy", Locale.US); System.out.println("美国格式: " + usFormat.format(currentDate)); // 输出: 08/15/2024 // 英国格式 SimpleDateFormat ukFormat = new SimpleDateFormat("dd/MM/yyyy", Locale.UK); System.out.println("英国格式: " + ukFormat.format(currentDate)); // 输出: 15/08/2024 // 德国格式 SimpleDateFormat deFormat = new SimpleDateFormat("dd.MM.yyyy", Locale.GERMANY); System.out.println("德国格式: " + deFormat.format(currentDate)); // 输出: 15.08.2024 } } ``` ## 四、高级格式模式 ### 4.1 包含时区的格式 ```java import java.text.SimpleDateFormat; import java.util.Date; import java.util.TimeZone; public class TimeZoneFormatExample { public static void main(String[] args) { Date currentDate = new Date(); // 包含时区的格式 SimpleDateFormat sdf1 = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss z"); System.out.println("本地时区: " + sdf1.format(currentDate)); // 输出: 2024-08-15 14:30:45 CST // 设置特定时区 SimpleDateFormat sdf2 = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss z"); sdf2.setTimeZone(TimeZone.getTimeZone("America/New_York")); System.out.println("纽约时区: " + sdf2.format(currentDate)); // 输出: 2024-08-15 02:30:45 EDT // ISO 8601 格式 SimpleDateFormat sdf3 = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSXXX"); sdf3.setTimeZone(TimeZone.getTimeZone("UTC")); System.out.println("UTC格式: " + sdf3.format(currentDate)); // 输出: 2024-08-15T06:30:45.123Z } } ``` ### 4.2 自定义分隔符和文本 ```java import java.text.SimpleDateFormat; import java.util.Date; public class CustomFormatExample { public static void main(String[] args) { Date currentDate = new Date(); // 使用自定义分隔符 SimpleDateFormat sdf1 = new SimpleDateFormat("yyyy~MM~dd"); System.out.println("自定义分隔符: " + sdf1.format(currentDate)); // 输出: 2024~08~15 // 包含文本内容 SimpleDateFormat sdf2 = new SimpleDateFormat("'当前时间:' yyyy年MM月dd日 '星期' E"); System.out.println("包含文本: " + sdf2.format(currentDate)); // 输出: 当前时间: 2024年08月15日 星期 四 // 组合多种格式 SimpleDateFormat sdf3 = new SimpleDateFormat("yyyyMMdd_HHmmss_SSS"); System.out.println("组合格式: " + sdf3.format(currentDate)); // 输出: 20240815_143045_123 } } ``` ## 五、注意事项和最佳实践 ### 5.1 线程安全性问题 SimpleDateFormat 不是线程安全的，在多线程环境中需要特别注意： ```java import java.text.SimpleDateFormat; import java.util.Date; public class ThreadSafeDateFormat { // 每个线程使用独立的 SimpleDateFormat 实例 private static final ThreadLocal<SimpleDateFormat> threadLocalDateFormat = ThreadLocal.withInitial(() -> new SimpleDateFormat("yyyy-MM-dd HH:mm:ss")); public static String formatDate(Date date) { return threadLocalDateFormat.get().format(date); } public static void main(String[] args) { Date currentDate = new Date(); System.out.println("线程安全格式化: " + formatDate(currentDate)); } } ``` ### 5.2 严格的日期解析 ```java import java.text.SimpleDateFormat; import java.text.ParseException; import java.util.Date; public class StrictParsingExample { public static void main(String[] args) { SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd"); sdf.setLenient(false); // 设置为严格模式 try { // 正常日期 Date date1 = sdf.parse("2024-08-15"); System.out.println("正常日期: " + date1); // 非法日期 - 将抛出 ParseException Date date2 = sdf.parse("2024-13-32"); System.out.println("非法日期: " + date2); } catch (ParseException e) { System.out.println("日期解析错误: " + e.getMessage()); // 输出: 日期解析错误: Unparseable date: "2024-13-32" } } } ``` 通过以上详细的介绍和代码示例，我们可以看到 SimpleDateFormat 提供了丰富而灵活的日期格式化模式，能够满足各种业务场景的需求。在实际使用中，建议根据具体需求选择合适的格式化模式，并注意线程安全和异常处理问题[ref_1][ref_5]。