1 2## ThreeTen backport project 3JSR-310 provides a new date and time library for Java SE 8. 4This project is the backport to Java SE 6 and 7. 5 6See the [main home page](https://www.threeten.org/threetenbp/) of the project. 7 8The backport is NOT an implementation of JSR-310, as that would require 9jumping through lots of unnecessary hoops. 10Instead, this is a simple backport intended to allow users to quickly 11use the JSR-310 API on Java SE 6 and 7. 12The backport should be referred to using the "ThreeTen" name. 13 14Active development on JSR-310 is at [OpenJDK](http://openjdk.java.net/): 15 16This GitHub repository is a fork of that originally used to create JSR-310. 17That repository used the same BSD-3-Clause license as this repository. 18 19Issues about the backport should be reported here at GitHub. 20Pull requests and issues will only be considered so far as matching the behaviour 21of the real Java SE 8. Additional requested features will be rejected. 22 23#### Building 24This project builds using maven. 25 26#### Time-zone data 27The time-zone database is stored as a pre-compiled dat file that is included in the built jar. 28The version of the time-zone data used is stored within the dat file (near the start). 29Updating the time-zone database involves using the `TzdbZoneRulesCompiler` class 30and re-compiling the jar file. 31An automated CI job should help keep the time-zone data up to date. 32 33#### FAQs 34 351. What version of Java SE 8 does this project map to? 36This project currently maps to the contents of release Java SE 8u20. 37 382. Will the backport be kept up to date? 39There are no plans for further releases. 40However if security issues or bugs are found, or pull requests received then a release may occur. 41 423. Is this project derived from OpenJDK? 43No. This project is derived from the Reference Implementation previously hosted on GitHub. 44That project had a BSD license, which has been preserved here. 45Thus, this project is a fork of the original code before entry to OpenJDK. 46 47### Releases 48Available in the [Maven Central repository](https://search.maven.org/search?q=g:org.threeten%20AND%20a:threetenbp&core=gav) 49 50 51 52 53### Support 54Please use [Stack Overflow](https://stackoverflow.com/questions/tagged/threetenbp) for general usage questions. 55GitHub [issues](https://github.com/ThreeTen/threetenbp/issues) and [pull requests](https://github.com/ThreeTen/threetenbp/pulls) 56should be used when you want to help advance the project. 57Commercial support is available via the 58[Tidelift subscription](https://tidelift.com/subscription/pkg/maven-org-threeten-threetenbp?utm_source=maven-org-threeten-threetenbp&utm_medium=referral&utm_campaign=readme). 59 60Note that pull requests and issues will only be considered so far as matching the behaviour of Java SE releases. 61Additional requested features will be rejected. 62 63Pull requests must _not_ be copied from the JDK, because the GPL license is incompatible with the BSD license used here. 64 65To report a security vulnerability, please use the [Tidelift security contact](https://tidelift.com/security). 66Tidelift will coordinate the fix and disclosure. 67 68 69### Release process 70 71* Update version (index.md, changes.xml - checking tzdb version) 72* Commit and push 73* Run `mvn clean release:clean release:prepare release:perform` on Java 11 74* Website will be built and released by GitHub Actions 75