如何使用 MySQL Connector/J 直接检索 UTC OffsetDateTime?

How to directly retrieve a UTC OffsetDateTime using MySQL Connector/J?

除了显示时间外,我更喜欢所有时间都使用 UTC。在最后一刻,它们可以转换为本地时间仅供显示。

我之前一直在 MySQL 中的整数字段中存储 UNIX 时间戳(自纪元以来的秒数)。我正在使用我无法更改的其他人的数据库模式,它使用 DATETIME 来存储甚至没有偏移量的原始时间。

如何使用 UTC 数据库检索和发送时间对象,使数据库完全不进行任何转换?


尽管是为 PostgreSQL 编写的,但我已尝试遵循 Basil Bourque 对以下问题的出色回答。我在任何地方都使用 Instant,除了他显示我在与 JDBC 交互时使用 OffsetDateTime,因为这是唯一保证 [=55= 支持的现代时刻 class ] 4.2.

我正在使用 MySQL Connector/J 驱动程序版本 8.0.27,并且我正在连接 &preserveInstants=false&connectionTimeZone=UTC

让我们看一下数据库中存储为“2022-01-14 11:00:00”的DATETIME,这被理解为UTC。

resultSet.getString(columnName); // "2022-01-14 11:00:00"
resultSet.getObject(columnName, OffsetDateTime.class).toString() // "2022-01-14T11:00-04:00"
resultSet.getObject(columnName, OffsetDateTime.class).toInstant().toString() // "2022-01-14T15:00:00Z"

当它创建 OffsetDateTime 时,它分配了“-04:00”的系统或服务器(同一台机器)偏移量并将一切都搞砸了。我认为 &preserveInstants=false&connectionTimeZone=UTC 的连接选项应该已经停止了。

我知道我可以在之后使用 .withOffsetSameLocal(ZoneOffset.UTC).toInstant() 立即将偏移量设置为“+00:00”,但是我如何避免这样做并让它直接创建一个 OffsetDateTime 是 UTC ?

TIMESTAMP WITHOUT TIME ZONE

您已经指出了核心问题:table 的作者将列定义为 MySQL DATETIME 类型。该类型仅表示带有时间的日期,但缺少时区或偏移量的上下文。 MySQL DATETIME 列类似于 SQL 标准类型的 TIMESTAMP WITHOUT TIME ZONE

java.time.LocalDateTime

所以您在从 DATETIME 列中检索值时使用了错误的 Java class。不要使用 OffsetDateTime,而是使用 LocalDateTime。与 DATETIME(和 TIMESTAMP WITHOUT TIME ZONE)一样,Java 类型 LocalDateTime 表示具有时间但没有时区或偏移量的日期。

LocalDateTime ldt = myResultSet.getObject( … , LocalDateTime.class ) ;

确定时刻

您可以指定一个偏移量或时区来精确定位时间轴上的某个时刻。

OffsetDateTime odt = ldt.atOffset( ZoneOffset.UTC ) ; 

或:

ZoneId z = ZoneId.of( "America/Edmonton" ) ;
ZonedDateTime zdt = ldt.atZone( z ) ;

你说:

it's assigning either the system or server (same machine) offset of "-04:00" and messing everything up.

遍历过程中的某些部分试图帮助您理解代码的意图,即以仅日期和时间的值开始,并以分配的偏移量结束。可能您的 JDBC 驱动程序是分配偏移量的部分。由于 MySQL DATETIME 没有存储偏移量,因此需要分配 一些 偏移量才能生成您请求的 OffsetDateTime 对象。

如上所示,更好的方法是在使用缺少偏移量的数据库列时不请求 OffsetDateTime 对象。

你问过:

How can I retrieve and send time objects with the database in UTC, so the database is doing absolutely no conversions whatsoever?

您不能将 UTC 中看到的时刻与缺少与 UTC 的偏移量概念的数据库列交换。

如果要在 SQL 数据库中表示时刻,则必须使用适当的数据类型,类似于 SQL 标准类型 TIMESTAMP WITH TIME ZONE.

在将带有偏移量的日期时间值与仅包含日期时间的数据库列交换时,您要求的就像要求将日元价格存储在纯数字列中一样。您可以假装这些记录的值代表以日元表示的价格,但您不知道。有人也可以在那里存储欧元或比索的价格。

由于您似乎对当前的工作情况感到困惑,您可以假装您的 TIMESTAMP WITHOUT TIME ZONE 列存储 UTC 值。这就是我上面的代码示例本质上所做的。

假装写入值,调整为UTC,然后提取一个LocalDateTime

ZonedDateTime zdt = ZonedDateTime.now( z ) ;
OffsetDateTime odt = zdt.withOffsetSameInstant( ZoneOffset.UTC ) ; 
LocalDateTime ldt = odt.toLocalDateTime() ;
myPreparedStatement.setObject( … , ldt ) ;

这种装模作样的做法是充满危险的,也是不负责任的。数据库跟踪的是虚构的,而不是真相。请务必记录此 hack,因为任何刚接触该系统的程序员都会感到非常困惑。

顺便说一句,请注意类型名称 TIMESTAMP WITH TIME ZONETIMESTAMP WITHOUT TIME ZONE 是用词不当。据我所知,以及我在草稿中看到的情况,SQL 标准实际上仅表示偏移量,而不是真正的时区。这就是为什么 OffsetDateTime 是唯一 Java class 映射到 JDBC 以匹配 TIMESTAMP WITH TIME ZONE.