EthiopianCalendar (time4j-android 3.28-2016j API)

java.lang.Object
- net.time4j.engine.ChronoEntity<T>
- - net.time4j.engine.TimePoint<U,D>
  - - net.time4j.engine.Calendrical<EthiopianCalendar.Unit,EthiopianCalendar>
    - - net.time4j.calendar.EthiopianCalendar

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<EthiopianCalendar>, CalendarDate, ChronoDisplay, Temporal<CalendarDate>, LocalizedPatternSupport
```
@CalendarType(value="ethiopic")
public final class EthiopianCalendar
extends Calendrical<EthiopianCalendar.Unit,EthiopianCalendar>
implements LocalizedPatternSupport
```
Represents the calendar used in Ethiopia.

It is built on the base of the Coptic calendar but uses two different eras. Another difference to Coptic calendar is the day starting in the morning at 06:00 (usual approximation for sunrise). For more details see Intro to the Ethiopic Calendar.

Following elements which are declared as constants are registered by this class:
Furthermore, all elements defined in EpochDays and CommonElements are supported.

Example of usage:
```
     // printing to English
     ChronoFormatter<EthiopianCalendar> formatter =
       ChronoFormatter.setUp(EthiopianCalendar.axis(), Locale.ENGLISH)
       .addPattern("EEE, d. MMMM yyyy", PatternType.NON_ISO_DATE).build();
     PlainDate today = SystemClock.inLocalView().today();
     EthiopianCalendar ethiopianDate = today.transform(EthiopianCalendar.class); // conversion at noon
     System.out.println(formatter.format(ethiopianDate));
 
```
Since:

3.11/4.8

See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class EthiopianCalendar.Unit
Defines come calendar units for the Ethiopian calendar.

Nested Classes
Modifier and Type	Class and Description
`static class`	`EthiopianCalendar.Unit` Defines come calendar units for the Ethiopian calendar.

Field Summary

Fields
Modifier and Type	Field and Description
`static StdCalendarElement<java.lang.Integer,EthiopianCalendar>`	`DAY_OF_MONTH` Represents the Ethiopian day of month.
`static StdCalendarElement<Weekday,EthiopianCalendar>`	`DAY_OF_WEEK` Represents the Ethiopian day of week.
`static StdCalendarElement<java.lang.Integer,EthiopianCalendar>`	`DAY_OF_YEAR` Represents the Ethiopian day of year.
`static ChronoElement<EthiopianEra>`	`ERA` Represents the Ethiopian era.
`static ChronoElement<Evangelist>`	`EVANGELIST` Represents the evangelist associated with a year of the Ethiopian leap year cycle.
`static StdCalendarElement<EthiopianMonth,EthiopianCalendar>`	`MONTH_OF_YEAR` Represents the Ethiopian month.
`static TextElement<Tabot>`	`TABOT` Represents the tabot name of the associated day-of-month.
`static StdCalendarElement<java.lang.Integer,EthiopianCalendar>`	`YEAR_OF_ERA` Represents the Ethiopian year.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`GeneralTimestamp<EthiopianCalendar>`	`at(EthiopianTime time)` Creates a new local timestamp with this date and given Ethiopian time.
`static TimeAxis<EthiopianCalendar.Unit,EthiopianCalendar>`	`axis()` Returns the associated time axis.
`boolean`	`equals(java.lang.Object obj)` Based on the epoch day number and the calendar system.
`int`	`getDayOfMonth()` Yields the Ethiopian day of month.
`Weekday`	`getDayOfWeek()` Determines the day of week.
`int`	`getDayOfYear()` Yields the Ethiopian day of year.
`static Weekmodel`	`getDefaultWeekmodel()` Obtains the standard week model of this calendar.
`EthiopianEra`	`getEra()` Yields the Ethiopian era.
`EthiopianMonth`	`getMonth()` Yields the Ethiopian month.
`int`	`getYear()` Yields the Ethiopian year.
`int`	`getYearOfEra()` Deprecated. Use `getYear()` instead
`int`	`hashCode()` Based on the epoch day number.
`boolean`	`isLeapYear()` Is the year of this date a leap year?
`int`	`lengthOfMonth()` Yields the length of current Ethiopian month in days.
`int`	`lengthOfYear()` Yields the length of current Ethiopian year in days.
`static EthiopianCalendar`	`nowInSystemTime()` Obtains the current calendar date in system time.
`static EthiopianCalendar`	`of(EthiopianEra era, int yearOfEra, EthiopianMonth month, int dayOfMonth)` Creates a new instance of an Ethiopian calendar date.
`static EthiopianCalendar`	`of(EthiopianEra era, int yearOfEra, int month, int dayOfMonth)` Creates a new instance of an Ethiopian calendar date.
`java.lang.String`	`toString()` Provides a complete textual representation of the state of this time point.

Methods inherited from class net.time4j.engine.Calendrical
compareTo, getDaysSinceEpochUTC, isAfter, isBefore, isSimultaneous, minus, plus, transform, transform, transform

