Skip to content

Commit

Permalink
Release 2.8
Browse files Browse the repository at this point in the history
  • Loading branch information
jodastephen committed May 29, 2015
1 parent a3b1a16 commit eeeaa09
Show file tree
Hide file tree
Showing 6 changed files with 206 additions and 16 deletions.
4 changes: 2 additions & 2 deletions README.md
Expand Up @@ -46,11 +46,11 @@ Various documentation is available:


### Releases
[Release 2.7](http://www.joda.org/joda-time/download.html) is the current latest release.
[Release 2.8](http://www.joda.org/joda-time/download.html) is the current latest release.
This release is considered stable and worthy of the 1.x tag.
It depends on JDK 1.5 or later.

Available in the [Maven Central repository](http://search.maven.org/#artifactdetails|joda-time|joda-time|2.7|jar)
Available in the [Maven Central repository](http://search.maven.org/#artifactdetails|joda-time|joda-time|2.8|jar)


### Related projects
Expand Down
2 changes: 1 addition & 1 deletion pom.xml
Expand Up @@ -9,7 +9,7 @@
<artifactId>joda-time</artifactId>
<packaging>jar</packaging>
<name>Joda-Time</name>
<version>2.8-SNAPSHOT</version>
<version>2.8</version>
<description>Date and time library to replace JDK date handling</description>
<url>http://www.joda.org/joda-time/</url>

Expand Down
20 changes: 10 additions & 10 deletions src/conf/MANIFEST.MF
Expand Up @@ -2,22 +2,22 @@ Package: org.joda.time
Extension-Name: joda-time
Specification-Title: Joda-Time
Specification-Vendor: Joda.org
Specification-Version: 2.7
Specification-Version: 2.8
Implementation-Vendor: Joda.org
Implementation-Title: org.joda.time
Implementation-Version: 2.7
Implementation-Version: 2.8
Implementation-Vendor-Id: org.joda
Bundle-ManifestVersion: 2
Bundle-Vendor: Joda.org
Bundle-Name: Joda-Time
Bundle-SymbolicName: joda-time
Bundle-Version: 2.7
Export-Package: org.joda.time;version=2.7,
org.joda.time.base;version=2.7,
org.joda.time.chrono;version=2.7,
org.joda.time.convert;version=2.7,
org.joda.time.field;version=2.7,
org.joda.time.format;version=2.7,
org.joda.time.tz;version=2.7
Bundle-Version: 2.8
Export-Package: org.joda.time;version=2.8,
org.joda.time.base;version=2.8,
org.joda.time.chrono;version=2.8,
org.joda.time.convert;version=2.8,
org.joda.time.field;version=2.8,
org.joda.time.format;version=2.8,
org.joda.time.tz;version=2.8
Bundle-License: Apache 2.0
Bundle-DocURL: http://www.joda.org/joda-time/
6 changes: 3 additions & 3 deletions src/site/markdown/index.md
Expand Up @@ -125,21 +125,21 @@ Joda-Time is licenced under the business friendly <a href="license.html">Apache

## <i></i> Releases

[Release 2.7](download.html) is the current latest release.
[Release 2.8](download.html) is the current latest release.
This release is considered stable and worthy of the 2.x tag.
See the [upgrade notes](upgradeto270.html) for full details.

Joda-Time requires Java SE 5 or later and has [no dependencies](dependencies.html).
There is a *compile-time* dependency on [Joda-Convert](http://www.joda.org/joda-convert/),
but this is not required at runtime thanks to the magic of annotations.

Available in [Maven Central](http://search.maven.org/#artifactdetails%7Cjoda-time%7Cjoda-time%7C2.7%7Cjar).
Available in [Maven Central](http://search.maven.org/#artifactdetails%7Cjoda-time%7Cjoda-time%7C2.8%7Cjar).

```xml
<dependency>
<groupId>joda-time</groupId>
<artifactId>joda-time</artifactId>
<version>2.7</version>
<version>2.8</version>
</dependency>
```

Expand Down
1 change: 1 addition & 0 deletions src/site/xdoc/installation.xml
Expand Up @@ -22,6 +22,7 @@ of the source code suitable for linking to the jar file in IDEs such as Eclipse.
<p>
The release notes for upgraders can be found here:
<ul>
<li><a href="upgradeto280.html">Version 2.8</a> - upgrade from Version 2.7</li>
<li><a href="upgradeto270.html">Version 2.7</a> - upgrade from Version 2.6</li>
<li><a href="upgradeto260.html">Version 2.6</a> - upgrade from Version 2.5</li>
<li><a href="upgradeto250.html">Version 2.5</a> - upgrade from Version 2.4</li>
Expand Down
189 changes: 189 additions & 0 deletions src/site/xdoc/upgradeto280.xml
@@ -0,0 +1,189 @@
<?xml version="1.0" encoding="ISO-8859-1"?>

<document>
<properties>
<title>Java date and time API - Upgrade from 2.7 to 2.8</title>
<author>Stephen Colebourne</author>
</properties>

<body>

<section name="Upgrade">
<p>
These are the release notes and advice for upgrading Joda-Time from version 2.7 to version 2.8.
<source>
Joda-Time version 2.8
---------------------

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

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.
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 2.7
----------------------
- Encode properties files using unicode escapes [#228]
The properties files are supposed to be loaded using ISO 8859-1 but Android seems to have issues with that.
Re-encode the files using unicode escapes to sidestep the issue.

- Avoid ProGuard errors in Android jar [#246]
Separate logging from time-zone compilation


Compatibility with 2.7
----------------------
Build system - Yes

Binary compatible - Yes

Source compatible - Yes

Serialization compatible - Yes

Data compatible - Yes
- DateTimeZone data updated to version 2015d
- In the past year, the IANA time-zone database maintainer has changed unique time-zone data for many parts
of the world into shared "links". For example, in IANA 'Asia/Kuwait' now links to 'Asia/Riyadh'.
(I personally disagree with the IANA time-zone database maintainer's actions but my objections were ignored).
This was a problem for Joda-Time as we interpreted the concept of links (many years ago) as only being used
for backwards compatibility. Links are exposed in Joda-Time, because if you request a time-zone for a linked
identifier you get the target of the link back. As such, in recent versions of Joda-Time, it was not possible
to obtain a DateTimeZone with an appropriate identifier for many parts of the world, such as 'Asia/Kuwait'.
With this release, most links in the main IANA files are now restored to be real zones.
As a side effect of this, some identifiers that used to act as links are now real zones.
In summary, in the last Joda-Time release, requesting 'Asia/Kuwait' would have given back 'Asia/Riyadh',
but it now returns 'Asia/Kuwait' (where 'Asia/Kuwait' and 'Asia/Riyadh' have the same time-zone rules).
In most cases, this won't have any impact on your application.
Zones affected (now real zones rather than incorrect links):
* Africa/Bamako
* Africa/Banjul
* Africa/Conakry
* Africa/Dakar
* Africa/Freetown
* Africa/Lome
* Africa/Nouakchott
* Africa/Ouagadougou
* Africa/Sao_Tome
* Atlantic/St_Helena
* Africa/Addis_Ababa
* Africa/Asmara
* Africa/Dar_es_Salaam
* Africa/Djibouti
* Africa/Kampala
* Africa/Mogadishu
* Indian/Antananarivo
* Indian/Comoro
* Indian/Mayotte
* Africa/Blantyre
* Africa/Bujumbura
* Africa/Gaborone
* Africa/Harare
* Africa/Kigali
* Africa/Lubumbashi
* Africa/Lusaka
* Africa/Bangui
* Africa/Brazzaville
* Africa/Douala
* Africa/Kinshasa
* Africa/Libreville
* Africa/Luanda
* Africa/Malabo
* Africa/Niamey
* Africa/Porto-Novo
* Africa/Maseru
* Africa/Mbabane
* Africa/Juba
* Europe/Nicosia
* Asia/Bahrain
* Asia/Aden
* Asia/Kuwait
* Asia/Phnom_Penh
* Asia/Vientiane
* Asia/Muscat
* Antarctica/McMurdo
* Europe/Jersey
* Europe/Guernsey
* Europe/Isle_of_Man
* Europe/Mariehamn
* Europe/Busingen
* Europe/Vatican
* Europe/San_Marino
* Europe/Vaduz
* Arctic/Longyearbyen
* Europe/Ljubljana
* Europe/Podgorica
* Europe/Sarajevo
* Europe/Skopje
* Europe/Zagreb
* Europe/Bratislava
* Asia/Istanbul
* Pacific/Johnston
* America/Aruba
* America/Lower_Princes
* America/Kralendijk
* America/Anguilla
* America/Dominica
* America/Grenada
* America/Guadeloupe
* America/Marigot
* America/Montserrat
* America/St_Barthelemy
* America/St_Kitts
* America/St_Lucia
* America/St_Thomas
* America/St_Vincent
* America/Tortola

The change made should mean that further damage by the IANA time-zone database maintainer
will be less noticeable.

Semantic compatible - Yes


Deprecations since 2.7
----------------------


Bug fixes since 2.7
-------------------
- Fix MonthDay.plusDays() [#227]
The algorithm was incorrect when adding enough days to cause the month to change twice.

- Fix DateTime.withDate() DateTime.withTime() [#233]
The algorithm incorrectly changed the hour of day when certain DST dates were hit.
The new algorithm avoids an IllegalInstantException when moving to a DST gap.

- Fix Period.parse() [#238]
Negative periods of a fraction of a second were not parsed correctly.

- Format Etc/GMT time-zone using GMT data [#244]
This change will provide better text formats for pattern letter 'z'.

- Fix Property.toInterval() [#262]
The conversion of a field property to an interval did not take the chronology into account.
Thus, dateTime.hourOfDay().toInterval() previously resulted in an interval in the default
chronology, rather than the chronology of the dateTime.
The chronology is now passed to the interval.


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.
</source>
</p>
</section>

</body>
</document>

0 comments on commit eeeaa09

Please sign in to comment.