| <?xml version="1.0" encoding="ISO-8859-1"?> | |
| <document> | |
| <properties> | |
| <title>Java date and time API - Upgrade from 1.5 to 1.6</title> | |
| <author>Stephen Colebourne</author> | |
| </properties> | |
| <body> | |
| <section name="Upgrade"> | |
| <p> | |
| These are the release notes and advice for upgrading Joda-Time from | |
| version 1.5 to version 1.6. | |
| <source> | |
| Joda-Time version 1.6 | |
| --------------------- | |
| Joda-Time is a date and time handling library that seeks to replace the JDK | |
| Date and Calendar classes. | |
| This is the seventh release of Joda-Time. | |
| This release contains enhancements, bug fixes and a time zone update. | |
| We recommend JDK 1.4 or later, and have performed no testing on earlier JDKs. | |
| 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. | |
| The intent is to make the code available to the Java community with the minimum | |
| of restrictions. If the license causes you problems please contact the mailing list. | |
| ** Please also check out our related projects ** | |
| ** http://www.joda.org/joda-time/related.html ** | |
| ******************************************************************** | |
| The next release will probably be v2.0 | |
| This will be source and binary compatible with the exception that | |
| deprecated methods and classes will be removed. | |
| If you rely on the deprecated methods or classes please move to | |
| their replacements, or let us know why you can't move by writing | |
| in https://sourceforge.net/forum/forum.php?forum_id=337835 | |
| ******************************************************************** | |
| Enhancements since 1.5 | |
| ---------------------- | |
| - Add static factory methods to Duration [1909376] | |
| Duration now has four factory methods, standardDays(), standardHours(), | |
| standardMinutes() and standardSeconds(). These create durations of the | |
| length normally associated with a day/hour/minute/second | |
| - Added Duration.getStandardSeconds() and Duration.toStandardSeconds() | |
| These convert a duration in milliseconds to a number of seconds. | |
| - Added OSGi bundle information [1889787] | |
| Joda-Time should be usable directly as an OSGi bundle | |
| - Added stable Chronology hash code implementations [2018795] | |
| The hash codes of each Chronology implementation is now stable. | |
| This should aid large scale caching/distribution tools. | |
| - Added DateTimeZone.isLocalDateTimeGap | |
| Returns true/false depending on whether the time is in a time-zone gap | |
| Compatibility with 1.5 | |
| ---------------------- | |
| Binary compatible - Yes | |
| Source compatible - Yes | |
| Serialization compatible - Yes | |
| Data compatible - Yes, except | |
| - DateTimeZone data updated to version 2008i | |
| Semantic compatible - Yes | |
| Deprecations since 1.5 | |
| ---------------------- | |
| Bug fixes since 1.5 | |
| ------------------- | |
| - ISODateTimeFormat millisecond parsing broken | |
| Millisecond parsing would parse 12:00:00.4 as 4 milliseconds rather | |
| than 400 milliseconds | |
| - ISODateTimeFormat basic field parsing too lenient | |
| The basic parsers in ISODateTimeFormat were too lenient | |
| They have been changed to only accept the correct number of digits as | |
| per the ISO-8601 standard. The non basic parsers are unaffected | |
| - DateTimeFormat.forFields(List) method can't handle immutable [1877843] | |
| Fix so that the method does not throw an exception when an unmodifiable | |
| list is passed in | |
| - Fixed offset time zones calculated incorrect periods | |
| ZonedChronology.ZonedDuration.isPrecise() did not take into account | |
| the decorated isPrecise() value. This meant that date fields for fixed | |
| offset time zones were always considered precise. The result was periods | |
| containing months and years when they should not have done. | |
| - ZonedChronology (regression from 1.4) [1887104] | |
| Fix to roundFloor/roundCeiling | |
| Bug affected DST cutover in Autumn for time fields (not date fields) | |
| - Clarify Javadoc time zone formats | |
| Time zone formats were incorrectly documented as 'Z' instead of 'ZZ' | |
| Javadoc only change | |
| - Period formatting [2025928] | |
| Formatting option printZeroRarelyFirst() did not work unless years | |
| field was included. | |
| - DateTimeZone (regression from 1.4) [fix also available in v1.5.2] | |
| Fix getOffsetFromLocal DST gap adjustment | |
| Bug affected parsing of DST cutover in Autumn | |
| - Parsing (regression from 1.4) [1839440] [fix also available in v1.5.1] | |
| Support parsing all upper-case and all lower-case text | |
| - Javadoc clarity enhancements [fix also available in v1.5.1] | |
| - Constants in Years/Months/Weeks/Days/Hours/Minutes/Seconds etc. | |
| - Period/Interval Object constructors | |
| </source> | |
| </p> | |
| </section> | |
| </body> | |
| </document> |