Methods inherited from class net.time4j.engine.TimePoint
max, min, minus, minus, plus, plus, until, until

Methods inherited from class net.time4j.engine.ChronoEntity
contains, get, get, getInt, getMaximum, getMinimum, getRegisteredElements, getTimezone, hasTimezone, isValid, isValid, isValid, matches, with, with, with, with

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

- Field Detail
  - ERA
```
@FormattableElement(format="G")
public static final ChronoElement<EthiopianEra> ERA
```
    Represents the Ethiopian era.
    
    A change of the era has no effect.
  - YEAR_OF_ERA
```
@FormattableElement(format="y")
public static final StdCalendarElement<java.lang.Integer,EthiopianCalendar> YEAR_OF_ERA
```
    Represents the Ethiopian year.
    
    Note: The format engine of Time4J uses the Ethiopic numeral system for calendar years by default if the language is Amharic.
    
    See Also:
    
    NumberSystem.ETHIOPIC
  - MONTH_OF_YEAR
```
@FormattableElement(format="M",
                    standalone="L")
public static final StdCalendarElement<EthiopianMonth,EthiopianCalendar> MONTH_OF_YEAR
```
    Represents the Ethiopian month.
  - DAY_OF_MONTH
```
@FormattableElement(format="d")
public static final StdCalendarElement<java.lang.Integer,EthiopianCalendar> DAY_OF_MONTH
```
    Represents the Ethiopian day of month.
  - DAY_OF_YEAR
```
@FormattableElement(format="D")
public static final StdCalendarElement<java.lang.Integer,EthiopianCalendar> DAY_OF_YEAR
```
    Represents the Ethiopian day of year.
  - DAY_OF_WEEK
```
@FormattableElement(format="E")
public static final StdCalendarElement<Weekday,EthiopianCalendar> DAY_OF_WEEK
```
    Represents the Ethiopian day of week.
    
    If the day-of-week is set to a new value then Time4J handles the Ethiopian calendar week as starting on Sunday (deviation from Coptic calendar).
  - EVANGELIST
```
public static final ChronoElement<Evangelist> EVANGELIST
```
    Represents the evangelist associated with a year of the Ethiopian leap year cycle.
    
    The fourth evangelist (John) is always associated with a leap year.
  - TABOT
```
public static final TextElement<Tabot> TABOT
```
    Represents the tabot name of the associated day-of-month.
    
    Example of usage in formatting:
```
  ChronoFormatter<EthiopianCalendar> f =
      ChronoFormatter.setUp(EthiopianCalendar.axis(), new Locale("am"))
      .addPattern("d MMMM y G", PatternType.NON_ISO_DATE)
      .addLiteral(" (")
      .addText(EthiopianCalendar.TABOT)
      .addLiteral(')')
      .build();
  String s = f.format(EthiopianCalendar.of(EthiopianEra.AMETE_MIHRET, 2007, 6, 25));
 
```
- Method Detail
  - of
```
public static EthiopianCalendar of(EthiopianEra era,
                                   int yearOfEra,
                                   EthiopianMonth month,
                                   int dayOfMonth)
```
    Creates a new instance of an Ethiopian calendar date.
    
    Parameters:
    
    era - Ethiopian era
    
    yearOfEra - Ethiopian year of era in the range 1-9999 (1-15499 if amete alem)
    
    month - Ethiopian month
    
    dayOfMonth - Ethiopian day of month in the range 1-30
    
    Returns:
    
    new instance of EthiopianCalendar
    
    Throws:
    
    java.lang.IllegalArgumentException - in case of any inconsistencies
    
    Since:
    
    3.11/4.8
  - of
```
public static EthiopianCalendar of(EthiopianEra era,
                                   int yearOfEra,
                                   int month,
                                   int dayOfMonth)
```
    Creates a new instance of an Ethiopian calendar date.
    
    Parameters:
    
    era - Ethiopian era
    
    yearOfEra - Ethiopian year of era in the range 1-9999 (1-15499 if amete alem)
    
    month - Ethiopian month in the range 1-13
    
    dayOfMonth - Ethiopian day of month in the range 1-30
    
    Returns:
    
    new instance of EthiopianCalendar
    
    Throws:
    
    java.lang.IllegalArgumentException - in case of any inconsistencies
    
    Since:
    
    3.11/4.8
  - nowInSystemTime
```
public static EthiopianCalendar nowInSystemTime()
```
    Obtains the current calendar date in system time.
    
    Convenient short-cut for: SystemClock.inLocalView().now(EthiopianCalendar.axis()). Attention: The Ethiopian calendar changes the date in the morning at 6 AM.
    
    Returns:
    
    current calendar date in system time zone using the system clock
    
    Since:
    
    3.23/4.19
    
    See Also:
    
    SystemClock.inLocalView(), ZonalClock.now(net.time4j.engine.Chronology)
  - getEra
