// 舊時代的典型代碼
java.util.Date date = new java.util.Date();
PreparedStatement ps = connection.prepareStatement("INSERT INTO table (create_time) VALUES (?)");
ps.setDate(1, new java.sql.Date(date.getTime()));

// java.sql包的時間類
java.sql.Date     // 只包含日期
java.sql.Time     // 只包含時間
java.sql.Timestamp // 包含日期和時間（納秒精度）

// Java 8時間API的核心類
LocalDate         // 日期：2023-01-15
LocalTime         // 時間：14:30:45.123
LocalDateTime     // 日期+時間：2023-01-15T14:30:45.123
ZonedDateTime     // 帶時區(qū)的完整時間
Instant          // 時間線上的瞬間點（UTC）

// JDBC 4.2+ 的直接映射
LocalDateTime ldt = LocalDateTime.now();

// 寫入
PreparedStatement ps = conn.prepareStatement(
    "INSERT INTO events (event_time) VALUES (?)"
);
ps.setObject(1, ldt);  // 直接傳遞LocalDateTime

// 讀取
ResultSet rs = ps.executeQuery();
if (rs.next()) {
    LocalDateTime retrieved = rs.getObject("event_time", LocalDateTime.class);
}

// 傳統(tǒng)方式：類型不匹配可能導致運行時錯誤
ps.setTimestamp(1, Timestamp.valueOf(ldt));  // 需要顯式轉(zhuǎn)換

// 現(xiàn)代方式：編譯時類型檢查
ps.setObject(1, ldt, JDBCType.TIMESTAMP);  // 顯式指定SQL類型

// LocalDateTime支持納秒精度
LocalDateTime preciseTime = LocalDateTime.of(2023, 1, 15, 14, 30, 45, 123456789);

// setObject會正確保持納秒部分
ps.setObject(1, preciseTime);

// 而setTimestamp在某些驅(qū)動中可能丟失精度
ps.setTimestamp(1, Timestamp.valueOf(preciseTime));  // 可能只保留到毫秒

// 存儲UTC時間
ZonedDateTime utcTime = ZonedDateTime.now(ZoneOffset.UTC);
ps.setObject(1, utcTime);

// 或使用Instant（總是UTC）
Instant now = Instant.now();
ps.setObject(1, now);

// 從數(shù)據(jù)庫讀取UTC時間
Instant dbTime = rs.getObject("created_at", Instant.class);

// 轉(zhuǎn)換為用戶時區(qū)
ZonedDateTime userTime = dbTime.atZone(ZoneId.of("Asia/Shanghai"));

@Entity
@Table(name = "orders")
public class Order {
    @Id
    private Long id;
    
    // 創(chuàng)建時間：使用LocalDateTime（無時區(qū)）
    @Column(name = "create_time")
    private LocalDateTime createTime;
    
    // 支付截止時間：使用LocalDate（只關(guān)心日期）
    @Column(name = "payment_deadline")
    private LocalDate paymentDeadline;
    
    // 國際業(yè)務：使用Instant存儲UTC時間
    @Column(name = "utc_timestamp")
    private Instant utcTimestamp;
    
    // 時區(qū)敏感：使用OffsetDateTime
    @Column(name = "scheduled_time")
    private OffsetDateTime scheduledTime;
}

@Repository
public class OrderRepository {
    
    @Autowired
    private JdbcTemplate jdbcTemplate;
    
    public void save(Order order) {
        String sql = """
            INSERT INTO orders 
            (id, create_time, payment_deadline, utc_timestamp, scheduled_time)
            VALUES (?, ?, ?, ?, ?)
            """;
            
        jdbcTemplate.update(sql, ps -> {
            ps.setLong(1, order.getId());
            ps.setObject(2, order.getCreateTime());
            ps.setObject(3, order.getPaymentDeadline());
            ps.setObject(4, order.getUtcTimestamp());
            ps.setObject(5, order.getScheduledTime());
        });
    }
    
    public Order findById(Long id) {
        String sql = "SELECT * FROM orders WHERE id = ?";
        
        return jdbcTemplate.queryForObject(sql, (rs, rowNum) -> {
            Order order = new Order();
            order.setId(rs.getLong("id"));
            order.setCreateTime(rs.getObject("create_time", LocalDateTime.class));
            order.setPaymentDeadline(rs.getObject("payment_deadline", LocalDate.class));
            order.setUtcTimestamp(rs.getObject("utc_timestamp", Instant.class));
            order.setScheduledTime(rs.getObject("scheduled_time", OffsetDateTime.class));
            return order;
        }, id);
    }
}

// 降級方案：使用傳統(tǒng)類型
public void saveWithFallback(Order order) {
    if (isJdbc42Supported()) {
        ps.setObject(1, order.getCreateTime());
    } else {
        // 降級到Timestamp
        ps.setTimestamp(1, 
            order.getCreateTime() != null ? 
            Timestamp.valueOf(order.getCreateTime()) : null);
    }
}

// 安全處理NULL值
public void safeSetTimestamp(PreparedStatement ps, int index, LocalDateTime time) {
    if (time != null) {
        ps.setObject(index, time);
    } else {
        ps.setNull(index, Types.TIMESTAMP);
    }
}

// 基準測試結(jié)果（僅供參考）
// setObject vs setTimestamp 性能接近
// 現(xiàn)代JDBC驅(qū)動已優(yōu)化setObject的實現(xiàn)

// 批量插入時的優(yōu)化
public void batchInsert(List<Order> orders) {
    String sql = "INSERT INTO orders (create_time) VALUES (?)";
    
    try (PreparedStatement ps = connection.prepareStatement(sql)) {
        for (Order order : orders) {
            // 使用setObject不會成為性能瓶頸
            ps.setObject(1, order.getCreateTime());
            ps.addBatch();
        }
        ps.executeBatch();
    }
}

# application.yml
spring:
  jpa:
    properties:
      hibernate:
        jdbc:
          time_zone: UTC  # 統(tǒng)一時區(qū)設置
    hibernate:
      ddl-auto: update

@MappedTypes(LocalDateTime.class)
public class LocalDateTimeTypeHandler extends BaseTypeHandler<LocalDateTime> {
    
    @Override
    public void setNonNullParameter(PreparedStatement ps, int i, 
                                    LocalDateTime parameter, JdbcType jdbcType) {
        // 優(yōu)先使用setObject
        ps.setObject(i, parameter);
    }
    
    @Override
    public LocalDateTime getNullableResult(ResultSet rs, String columnName) {
        // 優(yōu)先使用getObject
        Object value = rs.getObject(columnName);
        if (value == null) {
            return null;
        }
        if (value instanceof LocalDateTime) {
            return (LocalDateTime) value;
        }
        if (value instanceof Timestamp) {
            return ((Timestamp) value).toLocalDateTime();
        }
        throw new IllegalArgumentException("不支持的數(shù)據(jù)庫類型");
    }
}