ChronoLocalDate

ChronoLocalDate is an interface in the Java SE Date-Time API, defined in the java.time.chrono package. It represents a date in an arbitrary chronology, such as ISO-8601, Japanese, Hijrah, Thai Buddhist, or Minguo calendars. By abstracting the calendar system, ChronoLocalDate allows applications to work with dates across multiple calendar systems in a type-safe way, while preserving each calendar's rules for year, month, and day.

An instance of ChronoLocalDate pairs a specific Chronology with a date value. The chronology describes the calendar system and defines the valid ranges for fields like year, month, and day. ChronoLocalDate exposes a method to obtain its chronology and supports standard date-time operations through the Temporal API, including arithmetic and adjustments that respect the calendar's constraints. Comparisons between ChronoLocalDate values are defined within the same chronology.

In the Java time API, ChronoLocalDate is used in conjunction with other chrono types such as ChronoLocalDateTime and within a Chronology. Concrete date classes implement this interface for individual calendars, for example ISO-based dates, Japanese dates, Hijrah dates, etc. The interface enables interoperability with the rest of the java.time framework, including formatting and parsing facilities that can be calendar-aware.

ChronoLocalDate therefore provides a calendar-agnostic representation of a date that can be converted to other representations when supported by the selected chronology, and is central to multi-calendar support in Java applications.