This Specification is the JSR 310 Date and Time API Final Release.
See: Description
| Package | Description |
|---|---|
| java.time |
The main API for dates, times, instants, and durations.
|
| java.time.chrono |
Generic API for calendar systems other than the default ISO.
|
| java.time.format |
Provides classes to print and parse dates and times.
|
| java.time.temporal |
Access to date and time using fields and units, and date time adjusters.
|
| java.time.zone |
Support for time-zones and their rules.
|
This Specification is the JSR 310 Date and Time API Final Release.
JSR 310 Date and Time API process describes the JCP stages and status of the work.
A guide to the design of the Date and Time API is available separately from the JSR 310 download page.
The implementation of the Date and Time API is included in Java™ 8.
Additional information related to JSR 310 can be found at the Threeten Project on GitHub.
Feedback and comments on this specification should be sent to threeten-develop@lists.sourceforge.net.
The specification is entirely defined by the contents of the following five packages, each with a primary function:
java.time contains the main API based on the ISO-8601 standard.
The classes defined here represent the principal date-time concepts,
including instants, durations, dates, times, time-zones and periods.
They are based on the ISO calendar system, which is the de facto world
calendar following the proleptic Gregorian rules.
All the classes are immutable and thread-safe.
java.time.temporal contains the API for accessing the fields and units
of date-time. Units are measurable, such as years, months and hours.
For example, the expression "2 hours later" uses the hours unit.
By contrast, fields are mini-calculations, defining a value.
For example, month-of-year, day-of-week and hour-of-day are all fields.
The set of supported units and fields can be extended by applications if desired.
java.time.format contains the API to print and parse fields into date-time
objects and to customize parsing and printing.
Formatters can be created in a variety of ways, including constants, patterns,
localized styles and a builder.
Formatters are immutable and thread-safe.
java.time.zone contains the API to handle time-zones.
Detailed information is made available about the rules of each time-zone.
The java.time.chrono package contains the calendar neutral API.
This is intended for use by applications that need to use localized calendars.
Support is provided for the Hijrah, Japanese, Minguo, and ThaiBuddhist calendars.
Copyright (c) 2014, Oracle and/or its affiliates. All Rights Reserved. Use of this specification is subject to license terms.