xref: /aosp_15_r20/external/threetenbp/src/site/markdown/index.md (revision 761b3f507e07ae42b4ad4333aa5dc559de53e1fb)
1*761b3f50SCole Faust## <i></i> About
2*761b3f50SCole Faust
3*761b3f50SCole Faust**ThreeTen-Backport** provides a backport of the
4*761b3f50SCole Faust[Java SE 8](https://docs.oracle.com/javase/8/docs/api/java/time/package-summary.html) date-time classes to Java SE 6 and 7.
5*761b3f50SCole Faust
6*761b3f50SCole FaustThe backport is NOT an implementation of JSR-310, as that would require
7*761b3f50SCole Faustjumping through lots of unnecessary hoops.
8*761b3f50SCole FaustInstead, this is a simple backport intended to allow users to quickly
9*761b3f50SCole Faustuse the JSR-310 API on Java SE 6 and 7.
10*761b3f50SCole FaustThe backport should be referred to using the "ThreeTen" name.
11*761b3f50SCole FaustThe backport is curated by the primary author of the Java 8 date and time library, [Stephen Colebourne](https://www.joda.org/).
12*761b3f50SCole Faust
13*761b3f50SCole FaustThreeTen-Backport is licensed under the business-friendly [BSD-3-Clause license](license.html).
14*761b3f50SCole Faust
15*761b3f50SCole Faust
16*761b3f50SCole Faust## <i></i> Features
17*761b3f50SCole Faust
18*761b3f50SCole FaustThe features of the backport match those of Java SE 8:
19*761b3f50SCole Faust
20*761b3f50SCole Faust* Date and time value types
21*761b3f50SCole Faust* Formatting
22*761b3f50SCole Faust* Alternate calendar systems
23*761b3f50SCole Faust* Utilities
24*761b3f50SCole Faust
25*761b3f50SCole FaustThe API of ThreeTen-Extra matches that of Java SE 8 as far as practicable.
26*761b3f50SCole FaustDefault and static methods on interfaces are simulated in the backport
27*761b3f50SCole Faustby using an abstract class rather than an interface.
28*761b3f50SCole FaustIn addition, static query constants are used to simulate method references, for example
29*761b3f50SCole Faustuse <code>LocalDate.FROM</code> rather than <code>LocalDate::from</code>.
30*761b3f50SCole Faust
31*761b3f50SCole Faust
32*761b3f50SCole Faust## <i></i> Documentation
33*761b3f50SCole Faust
34*761b3f50SCole FaustVarious documentation is available:
35*761b3f50SCole Faust
36*761b3f50SCole Faust* The [Javadoc](apidocs/index.html)
37*761b3f50SCole Faust* The [change notes](changes-report.html) for each release
38*761b3f50SCole Faust* The [GitHub](https://github.com/ThreeTen/threetenbp) source repository
39*761b3f50SCole Faust* The mechanism to [update](update-tzdb.html) the time-zone information
40*761b3f50SCole Faust
41*761b3f50SCole Faust---
42*761b3f50SCole Faust
43*761b3f50SCole Faust## <i></i> Releases
44*761b3f50SCole Faust
45*761b3f50SCole FaustRelease 1.6.8 is the latest release.
46*761b3f50SCole FaustIt is considered to be stable and usable in production.
47*761b3f50SCole Faust
48*761b3f50SCole FaustThe project runs on Java SE 6 (or later) and has no [dependencies](dependencies.html).
49*761b3f50SCole Faust
50*761b3f50SCole FaustThere are some known issues.
51*761b3f50SCole FaustThe Hijrah calendar system does not work.
52*761b3f50SCole FaustFormatting and parsing often depends on data only available in Java SE 8.
53*761b3f50SCole FaustZone id and text parsing is significantly less powerful.
54*761b3f50SCole Faust
55*761b3f50SCole FaustAvailable in [Maven Central](https://search.maven.org/search?q=g:org.threeten%20AND%20a:threetenbp&core=gav).
56*761b3f50SCole Faust
57*761b3f50SCole Faust```xml
58*761b3f50SCole Faust<dependency>
59*761b3f50SCole Faust  <groupId>org.threeten</groupId>
60*761b3f50SCole Faust  <artifactId>threetenbp</artifactId>
61*761b3f50SCole Faust  <version>1.6.8</version>
62*761b3f50SCole Faust</dependency>
63*761b3f50SCole Faust```
64*761b3f50SCole Faust
65*761b3f50SCole Faust---
66*761b3f50SCole Faust
67*761b3f50SCole Faust### Support
68*761b3f50SCole Faust
69*761b3f50SCole FaustPlease use [Stack Overflow](https://stackoverflow.com/questions/tagged/threetenbp) for general usage questions.
70*761b3f50SCole FaustGitHub [issues](https://github.com/ThreeTen/threetenbp/issues) and [pull requests](https://github.com/ThreeTen/threetenbp/pulls)
71*761b3f50SCole Faustshould be used when you want to help advance the project.
72*761b3f50SCole FaustCommercial support is available via the
73*761b3f50SCole Faust[Tidelift subscription](https://tidelift.com/subscription/pkg/maven-org-threeten-threetenbp?utm_source=maven-org-threeten-threetenbp&utm_medium=referral&utm_campaign=website).
74*761b3f50SCole Faust
75*761b3f50SCole FaustNote that pull requests and issues will only be considered so far as matching the behaviour of Java SE releases.
76*761b3f50SCole FaustAdditional requested features will be rejected.
77*761b3f50SCole Faust
78*761b3f50SCole FaustTo report a security vulnerability, please use the [Tidelift security contact](https://tidelift.com/security).
79*761b3f50SCole FaustTidelift will coordinate the fix and disclosure.
80