public abstract class Chronology extends Object implements Calendrical
Calendar systems describe a set of fields that can be used to describe time in a human-scale. Typical fields include year, month-of-year and day-of-month.
This abstract base class provides a common mechanism to access the standard fields which are supported in the vast majority of calendar systems. Subclasses will provide the full set of fields for that calendar system.
The default chronology is ISO8601
which is the
de facto world calendar today.
Chronology is an abstract class and must be implemented with care to
ensure other classes in the framework operate correctly.
All instantiable subclasses must be final, immutable and thread-safe.
Wherever possible subclasses should be singletons with no public constructor.
It is recommended that subclasses implement Serializable
Modifier | Constructor and Description |
---|---|
protected |
Chronology()
Restrictive constructor.
|
Modifier and Type | Method and Description |
---|---|
<T> T |
get(CalendricalRule<T> rule)
Gets the value of the specified calendrical rule.
|
abstract String |
getName()
Gets the name of the chronology.
|
static CalendricalRule<Chronology> |
rule()
Gets the rule for
Chronology . |
String |
toString()
Returns a textual description of the chronology.
|
public abstract String getName()
The name should not have the suffix 'Chronology'.
For example, the name of ISOChronology
is 'ISO'.
public String toString()
public <T> T get(CalendricalRule<T> rule)
This method queries the value of the specified calendrical rule.
If the value cannot be returned for the rule from this offset then
null
will be returned.
get
in interface Calendrical
rule
- the rule to use, not nullpublic static CalendricalRule<Chronology> rule()
Chronology
.Copyright © 2014. All rights reserved.