time/chrono/Chronology.java

95  * The chronology operates behind the scenes to represent the general concept of a calendar system.
151  * Each chronology must define a chronology ID that is unique within the system.
152  * If the chronology represents a calendar system defined by the
168      * This obtains a chronology based on the specified temporal.
172      * The conversion will obtain the chronology using {@link TemporalQueries#chronology()}.
173      * If the specified temporal object does not have a chronology, {@link IsoChronology} is returned.
179      * @return the chronology, not null
184         Chronology obj = temporal.query(TemporalQueries.chronology());
235      * Obtains an instance of {@code Chronology} from a chronology ID or
238      * This returns a chronology based on either the ID or the type.
239      * The {@link #getId() chronology ID} uniquely identifies the chronology.
243      * The chronology may be a system chronology or a chronology
250      * @param id  the chronology ID or calendar system type, not null
251      * @return the chronology with the identifier requested, not null
252      * @throws DateTimeException if the chronology cannot be found
266      * @return the independent, modifiable set of the available chronology IDs, not null
274      * Gets the ID of the chronology.
279      * @return the chronology ID, not null
301      * Obtains a local date in this chronology from the era, year-of-era,
308      * @param era  the era of the correct type for the chronology, not null
309      * @param yearOfEra  the chronology year-of-era
310      * @param month  the chronology month-of-year
311      * @param dayOfMonth  the chronology day-of-month
312      * @return the local date in this chronology, not null
314      * @throws ClassCastException if the {@code era} is not of the correct type for the chronology
321      * Obtains a local date in this chronology from the proleptic-year,
324      * @param prolepticYear  the chronology proleptic-year
325      * @param month  the chronology month-of-year
326      * @param dayOfMonth  the chronology day-of-month
327      * @return the local date in this chronology, not null
333      * Obtains a local date in this chronology from the era, year-of-era and
340      * @param era  the era of the correct type for the chronology, not null
341      * @param yearOfEra  the chronology year-of-era
342      * @param dayOfYear  the chronology day-of-year
343      * @return the local date in this chronology, not null
345      * @throws ClassCastException if the {@code era} is not of the correct type for the chronology
352      * Obtains a local date in this chronology from the proleptic-year and
355      * @param prolepticYear  the chronology proleptic-year
356      * @param dayOfYear  the chronology day-of-year
357      * @return the local date in this chronology, not null
363      * Obtains a local date in this chronology from the epoch-day.
369      * @return the local date in this chronology, not null
376      * Obtains the current local date in this chronology from the system clock in the default time-zone.
395      * Obtains the current local date in this chronology from the system clock in the specified time-zone.
415      * Obtains the current local date in this chronology from the specified clock.
435      * Obtains a local date in this chronology from another temporal object.
437      * This obtains a date in this chronology based on the specified temporal.
448      * @return the local date in this chronology, not null
455      * Obtains a local date-time in this chronology from another temporal object.
457      * This obtains a date-time in this chronology based on the specified temporal.
465      * The result uses this chronology.
471      * @return the local date-time in this chronology, not null
484      * Obtains a {@code ChronoZonedDateTime} in this chronology from another temporal object.
486      * This obtains a zoned date-time in this chronology based on the specified temporal.
497      * The result uses this chronology.
503      * @return the zoned date-time in this chronology, not null
524      * Obtains a {@code ChronoZonedDateTime} in this chronology from an {@code Instant}.
542      * The exact meaning is determined by the chronology according to the following constraints.
545      * <li>a chronology that does not support the concept of a year must return false.
547      *     valid range of years for the chronology.
565      * If the chronology makes active use of eras, such as {@code JapaneseChronology}
569      * @param era  the era of the correct type for the chronology, not null
570      * @param yearOfEra  the chronology year-of-era
574      * @throws ClassCastException if the {@code era} is not of the correct type for the chronology
579      * Creates the chronology era object from the numeric value.
584      * The exact meaning is determined by the chronology according to the following constraints.
589      * Each chronology must refer to an enum or similar singleton to provide the era values.
600      * Gets the list of eras for the chronology.
606      * @return the list of eras for the chronology, may be immutable, not null
621      * This method will return a result whether or not the chronology supports the field.
631      * Gets the textual representation of this chronology.
633      * This returns the textual name used to identify the chronology,
639      * format the chronology textual name.
643      * @return the text value of the chronology, not null
658                 if (query == TemporalQueries.chronology()) {
673      * defines fields that only have meaning relative to the chronology.
675      * context of a specific chronology.
690      * Obtains a period for this chronology based on years, months and days.
692      * This returns a period tied to this chronology using the specified
714      * @return the period in terms of this chronology, not null
728      * @param prolepticYear the chronology proleptic-year
729      * @param month the chronology month-of-year
730      * @param dayOfMonth the chronology day-of-month
756      * @param era  the era of the correct type for the chronology, not null
757      * @param yearOfEra the chronology year-of-era
758      * @param month the chronology month-of-year
759      * @param dayOfMonth the chronology day-of-month
775      * Compares this chronology to another chronology.
777      * The comparison order first by the chronology ID string, then by any
781      * @param other  the other chronology to compare to, not null
788      * Checks if this chronology is equal to another chronology.
793      * @return true if this is equal to the other chronology
799      * A hash code for this chronology.
810      * Outputs this chronology as a {@code String}.
814      * @return a string representation of this chronology, not null