必须用TIMESTAMP字段+java.sql.Timestamp：当Oracle字段定义为TIMESTAMP（含TIMESTAMP(0)）时，Java必须用java.sql.Timestamp读写，否则丢精度或异常；DATE字段仅在明确无需时分秒时才可用LocalDate。
oracle 的 date 和 timestamp 在 java 中不能混用，选型必须由字段实际精度需求决定，而不是“看着差不多就用 java.sql.date”。
什么时候必须用 TIMESTAMP 字段 + java.sql.Timestamp
只要数据库字段定义为 TIMESTAMP（哪怕精度是 TIMESTAMP(0)），Java 就必须用 java.sql.Timestamp 读写。否则会丢精度或抛异常。
- 插入时用
ps.setTimestamp(1, ts)；用ps.setDate(1, date)会把毫秒截断为 0，且 Oracle 可能静默转成午夜时间 - 查询时用
rs.getTimestamp("col")；用rs.getDate("col")会丢失小数秒，即使字段存的是2026-04-28 15:30:45.123，也会变成2026-04-28 15:30:45.0 - MyBatis 中对应
jdbcType="TIMESTAMP"，不是"DATE"；设错会导致类型转换失败或默认值填充
什么时候能用 DATE 字段 + java.time.LocalDate 或 java.time.LocalDateTime
仅当业务上**明确不需要时分秒**，或字段在建表时就是 DATE 类型且从不存时间部分（如生日、合同签署日）时，才考虑用 LocalDate。
-
DATE在 Oracle 内部固定存年月日时分秒，但语义上常被当作“日期”用；LocalDate对应纯日期，无时区无时间，映射安全 - 若字段是
DATE但实际存了2026-04-28 10:20:30，又想用LocalDateTime，必须确认 JDBC 驱动版本 ≥ 12.2，且连接参数加oracle.jdbc.javaTimeTypes=true，否则仍会退化为java.sql.Date - Spring Boot 项目中，JPA 实体类字段类型与数据库类型不一致（如 DB 是
DATE，Java 用了LocalDateTime）会导致 Hibernate 自动加时区转换，结果偏移 8 小时——这不是 bug，是默认按 JVM 时区解释DATE值
rs.getTimestamp(String, Calendar) 为什么必须显式传 UTC
Oracle TIMESTAMP 本身不带时区，但 JDBC 驱动在解析时会按传入的 Calendar 时区解释其“本地含义”。用 rs.getTimestamp("ts")（无 Calendar）等价于用 getDefault()，而该值在 JVM 启动时固化，改系统时区无效。
- 正确做法：
Calendar utc = Calendar.getInstance(TimeZone.getTimeZone("UTC"));，再调rs.getTimestamp("ts", utc) - 错误典型：用
TimeZone.getDefault()初始化Calendar，测试环境是东八区，上线到海外服务器就出错 - Spring JdbcTemplate 可统一配置
setResultSetExtractor封装该逻辑，避免每处手写重复代码
TIMESTAMP WITH TIME ZONE 别试图直接映射到 ZonedDateTime
ojdbc 把 TIMESTAMP WITH TIME ZONE 映射为私有类 oracle.sql.TIMESTAMPTZ，JDBC 标准不支持直接转 ZonedDateTime。强转或调 toJdbc() 会丢时区信息。
- 必须用
rs.getObject("ts_tz", oracle.sql.TIMESTAMPTZ.class)拿到原生对象 - 再调
timestamptz.toInstant()（ojdbc 21c+）或timestamptz.timestampValue(conn).toInstant()（旧版）转成Instant，这是唯一可靠路径 - 不要写
rs.getObject("ts_tz", ZonedDateTime.class)，会直接抛SQLFeatureNotSupportedException
最易被忽略的一点：Oracle 的 DATE 和 TIMESTAMP 不只是“精度差别”，它们在 JDBC 层触发的是完全不同的类型转换路径。一个字段定义错了，整个链路的时间语义就不可控——尤其在跨时区部署、审计日志、金融对账等场景下，毫秒级偏差可能引发严重问题。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
