CopticChronology (ThreeTen-extra 0.8 API)

java.lang.Object
- java.time.chrono.AbstractChronology
- - org.threeten.extra.chrono.CopticChronology

All Implemented Interfaces:

Serializable, Comparable<java.time.chrono.Chronology>, java.time.chrono.Chronology
```
public final class CopticChronology
extends java.time.chrono.AbstractChronology
implements Serializable
```
The Coptic calendar system.
This chronology defines the rules of the Coptic calendar system. This calendar system is primarily used in Christian Egypt. Dates are aligned such that 0001-01-01 (Coptic) is 0284-08-29 (ISO).
The fields are defined as follows:
- era - There are two eras, the current 'Era of the Martyrs' (AM) and the previous era (BEFORE_AM).
- year-of-era - The year-of-era for the current era increases uniformly from the epoch at year one. For the previous era the year increases from one as time goes backwards.
- proleptic-year - The proleptic year is the same as the year-of-era for the current era. For the previous era, years have zero, then negative values.
- month-of-year - There are 13 months in a Coptic year, numbered from 1 to 13.
- day-of-month - There are 30 days in each of the first 12 Coptic months, numbered 1 to 30. The 13th month has 5 days, or 6 in a leap year, numbered 1 to 5 or 1 to 6.
- day-of-year - There are 365 days in a standard Coptic year and 366 in a leap year. The days are numbered from 1 to 365 or 1 to 366.
- leap-year - Leap years occur every 4 years.
Implementation Requirements:
This class is immutable and thread-safe.
See Also:

Serialized Form

Field Summary

Fields
Modifier and Type Field and Description

static CopticChronology INSTANCE
Singleton instance for the Coptic chronology.

Fields
Modifier and Type	Field and Description
`static CopticChronology`	`INSTANCE` Singleton instance for the Coptic chronology.

Constructor Summary

Constructors
Constructor and Description

CopticChronology()
Private constructor, that is public to satisfy the ServiceLoader.

Constructors
Constructor and Description
`CopticChronology()` Private constructor, that is public to satisfy the `ServiceLoader`.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`CopticDate`	`date(java.time.chrono.Era era, int yearOfEra, int month, int dayOfMonth)` Obtains a local date in Coptic calendar system from the era, year-of-era, month-of-year and day-of-month fields.
`CopticDate`	`date(int prolepticYear, int month, int dayOfMonth)` Obtains a local date in Coptic calendar system from the proleptic-year, month-of-year and day-of-month fields.
`CopticDate`	`date(java.time.temporal.TemporalAccessor temporal)`
`CopticDate`	`dateEpochDay(long epochDay)` Obtains a local date in the Coptic calendar system from the epoch-day.
`CopticDate`	`dateNow()`
`CopticDate`	`dateNow(java.time.Clock clock)`
`CopticDate`	`dateNow(java.time.ZoneId zone)`
`CopticDate`	`dateYearDay(java.time.chrono.Era era, int yearOfEra, int dayOfYear)` Obtains a local date in Coptic calendar system from the era, year-of-era and day-of-year fields.
`CopticDate`	`dateYearDay(int prolepticYear, int dayOfYear)` Obtains a local date in Coptic calendar system from the proleptic-year and day-of-year fields.
`CopticEra`	`eraOf(int eraValue)`
`List<java.time.chrono.Era>`	`eras()`
`String`	`getCalendarType()` Gets the calendar type of the underlying calendar system - 'coptic'.
`String`	`getId()` Gets the ID of the chronology - 'Coptic'.
`boolean`	`isLeapYear(long prolepticYear)` Checks if the specified year is a leap year.
`java.time.chrono.ChronoLocalDateTime<CopticDate>`	`localDateTime(java.time.temporal.TemporalAccessor temporal)`
`int`	`prolepticYear(java.time.chrono.Era era, int yearOfEra)`
`java.time.temporal.ValueRange`	`range(java.time.temporal.ChronoField field)`
`CopticDate`	`resolveDate(Map<java.time.temporal.TemporalField,Long> fieldValues, java.time.format.ResolverStyle resolverStyle)`
`java.time.chrono.ChronoZonedDateTime<CopticDate>`	`zonedDateTime(java.time.Instant instant, java.time.ZoneId zone)`
`java.time.chrono.ChronoZonedDateTime<CopticDate>`	`zonedDateTime(java.time.temporal.TemporalAccessor temporal)`

