threetenbp

ThreeTen backport project

JSR-310 provides a new date and time library for Java SE 8. This project is the backport to Java SE 6 and 7.

See the main home page of the project.

The backport is NOT an implementation of JSR-310, as that would require jumping through lots of unnecessary hoops. Instead, this is a simple backport intended to allow users to quickly use the JSR-310 API on Java SE 6 and 7. The backport should be referred to using the "ThreeTen" name.

Active development on JSR-310 is at OpenJDK:

This GitHub repository is a fork of that originally used to create JSR-310. That repository used the same BSD-3-Clause license as this repository.

Issues about the backport should be reported here at GitHub. Pull requests and issues will only be considered so far as matching the behaviour of the real Java SE 8. Additional requested features will be rejected.

Building

This project builds using maven.

Time-zone data

The time-zone database is stored as a pre-compiled dat file that is included in the built jar. The version of the time-zone data used is stored within the dat file (near the start). Updating the time-zone database involves using the TzdbZoneRulesCompiler class and re-compiling the jar file. An automated CI job should help keep the time-zone data up to date.

FAQs

1. What version of Java SE 8 does this project map to? This project currently maps to the contents of release Java SE 8u20.

2. Will the backport be kept up to date? There are no plans for further releases. However if security issues or bugs are found, or pull requests received then a release may occur.

3. Is this project derived from OpenJDK? No. This project is derived from the Reference Implementation previously hosted on GitHub. That project had a BSD license, which has been preserved here. Thus, this project is a fork of the original code before entry to OpenJDK.

Releases

Available in the Maven Central repository

Support

Please use Stack Overflow for general usage questions. GitHub issues and pull requests should be used when you want to help advance the project. Commercial support is available via the Tidelift subscription.

Note that pull requests and issues will only be considered so far as matching the behaviour of Java SE releases. Additional requested features will be rejected.

Pull requests must not be copied from the JDK, because the GPL license is incompatible with the BSD license used here.

To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure.

Release process

• Update version (index.md, changes.xml - checking tzdb version)
• Commit and push
• git push origin HEAD:refs/tags/release
• Code and Website will be built and released by GitHub Actions

Release from local:

• Ensure gpg-agent is running
• mvn clean release:clean release:prepare release:perform