如何让PreparedStatement通过Timestamp.from(Instant)写入UTC时间而非本地时区

问题根源 #

你当前代码的核心问题有两个：

1. 使用setString()传递时间戳值，jTDS驱动在解析字符串形式的Timestamp时，会默认采用本地时区进行转换，导致最终写入数据库的是本地时间而非UTC。
2. 没有显式指定JDBC操作的时区，驱动默认沿用系统本地时区处理时间数据。

正确实现方案 #

方案1：使用setTimestamp()并指定UTC时区

直接使用JDBC专门的时间戳设置方法，同时显式传入UTC时区，确保驱动以UTC时间写入：

PreparedStatement ps = connection.prepareStatement(...)
// 获取当前UTC时间戳
Instant utcInstant = Instant.now();
Timestamp utcTimestamp = Timestamp.from(utcInstant);
// 显式指定UTC时区设置参数
ps.setTimestamp(1, utcTimestamp, Calendar.getInstance(TimeZone.getTimeZone("UTC")));

方案2：在JDBC连接URL中强制指定UTC时区

修改数据库连接URL，添加时区参数，让整个连接会话都以UTC处理时间：

jdbc:jtds:sqlserver://<host>:<port>/<dbname>?useUTC=true

此时可以直接使用setTimestamp()（无需额外指定Calendar）：

PreparedStatement ps = connection.prepareStatement(...)
ps.setTimestamp(1, Timestamp.from(Instant.now()));

关键注意事项 #

• 绝对避免使用setString()传递时间戳类型数据，字符串的时区解析逻辑依赖驱动实现，极易出现时区偏差。
• 若数据库表字段类型是datetime或datetime2，确保字段本身存储的是UTC时间，后续查询时也需以UTC时区读取。

内容的提问来源于stack exchange，提问作者Randy B