JDBC：在 UTC 中插入时间戳

Question

我的部分表定义（MySQL）如下：

+-----------+----------+------+-----+---------+----------------+
| Field     | Type     | Null | Key | Default | Extra          |
+-----------+----------+------+-----+---------+----------------+
| ...       | ...      | ..   | ... | ...     | ...            |
| timestamp | datetime | YES  |     | NULL    |                |
| ...       | ...      | ..   | ... | ...     | ...            |
+-----------+----------+------+-----+---------+----------------+

我想使用 JDBC 更新时间戳字段。假设时间戳为 UTC。

在我的 Java 代码中，我获取时间戳字段如下：

Timestamp datetime = new Timestamp(new Date().getTime());
        

java.util.Date 的文档指出：
尽管 Date 类旨在反映协调世界时 (UTC)，但它可能并不完全如此，具体取决于主机环境Java 虚拟机。

不幸的是，在我的 Windows 10 环境（java 版本“1.8.0_231”）中，Date 对象反映了我的本地时区。因此，添加到数据库的时间戳是本地时区，而不是 UTC。

---

Q) 如何获取 UTC 时间戳，以便将正确的值添加到数据库中？

Answer 1

tl;博士

MySQL 中的数据类型错误，Java 中的类也错误。

• 写入类型为TIMESTAMP 而不是DATETIME 的列。
• 使用java.time.OffsetDateTime 而不是java.sql.Timestamp。

示例代码 sn-p.

myPreparedStatement
.setObject( 
    … ,                       // Specify which placeholder `?` to fill-in.
    OffsetDateTime            // JDBC 4.2 and later requires a JDBC driver support exchanging `java.time.OffsetDateTime` objects with the database.
    .now( ZoneOffset.UTC )    // Capture the current moment as seen in UTC (an offset of zero hours-minutes-seconds). 
)

MySQL 中的数据类型错误

假设时间戳是UTC

您知道 MySQL 中的 DATETIME 不是 UTC 中的 吗？ MySQL 中的那种类型没有时区的概念，也没有从 UTC 偏移的概念。

如果您正在跟踪时刻、时间线上的特定点，那么您在 MySQL 中的数据类型有误。您应该使用 TIMESTAMP 在 MySQL 中跟踪时刻。

错误的 Java 类

您正在使用与 Java 的最早版本捆绑在一起的糟糕日期时间类。这些类已被 Java 8 及更高版本中的现代 java.time 类所取代，如 JSR 310 中所定义。切勿使用 java.sql.Timestamp 类。

要获取 UTC 中的当前时刻，请使用 Instant。

Instant instant = Instant.now() ;

将您在 MySQL 中的列定义为类型TIMESTAMP。

您可能能够通过您的 JDBC 驱动程序编写 Instant。然而，JDBC 4.2 需要对OffsetDateTime 的支持，但奇怪的是忽略了对Instant 的必要支持。没关系，我们可以轻松转换。

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

使用符合 JDBC 4.2 或更高版本的 JDBC 驱动程序，通过准备好的语句将其写入数据库。

myPreparedStatement.setObject( … , odt ) ;

检索。

OffsetDateTime odt = myResultSet.getObject( … , OffsetDateTime.class ) ;

时区问题消除

如果您按照此处看到的代码进行操作，则不会出现时区问题。

• 这些代码都不依赖于 JVM 当前的默认时区。
• 此代码均不依赖于数据库服务器当前的默认时区。

---

---

关于java.time

java.time 框架内置于 Java 8 及更高版本中。这些类取代了麻烦的旧 legacy 日期时间类，例如 java.util.Date、Calendar 和 SimpleDateFormat。

要了解更多信息，请参阅Oracle Tutorial。并在 Stack Overflow 上搜索许多示例和解释。规格为JSR 310。

Joda-Time 项目现在位于maintenance mode，建议迁移到java.time 类。

您可以直接与您的数据库交换 java.time 对象。使用符合JDBC 4.2 或更高版本的JDBC driver。不需要字符串，不需要java.sql.* 类。 Hibernate 5 & JPA 2.2 支持 java.time。

从哪里获取 java.time 类？

• Java SE 8、Java SE 9、Java SE 10、Java SE 11 和更高版本 - 包含捆绑实现的标准 Java API 的一部分。
• Java 9 添加了一些小功能和修复。
• Java SE 6 和 Java SE 7
• 大部分 java.time 功能在ThreeTen-Backport 中向后移植到 Java 6 和 7。
• Android
• java.time 类的 Android 捆绑包实现的更高版本。
• 对于早期的 Android (ThreeTenABP 项目适应 ThreeTen-Backport（如上所述）。见How to use ThreeTenABP…。

Answer 2

Q) 如何获取 UTC 时间戳

按如下方式进行：

ZonedDateTime zdt = ZonedDateTime.now(ZoneId.of("Etc/UTC"));
Timestamp timestamp = Timestamp.valueOf(zdt.toLocalDateTime());

注意事项：

1. 由于您想使用时间戳，我建议您将字段类型更改为TIMESTAMP。更多详情请查看this。
2. 停止使用过时的 java.util 日期时间 API 并切换到 modern date-time API。

Answer 3

您可以让 MySQL 使用此列定义插入时间戳

CREATE TABLE SOME_TABLE_NAME (
     SOME_COLUMN_NAME TIMESTAMP default CURRENT_TIMESTAMP
);