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