```
public EthiopianEra getEra()
```
    Yields the Ethiopian era.
    
    Returns:
    
    enum
    
    Since:
    
    3.11/4.8
  - getYearOfEra
```
@Deprecated
public int getYearOfEra()
```
    Deprecated. Use getYear() instead
    
    Yields the Ethiopian year.
    
    Returns:
    
    int
    
    Since:
    
    3.11/4.8
  - getYear
```
public int getYear()
```
    Yields the Ethiopian year.
    
    Returns:
    
    int
    
    Since:
    
    3.13/4.10
  - getMonth
```
public EthiopianMonth getMonth()
```
    Yields the Ethiopian month.
    
    Returns:
    
    enum
    
    Since:
    
    3.11/4.8
  - getDayOfMonth
```
public int getDayOfMonth()
```
    Yields the Ethiopian day of month.
    
    Returns:
    
    int
    
    Since:
    
    3.11/4.8
  - getDayOfWeek
```
public Weekday getDayOfWeek()
```
    Determines the day of week.
    
    The Ethiopian calendar also uses a 7-day-week.
    
    Returns:
    
    Weekday
    
    Since:
    
    3.11/4.8
  - getDayOfYear
```
public int getDayOfYear()
```
    Yields the Ethiopian day of year.
    
    Returns:
    
    int
    
    Since:
    
    3.11/4.8
  - lengthOfMonth
```
public int lengthOfMonth()
```
    Yields the length of current Ethiopian month in days.
    
    Returns:
    
    int
    
    Since:
    
    3.11/4.8
  - lengthOfYear
```
public int lengthOfYear()
```
    Yields the length of current Ethiopian year in days.
    
    Returns:
    
    int
    
    Since:
    
    3.11/4.8
  - isLeapYear
```
public boolean isLeapYear()
```
    Is the year of this date a leap year?
    
    Returns:
    
    boolean
    
    Since:
    
    3.11/4.8
  - at
```
public GeneralTimestamp<EthiopianCalendar> at(EthiopianTime time)
```
    Creates a new local timestamp with this date and given Ethiopian time.
    
    Note: The Ethiopian time will be automatically converted to ISO.
    
    Parameters:
    
    time - ethiopian time starting in the morning
    
    Returns:
    
    general timestamp as composition of this date and given time
    
    Since:
    
    3.11/4.8
  - equals
```
public boolean equals(java.lang.Object obj)
```
    Description copied from class: Calendrical
    
    Based on the epoch day number and the calendar system.
    
    In other words: Two date object are equal if they have the same temporal position on the local timeline and have the same calendrical type. Subclasses which define further state attributes must override this method.
    
    If an only temporal comparison is required then the method Calendrical.isSimultaneous(CalendarDate) is to be used.
    
    Overrides:
    
    equals in class Calendrical<EthiopianCalendar.Unit,EthiopianCalendar>
    
    See Also:
    
    Chronology.getChronoType()
  - hashCode
```
public int hashCode()
```
    Description copied from class: Calendrical
    
    Based on the epoch day number.
    
    Overrides:
    
    hashCode in class Calendrical<EthiopianCalendar.Unit,EthiopianCalendar>
  - toString
```
public java.lang.String toString()
```
    Description copied from class: TimePoint
    
    Provides a complete textual representation of the state of this time point.
    
    The textual description often follows the conventions of ISO-8601. Usually the description starts with the chronological informations which are coarse-grained and ends with those ones which are fine-grained (for example the ISO-notation YYYY-MM-DD).
    
    Specified by:
    
    toString in class TimePoint<EthiopianCalendar.Unit,EthiopianCalendar>
  - getDefaultWeekmodel
```
public static Weekmodel getDefaultWeekmodel()
```
    Obtains the standard week model of this calendar.
    
    The Ethiopian calendar usually starts on Sunday.
    
    Returns:
    
    Weekmodel
    
    Since:
    
    3.24/4.20
  - axis
```
public static TimeAxis<EthiopianCalendar.Unit,EthiopianCalendar> axis()
```
    Returns the associated time axis.
    
    Returns:
    
    chronology
    
    Since:
    
    3.11/4.8

Class EthiopianCalendar

Nested Class Summary

Field Summary

Method Summary

Methods inherited from class net.time4j.engine.Calendrical

Methods inherited from class net.time4j.engine.TimePoint

Methods inherited from class net.time4j.engine.ChronoEntity

Methods inherited from class java.lang.Object

Field Detail

ERA

YEAR_OF_ERA

MONTH_OF_YEAR

DAY_OF_MONTH

DAY_OF_YEAR

DAY_OF_WEEK

EVANGELIST

TABOT

Method Detail

of

of

nowInSystemTime

getEra

getYearOfEra

getYear

getMonth

getDayOfMonth

getDayOfWeek

getDayOfYear

lengthOfMonth

lengthOfYear

isLeapYear

at

equals

hashCode

toString

getDefaultWeekmodel

axis