<?xml version="1.0" encoding="ISO-8859-1"?>

<document>
 <properties>
  <title>Java date and time API - Upgrade from 1.3 to 1.4</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.3 to version 1.4.
<source>
Joda-Time version 1.4
---------------------

Joda-Time is a date and time handling library that seeks to replace the JDK
Date and Calendar classes.

This is the fifth full release of Joda-Time.
This release focuses on new features, but also include some bug fixes.

We recommend JDK 1.3 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 *


Enhancements since 1.3
----------------------
- Years/Months/Weeks/Days/Hours/Minutes/Seconds
  New group of single field period classes
  These allow applications to specify a specific field in method signatures and calculations
  Methods are provided to convert between most of these based on standard length periods

- Period.ZERO
  Add zero-length constant to Period

- PeriodFormatBuilder.append(PeriodPrinter,PeriodParser)
  This method completes the API of PeriodFormatBuilder in the style of DateTimeFormatBuilder


Compatibility with 1.3
----------------------
Binary compatible - Yes

Source compatible - Yes, except
  If you subclassed AbstractReadableInstantFieldProperty (unlikely) then
  you now need to override getChronology() to re-enable the equals() and
  hashCode() methods.

Serialization compatible - Yes

Data compatible - Yes
  - DateTimeZone data updated to version 2006o

Semantic compatible - Yes


Deprecations since 1.3
----------------------


Bug fixes since 1.3
-------------------
- GJChronology
  Text value of ReadablePartial fields was always a decimal number.

- Comparisons of Chronology instances by identity  [1576727]
  Some comparisons of Chronology instances were performed using ==
  This worked fine in most cases due to agressive caching, however it failed when
  using LenientChronology and other wrapping chronologies which do not have caching
  Comparison is now via equals(), and involved adding equals() methods to a number
  of classes. In addition, subclasses of AbstractReadableInstantFieldProperty must
  now implement getChronology().
</source>
</p>
</section>

</body>
</document>