Methods inherited from class java.time.chrono.AbstractChronology
compareTo, equals, hashCode, toString

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.time.chrono.Chronology
from, getDisplayName, period

- Field Detail
  - INSTANCE
```
public static final CopticChronology INSTANCE
```
    Singleton instance for the Coptic chronology.
- Constructor Detail
  - CopticChronology
```
public CopticChronology()
```
    Private constructor, that is public to satisfy the ServiceLoader. Use the singleton INSTANCE instead.
- Method Detail
  - getId
```
public String getId()
```
    Gets the ID of the chronology - 'Coptic'.
    The ID uniquely identifies the Chronology. It can be used to lookup the Chronology using AbstractChronology.of(String).
    
    Specified by:
    
    getId in interface java.time.chrono.Chronology
    
    Returns:
    
    the chronology ID - 'Coptic'
    
    See Also:
    
    getCalendarType()
  - getCalendarType
```
public String getCalendarType()
```
    Gets the calendar type of the underlying calendar system - 'coptic'.
    The calendar type is an identifier defined by the Unicode Locale Data Markup Language (LDML) specification. It can be used to lookup the Chronology using AbstractChronology.of(String). It can also be used as part of a locale, accessible via Locale.getUnicodeLocaleType(String) with the key 'ca'.
    
    Specified by:
    
    getCalendarType in interface java.time.chrono.Chronology
    
    Returns:
    
    the calendar system type - 'coptic'
    
    See Also:
    
    getId()
  - date
```
public CopticDate date(java.time.chrono.Era era,
                       int yearOfEra,
                       int month,
                       int dayOfMonth)
```
    Obtains a local date in Coptic calendar system from the era, year-of-era, month-of-year and day-of-month fields.
    
    Specified by:
    
    date in interface java.time.chrono.Chronology
    
    Parameters:
    
    era - the Coptic era, not null
    
    yearOfEra - the year-of-era
    
    month - the month-of-year
    
    dayOfMonth - the day-of-month
    
    Returns:
    
    the Coptic local date, not null
    
    Throws:
    
    java.time.DateTimeException - if unable to create the date
    
    ClassCastException - if the era is not a CopticEra
  - date
```
public CopticDate date(int prolepticYear,
                       int month,
                       int dayOfMonth)
```
    Obtains a local date in Coptic calendar system from the proleptic-year, month-of-year and day-of-month fields.
    
    Specified by:
    
    date in interface java.time.chrono.Chronology
    
    Parameters:
    
    prolepticYear - the proleptic-year
    
    month - the month-of-year
    
    dayOfMonth - the day-of-month
    
    Returns:
    
    the Coptic local date, not null
    
    Throws:
    
    java.time.DateTimeException - if unable to create the date
  - dateYearDay
```
public CopticDate dateYearDay(java.time.chrono.Era era,
                              int yearOfEra,
                              int dayOfYear)
```
    Obtains a local date in Coptic calendar system from the era, year-of-era and day-of-year fields.
    
    Specified by:
    
    dateYearDay in interface java.time.chrono.Chronology
    
    Parameters:
    
    era - the Coptic era, not null
    
    yearOfEra - the year-of-era
    
    dayOfYear - the day-of-year
    
    Returns:
    
    the Coptic local date, not null
    
    Throws:
    
    java.time.DateTimeException - if unable to create the date
    
    ClassCastException - if the era is not a CopticEra
  - dateYearDay
```
public CopticDate dateYearDay(int prolepticYear,
                              int dayOfYear)
```
    Obtains a local date in Coptic calendar system from the proleptic-year and day-of-year fields.
    
    Specified by:
    
    dateYearDay in interface java.time.chrono.Chronology
    
    Parameters:
    
    prolepticYear - the proleptic-year
    
    dayOfYear - the day-of-year
    
    Returns:
    
    the Coptic local date, not null
    
    Throws:
    
    java.time.DateTimeException - if unable to create the date
  - dateEpochDay
