Chronology
Related Docs:
trait Chronology
| package chrono
Obtains an instance of Chronology from a temporal object.
Obtains an instance of Chronology from a temporal object.
A TemporalAccessor represents some form of date and time information.
This factory converts the arbitrary temporal object to an instance of Chronology.
If the specified temporal object does not have a chronology, IsoChronology is returned.
The conversion will obtain the chronology using TemporalQueries#chronology().
This method matches the signature of the functional interface TemporalQuery
allowing it to be used in queries via method reference, Chrono::from.
the temporal to convert, not null
the chronology, not null
DateTimeException if unable to convert to an { @code Chronology}
Returns the available chronologies.
Returns the available chronologies.
Each returned Chronology is available for use in the system.
the independent, modifiable set of the available chronology IDs, not null
Obtains an instance of Chronology from a chronology ID or
calendar system type.
Obtains an instance of Chronology from a chronology ID or
calendar system type.
This returns a chronology based on either the ID or the type.
The chronology ID uniquely identifies the chronology.
The calendar system type is defined by the LDML specification.
The chronology may be a system chronology or a chronology provided by the application via ServiceLoader configuration.
Since some calendars can be customized, the ID or type typically refers to the default customization. For example, the Gregorian calendar can have multiple cutover dates from the Julian, but the lookup only provides the default cutover date.
the chronology ID or calendar system type, not null
the chronology with the identifier requested, not null
DateTimeException if the chronology cannot be found
Obtains an instance of Chronology from a locale.
Obtains an instance of Chronology from a locale.
This returns a Chronology based on the specified locale,
typically returning IsoChronology. Other calendar systems
are only returned if they are explicitly selected within the locale.
The Locale class provide access to a range of information useful
for localizing an application. This includes the language and region,
such as "en-GB" for English as used in Great Britain.
The Locale class also supports an extension mechanism that
can be used to identify a calendar system. The mechanism is a form
of key-value pairs, where the calendar system has the key "ca".
For example, the locale "en-JP-u-ca-japanese" represents the English
language as used in Japan with the Japanese calendar system.
This method finds the desired calendar system by in a manner equivalent
to passing "ca" to Locale#getUnicodeLocaleType(String).
If the "ca" key is not present, then IsoChronology is returned.
Note that the behavior of this method differs from the older
java.util.Calendar#getInstance(Locale) method.
If that method receives a locale of "th_TH" it will return BuddhistCalendar.
By contrast, this method will return IsoChronology.
Passing the locale "th-TH-u-ca-buddhist" into either method will
result in the Thai Buddhist calendar system and is therefore the
recommended approach going forward for Thai calendar system localization.
A similar, but simpler, situation occurs for the Japanese calendar system.
The locale "jp_JP_JP" has previously been used to access the calendar.
However, unlike the Thai locale, "ja_JP_JP" is automatically converted by
Locale to the modern and recommended form of "ja-JP-u-ca-japanese".
Thus, there is no difference in behavior between this method and
Calendar#getInstance(Locale).
the locale to use to obtain the calendar system, not null
the calendar system associated with the locale, not null
DateTimeException if the locale-specified calendar cannot be found