怎么用Java将时间存入数据库？

在Java应用中,将时间数据存入数据库是常见需求，但涉及时区转换、精度处理等问题，本文深入解析5种核心方法，涵盖传统java.util.Date与现代java.time API，并提供完整代码示例，助你避开常见陷阱。

时间类型核心对照表

关键原则
优先使用 java.time 包（Java 8+）
明确时区处理策略
数据库字段类型需与Java类型匹配

5种实战方法详解（附代码）

方法1：使用 java.sql.Timestamp (传统方式)

// 存入当前时间（精确到毫秒）
java.util.Date utilDate = new java.util.Date();
java.sql.Timestamp sqlTimestamp = new java.sql.Timestamp(utilDate.getTime());
// JDBC插入操作
String sql = "INSERT INTO events (event_name, event_time) VALUES (?, ?)";
try (PreparedStatement pstmt = connection.prepareStatement(sql)) {
    pstmt.setString(1, "用户登录");
    pstmt.setTimestamp(2, sqlTimestamp);  // 直接设置Timestamp
    pstmt.executeUpdate();
}

适用场景：兼容旧系统，需毫秒级精度
注意：时区依赖JVM默认设置，可能引发跨时区问题

方法2：java.time.LocalDateTime (推荐)

// 获取当前时间（无时区）
LocalDateTime now = LocalDateTime.now();
// 转换为Timestamp（需适配JDBC）
Timestamp timestamp = Timestamp.valueOf(now);
// 插入数据库
String sql = "INSERT INTO orders (order_id, create_time) VALUES (?, ?)";
try (PreparedStatement pstmt = connection.prepareStatement(sql)) {
    pstmt.setInt(1, 1001);
    pstmt.setTimestamp(2, timestamp);
    pstmt.executeUpdate();
}
// 从数据库读取
ResultSet rs = pstmt.executeQuery();
while (rs.next()) {
    Timestamp ts = rs.getTimestamp("create_time");
    LocalDateTime restoredTime = ts.toLocalDateTime();  // 转换回LocalDateTime
}

优势：避免时区混乱，代码更简洁
数据库类型：TIMESTAMP 或 DATETIME（MySQL）

方法3：处理时区敏感场景（ZonedDateTime）

// 获取带时区的时间（如：Asia/Shanghai）
ZonedDateTime zonedTime = ZonedDateTime.now(ZoneId.of("Asia/Shanghai"));
// 转为UTC时间存入
Instant utcInstant = zonedTime.toInstant();
Timestamp timestamp = Timestamp.from(utcInstant);
// JDBC插入
pstmt.setTimestamp(2, timestamp);
// 读取还原
Instant instant = rs.getTimestamp("create_time").toInstant();
ZonedDateTime restored = instant.atZone(ZoneId.of("Asia/Shanghai")); 

最佳实践：

1. 数据库统一存储UTC时间
2. 业务层按需转换时区

方法4：仅存储日期（java.time.LocalDate）

LocalDate birthDate = LocalDate.of(1990, 12, 31);
// 转换为java.sql.Date
java.sql.Date sqlDate = java.sql.Date.valueOf(birthDate);
// 插入数据库
String sql = "INSERT INTO users (name, birth_date) VALUES (?, ?)";
pstmt.setDate(2, sqlDate);
// 读取恢复
java.sql.Date dbDate = rs.getDate("birth_date");
LocalDate restoredDate = dbDate.toLocalDate();

数据库类型：DATE

方法5：通过字符串转换（不推荐，特殊场景使用）

LocalDateTime time = LocalDateTime.now();
DateTimeFormatter formatter = DateTimeFormatter.ISO_LOCAL_DATE_TIME;
String formattedTime = time.format(formatter);  // 转为字符串
// 存入数据库（VARCHAR字段）
pstmt.setString(2, formattedTime);
// 读取解析
String dbString = rs.getString("time_field");
LocalDateTime parsedTime = LocalDateTime.parse(dbString, formatter);

适用场景：

• 旧系统字段限制
• 需人类可读格式存储
  缺点：失去时间类型校验和计算能力

避坑指南：3大关键问题

时区问题

• 错误现象：存入时间比实际晚/早8小时
• 解决方案：
  • 方法① 数据库连接参数追加时区：
    jdbc:mysql://localhost:3306/db?serverTimezone=Asia/Shanghai
  • 方法② 代码层统一转UTC存储

精度丢失

• 场景：Java的Instant支持纳秒，MySQL DATETIME仅到秒
• 处理方案：

  // 设置数据库字段为TIMESTAMP(6)（保留6位小数）
  LocalDateTime time = LocalDateTime.parse("2025-10-01T12:30:45.123456789");
  Timestamp ts = Timestamp.valueOf(time);  // 自动截断为纳秒

日期边界值

• 问题：0000-00-00在Java中会抛异常
• 解决：JDBC连接添加参数：
  jdbc:mysql://...&zeroDateTimeBehavior=CONVERT_TO_NULL

最佳实践总结

1. Java 8+项目 → 强制使用 java.time 包（LocalDateTime/ZonedDateTime）
2. 时区策略：
   • 数据库存储UTC时间
   • 前端展示按用户时区转换
3. 类型匹配：
   • 日期 → LocalDate + DATE
   • 精确时间戳 → Instant + TIMESTAMP
4. 连接参数：
   jdbc:mysql://...?serverTimezone=UTC&zeroDateTimeBehavior=CONVERT_TO_NULL

通过遵循以上规范,可彻底解决时间存储的时区错乱、精度丢失等高频问题。

常见问题解答

Q：为什么从数据库读出的时间比存入时少8小时？
A：因JVM时区与数据库时区不一致，需在JDBC URL中指定serverTimezone参数。

Q：java.util.Date 已过时，为何还要使用？
A：旧系统维护时可能遇到，但新项目务必使用java.time API。

Q：MySQL应该用DATETIME还是TIMESTAMP？
A：

• TIMESTAMP：自动转UTC存储，支持时区转换，范围1970-2038
• DATETIME：按字面值存储，无时区转换，范围1000-9999年
  推荐：需要时区转换选TIMESTAMP，需大时间范围选DATETIME。

引用说明：

• Oracle官方Java 17日期时间文档
• MySQL 8.0日期类型手册
• RFC 3339 (日期时间字符串格式标准)
  本文代码基于JDBC 4.2+和Java 11编写