These are the release notes and advice for upgrading Joda-Time from version 2.8 to version 2.9.
Joda-Time version 2.9 --------------------- Joda-Time is a date and time handling library that seeks to replace the JDK Date and Calendar classes. For Java SE 8 and later, please use java.time instead. This release contains enhancements, bug fixes and a time zone update. The release runs on JDK 5 or later. Joda-Time is licensed under the business-friendly Apache License Version 2. This is the same license as all of Apache, plus other open source projects such as Spring. ** Please also check out our related projects ** ** http://www.joda.org/joda-time/related.html ** Enhancements since 2.8 ---------------------- - Faster parsing of time-zone identifiers [#282] - Added Interval.parseWithOffset(String) [#299, #296] Provides a way to parse the fixed offset in an interval string - Add DateTimeFormatter methods for StringBuilder [#298] - Add Russian period translations [#320] - Add Italian period translations [#312] - Add Czech period translations [#313] - Clarify that PeriodFormatterBuilder is in an invalid state once built [#309] - Allow DateTime and Interval to refer to values at Long.MIN_VALUE and Long.MAX_VALUE [#297, #190] A DateTime may be created with any millisecond value, however at the very edges there may be some undesirable effects, for example always using UTC instead of the time-zone - Better error message for malformed tzdb files [#319] - Better error message for interval constructor [#321] Compatibility with 2.8 ---------------------- Build system - Yes Binary compatible - Yes Source compatible - Yes Serialization compatible - Yes Data compatible - Yes - DateTimeZone data updated to version 2015g Semantic compatible - Yes Bug fixes since 2.8 ------------------- - Fixed to handle JDK 8u60 [#288, #291] Without this fix, formatting a time-zone will print "+00:00" instead of "GMT" for the GMT time-zone - Fix parsing of basic form ISO style where year has unnecessary plus sign [#86] For example, +20151030 will now be correctly parsed as year 2015. - Fix overflow bug in intervals [#315] Scala ----- Joda-Time uses annotations from Joda-Convert. In the Java programming language, this dependency is optional, however in Scala it is not. Scala users must manually add the Joda-Convert v1.2 dependency.