tl;博士
myPreparedStatement.setObject( // Insert object into database for `TIMESTAMP WITHOUT TIME ZONE` type of column.
… ,
LocalDate.parse( "2015-02-05" ) // Parse input string to a date-only value lacking time-of-day and lacking time zone.
.atStartOfDay() // Determine start of a generic 24-hour day for a `LocalDateTime` object lacking offset-from-UTC and lacking time zone.
) ;
java.time
Joda-Time 项目现在位于maintenance mode,团队建议迁移到java.time 类。见Tutorial by Oracle。
解析你的输入字符串
LocalDate ld = LocalDate.parse( "2015-02-05" ) ;
未分区
如果您的业务问题缺少任何与 UTC 或时区的偏移,不是时间线上的特定时刻,那么通过转换为LocalDateTime。
LocalDateTime ldt = ld.atStartOfDay() ;
ldt.toString(): 2015-02-05T00:00
要将其存储在数据库中类似于 SQL 标准类型 TIMESTAMP WITHOUT TIME ZONE 的数据类型列中,请使用符合 JDBC 4.2 及更高版本的带有 JDBC driver 的 java.time 对象。最好与您的数据库交换对象,而不仅仅是字符串。
myPreparedStatement.setObject( … , ldt ) ;
……和……
LocalDateTime ldt = myResultSet.getObject( … , LocalDateTime.class ) ;
分区
如果您的业务问题确实涉及偏移量或区域,您必须指定在时间线上获取实际点。
一天的第一刻并不总是 00:00:00。诸如Daylight Saving Time (DST) 之类的异常意味着一天可能从另一个时间开始,例如 01:00:00。让 java.time 通过调用LocalDate::atStartOfDay 来确定一天中的第一个时刻。
ZoneId z = ZoneId.of( "Africa/Tunis" ) ;
ZonedDateTime zdt = ld.atStartOfDay( z ) ;
zdt.toString(): 2015-02-05T00:00+01:00[非洲/突尼斯]
如上所示,与您的数据库交换 java.time 对象。如果您尝试记录历史中的实际时刻,您的数据库列的类型应与 SQL 标准 TIMESTAMP WITH TIME ZONE 等效。
myPreparedStatement.setObject( … , zdt ) ;
……和……
LocalDateTime ldt = myResultSet.getObject( … , ZonedDateTime.class ) ;
您的驱动程序和/或数据库可能会将此类分区值转换为 UTC 值。或者你可以自己明确地这样做。提取一个始终为 UTC 的 Instant 对象。
myPreparedStatement.setObject( … , zdt.toInstant() ) ;
……和……
Instant instant = myResultSet.getObject( … , Instant.class ) ;
ZonedDateTime zdt = instant.atZone( z ) ;
关于java.time
java.time 框架内置于 Java 8 及更高版本中。这些类取代了麻烦的旧 legacy 日期时间类,例如 java.util.Date、Calendar 和 SimpleDateFormat。
Joda-Time 项目现在位于maintenance mode,建议迁移到java.time 类。
要了解更多信息,请参阅Oracle Tutorial。并在 Stack Overflow 上搜索许多示例和解释。规格为JSR 310。
您可以直接与您的数据库交换 java.time 对象。使用符合JDBC 4.2 或更高版本的JDBC driver。不需要字符串,不需要java.sql.* 类。
从哪里获得 java.time 类?
ThreeTen-Extra 项目通过附加类扩展了 java.time。该项目是未来可能添加到 java.time 的试验场。您可以在这里找到一些有用的类,例如Interval、YearWeek、YearQuarter 和more。