tl;博士
-
切勿使用
java.sql.Date 或 java.util.Date。
仅使用 java.time 类。
- 对于仅日期值,使用
LocalDate。
您只会看到稳定的值,不受夏令时 (DST) 的影响。
例子:
LocalDate.parse( "2019-01-23" )
java.sql.Date 不是日期
我不确定到底是什么问题,但我怀疑这是由于您使用了糟糕的 java.sql.Date 类,因此没有实际意义。
java.sql.Date 类假装 表示仅日期值,没有时间和时区。然而,由于一些难以想象的糟糕设计决策,该类扩展了java.util.Date。 java.util.Date 类确实有时间并且是UTC。更令人困惑的是,java.util.Date 在其源代码中隐藏了一个时区,没有 getter 和 setter,因此它似乎还没有影响像 equals 这样的方法的行为。所以java.sql.Date,尽管它的名字,尽管它的目的是只保存一个日期,实际上确实有一个时间设置为UTC。所以java.sql.Date 在调整一天中的时间方面采取了一些技巧,这可能是您遇到的问题。这些传统的日期时间课程是一大堆热气腾腾的……燕麦片。你不应该使用它们。
为java.sql.Date 类引用the JavaDoc:
一个毫秒值的瘦包装器,允许 JDBC 将其识别为 SQL DATE 值。毫秒值表示自 1970 年 1 月 1 日 00:00:00.000 GMT 以来经过的毫秒数。
为了符合 SQL DATE 的定义,由 java.sql.Date 实例包装的毫秒值必须通过在特定时区中将小时、分钟、秒和毫秒设置为零来进行“规范化”。实例已关联。
顺便说一句,java.sql.Timestamp 也是一团糟。它也笨拙地从 java.util.Date 继承,添加了一个 second 小数秒的纳秒。也避免使用这个类,现在替换为java.time.Instant 或java.time.OffsetDateTime。同样,java.sql.Time 被 java.time.LocalTime 替换。
java.time.LocalDate 是真正日期
随着 JSR 310 和 JDBC 4.2 的采用,您可以使用现代业界领先的 java.time 类。到目前为止,Jackson 可能已经更新为使用 java.time。如果没有,请参阅this Question 以获取数据类型模块的链接以处理 Jackson 中的 java.time。
看起来您的输入字符串是标准的ISO 8601 格式,YYYY-MM-DD。 java.time 类在解析/生成表示日期时间值的字符串时默认使用标准格式。对于仅日期使用,LocalDate 类确实是一个没有时间的日期,也没有区域/偏移量。您将看到不受Daylight Saving Time (DST) 影响的稳定日期值。
解析。
LocalDate ld = LocalDate.parse( "2019-01-23" ) ;
商店。
myPreparedStatement.setObject( … , ld ) ;
检索。
LocalDate ld = myResultSet.getObject( … , LocalDate.class ) ;
关于LocalDate
LocalDate 类表示仅日期值,没有时间,也没有 time zone 或 offset-from-UTC。
时区对于确定日期至关重要。对于任何给定的时刻,日期在全球范围内因区域而异。例如,Paris France 中午夜后几分钟是新的一天,而 Montréal Québec 中仍然是“昨天”。
如果没有指定时区,JVM 会隐式应用其当前的默认时区。该默认值可能在运行时(!)期间change at any moment,因此您的结果可能会有所不同。最好将您想要/预期的时区明确指定为参数。如果关键,请与您的用户确认该区域。
以Continent/Region 的格式指定proper time zone name,例如America/Montreal、Africa/Casablanca 或Pacific/Auckland。切勿使用 2-4 个字母的缩写,例如 EST 或 IST,因为它们不是真正的时区,没有标准化,甚至不是唯一的 (!)。
ZoneId z = ZoneId.of( "America/Montreal" ) ;
LocalDate today = LocalDate.now( z ) ;
如果你想使用 JVM 当前的默认时区,请求它并作为参数传递。如果省略,代码会变得难以阅读,因为我们不确定您是否打算使用默认值,或者您是否像许多程序员一样没有意识到这个问题。
ZoneId z = ZoneId.systemDefault() ; // Get JVM’s current default time zone.
或者指定一个日期。您可以通过数字设置月份,1 月至 12 月的编号为 1-12。
LocalDate ld = LocalDate.of( 1986 , 2 , 23 ) ; // Years use sane direct numbering (1986 means year 1986). Months use sane numbering, 1-12 for January-December.
或者,更好的是,使用预定义的Month 枚举对象,一年中的每个月一个。提示:在整个代码库中使用这些 Month 对象,而不是仅仅使用整数,以使您的代码更具自我记录性、确保有效值并提供 type-safety。 Year 和 YearMonth 同上。
LocalDate ld = LocalDate.of( 1986 , Month.FEBRUARY , 23 ) ;
关于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.* 类。
从哪里获得 java.time 类?
ThreeTen-Extra 项目通过附加类扩展了 java.time。该项目是未来可能添加到 java.time 的试验场。您可以在这里找到一些有用的类,例如Interval、YearWeek、YearQuarter 和more。