Oracle的TIMESTAMP WITH TIME ZONE在JDBC中对应java.time.OffsetDateTime（JDBC 4.2+推荐）或oracle.sql.TIMESTAMPTZ（Oracle专有类）；不能用LocalDateTime或java.util.Date接收，否则丢失时区信息并导致值漂移。
Oracle的TIMESTAMP WITH TIME ZONE在JDBC里对应什么类型？
java端不能直接用java.time.localdatetime或java.util.date安全接收——它们丢弃时区信息，且不保证精度。jdbc规范要求用java.time.offsetdatetime（jdbc 4.2+）或oracle.sql.timestamptz（oracle专有类）。优先选offsetdatetime，它能完整保留时区偏移、支持标准操作，且不绑定oracle驱动。
常见错误现象：ResultSet.getObject("col", LocalDateTime.class)看似成功，但实际把TIMESTAMPTZ按JVM本地时区解释，导致值漂移；getTimestamp()返回java.sql.Timestamp，时区信息已丢失，且纳秒精度可能被截断。
- 必须用
rs.getObject("col", OffsetDateTime.class)（推荐） - 若驱动版本旧（America/Los_Angeles），才考虑
rs.getObject("col", TIMESTAMPTZ.class) - 避免
getString()再手动解析——易出错，且无法还原原始精度和时区语义
写入TIMESTAMP WITH TIME ZONE时为什么总报ORA-01805？
这个错误通常不是时间格式问题，而是JDBC驱动没把OffsetDateTime正确转成Oracle可识别的时区上下文。关键在于：Oracle需要知道该时间戳“属于哪个时区”，而OffsetDateTime只含偏移（如+08:00），不含时区ID（如Asia/Shanghai）。当偏移与数据库会话时区不一致，或驱动版本低时，就容易触发此错。
- 写入前确保
OffsetDateTime的偏移与数据库会话时区匹配（可通过ALTER SESSION SET TIME_ZONE = '+08:00'临时设） - 更稳妥的方式是用
PreparedStatement.setObject(idx, odt, JDBCType.TIMESTAMP_WITH_TIMEZONE)，显式指定SQL类型 - 如果必须用时区ID（如存
Asia/Shanghai），得先用ZonedDateTime.withZoneSameInstant(ZoneId.of("Asia/Shanghai"))转成对应偏移，再转OffsetDateTime；Oracle不接受ZonedDateTime直传
oracle.sql.TIMESTAMPTZ比OffsetDateTime多什么能力？
TIMESTAMPTZ是Oracle JDBC驱动提供的原生类型，能读取原始时区名称（如America/New_York）、支持toJDBC()等底层操作，但代价是强耦合Oracle驱动、API笨重、测试难mock。绝大多数业务场景不需要它。
- 仅当需区分
+05:00（固定偏移）和Asia/Kolkata（带夏令时规则的时区）时才考虑 - 用
timestamptz.toString()得到的是Oracle内部格式（含时区名），而OffsetDateTime.toString()是ISO 8601标准格式（含偏移） - 若项目已用Hibernate，注意
@Column(columnDefinition = "TIMESTAMP WITH TIME ZONE")需配合自定义AttributeConverter，且转换器里仍建议用OffsetDateTime作为实体字段类型
Spring Boot + MyBatis如何自动映射？
MyBatis默认不识别TIMESTAMP WITH TIME ZONE，会当作OTHER类型交由Object处理，结果是byte[]或String，完全不可用。必须配置类型处理器。
立即学习“Java免费学习笔记（深入）”；
- 自定义
BaseTypeHandler<OffsetDateTime>，重写setNonNullParameter和getNullableResult，内部调用ps.setObject()和rs.getObject(..., OffsetDateTime.class) - 在
@Select语句中加resultMap并为字段指定javaType="java.time.OffsetDateTime"，否则MyBatis可能跳过类型处理器 - Spring Boot 3.x + Oracle 21c后，可尝试启用
spring.jpa.properties.hibernate.jdbc.time_zone=UTC，但该配置只影响java.time.Instant和LocalDateTime，对TIMESTAMPTZ无效，别被误导
真正麻烦的从来不是类型本身，而是跨层传递时隐式发生的时区转换——比如数据库会话时区、JVM默认时区、连接池初始化SQL、甚至ORM框架的缓存序列化方式，都可能悄悄改掉你的偏移值。动手前先查清当前会话的SELECT SESSIONTIMEZONE FROM DUAL和JVM的ZoneId.systemDefault()。