```
public CopticDate dateEpochDay(long epochDay)
```
    Obtains a local date in the Coptic calendar system from the epoch-day.
    
    Specified by:
    
    dateEpochDay in interface java.time.chrono.Chronology
    
    Parameters:
    
    epochDay - the epoch day
    
    Returns:
    
    the Coptic local date, not null
    
    Throws:
    
    java.time.DateTimeException - if unable to create the date
  - dateNow
```
public CopticDate dateNow()
```
    Specified by:
    
    dateNow in interface java.time.chrono.Chronology
  - dateNow
```
public CopticDate dateNow(java.time.ZoneId zone)
```
    Specified by:
    
    dateNow in interface java.time.chrono.Chronology
  - dateNow
```
public CopticDate dateNow(java.time.Clock clock)
```
    Specified by:
    
    dateNow in interface java.time.chrono.Chronology
  - date
```
public CopticDate date(java.time.temporal.TemporalAccessor temporal)
```
    Specified by:
    
    date in interface java.time.chrono.Chronology
  - localDateTime
```
public java.time.chrono.ChronoLocalDateTime<CopticDate> localDateTime(java.time.temporal.TemporalAccessor temporal)
```
    Specified by:
    
    localDateTime in interface java.time.chrono.Chronology
  - zonedDateTime
```
public java.time.chrono.ChronoZonedDateTime<CopticDate> zonedDateTime(java.time.temporal.TemporalAccessor temporal)
```
    Specified by:
    
    zonedDateTime in interface java.time.chrono.Chronology
  - zonedDateTime
```
public java.time.chrono.ChronoZonedDateTime<CopticDate> zonedDateTime(java.time.Instant instant,
                                                                      java.time.ZoneId zone)
```
    Specified by:
    
    zonedDateTime in interface java.time.chrono.Chronology
  - isLeapYear
```
public boolean isLeapYear(long prolepticYear)
```
    Checks if the specified year is a leap year.
    A Coptic proleptic-year is leap if the remainder after division by four equals three. This method does not validate the year passed in, and only has a well-defined result for years in the supported range.
    
    Specified by:
    
    isLeapYear in interface java.time.chrono.Chronology
    
    Parameters:
    
    prolepticYear - the proleptic-year to check, not validated for range
    
    Returns:
    
    true if the year is a leap year
  - prolepticYear
```
public int prolepticYear(java.time.chrono.Era era,
                         int yearOfEra)
```
    Specified by:
    
    prolepticYear in interface java.time.chrono.Chronology
  - eraOf
```
public CopticEra eraOf(int eraValue)
```
    Specified by:
    
    eraOf in interface java.time.chrono.Chronology
  - eras
```
public List<java.time.chrono.Era> eras()
```
    Specified by:
    
    eras in interface java.time.chrono.Chronology
  - range
```
public java.time.temporal.ValueRange range(java.time.temporal.ChronoField field)
```
    Specified by:
    
    range in interface java.time.chrono.Chronology
  - resolveDate
```
public CopticDate resolveDate(Map<java.time.temporal.TemporalField,Long> fieldValues,
                              java.time.format.ResolverStyle resolverStyle)
```
    Specified by:
    
    resolveDate in interface java.time.chrono.Chronology
    
    Overrides:
    
    resolveDate in class java.time.chrono.AbstractChronology

Class CopticChronology

Implementation Requirements:

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.time.chrono.AbstractChronology

Methods inherited from class java.lang.Object

Methods inherited from interface java.time.chrono.Chronology

Field Detail

INSTANCE

Constructor Detail

CopticChronology

Method Detail

getId

getCalendarType

date

date

dateYearDay

dateYearDay

dateEpochDay

dateNow

dateNow

dateNow

date

localDateTime

zonedDateTime

zonedDateTime

isLeapYear

prolepticYear

eraOf

eras

range

resolveDate