net.time4j.calendar

Class EastAsianMonth

java.lang.Object

net.time4j.calendar.EastAsianMonth

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<EastAsianMonth>

public final class EastAsianMonth
extends java.lang.Object
implements java.lang.Comparable<EastAsianMonth>, java.io.Serializable

Represents a month used in the East Asian countries China, Korea or Japan.

This kind of month has its origins in the Chinese calendar. It is defined within the lunisolar context and sometimes allows a leap month. Such a leap month happens about every 2-3 years and has the same number as the preceding one. Therefore it is important not to leave out the leap month flag before a month number if such a month has to be printed.

However, in Japan, the East Asian month is identical to the gregorian month since Meiji 6 (1873) and does no longer make usage of any leap months.

Since:

3.32/4.27

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static AttributeKey<java.lang.Character>	LEAP_MONTH_INDICATOR Format attribute which defines a symbol character for the leap month deviating from standard.

Method Summary

Modifier and Type	Method and Description
int	compareTo(EastAsianMonth other)
boolean	equals(java.lang.Object obj)
java.lang.String	getDisplayName(java.util.Locale locale, NumberSystem numsys) Obtains a textual representation of this month for display purposes.
int	getNumber() Gets the corresponding numerical value which is not necessarily unique due to a possible leap month flag.
java.lang.String	getOldJapaneseName(java.util.Locale locale) Gets the traditional Japanese month name.
int	hashCode()
boolean	isLeap() Is this month a lunisolar leap month?
java.lang.String	toString()
static EastAsianMonth	valueOf(int month) Gets the standard East Asian month which corresponds to the given numerical value.
EastAsianMonth	withLeap() Obtains the leap month version of this month.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Field Detail

LEAP_MONTH_INDICATOR

public static final AttributeKey<java.lang.Character> LEAP_MONTH_INDICATOR

Format attribute which defines a symbol character for the leap month deviating from standard.

See Also:

ChronoFormatter.with(AttributeKey, char)

Method Detail

valueOf

public static EastAsianMonth valueOf(int month)

Gets the standard East Asian month which corresponds to the given numerical value.

Users have to invoke the method withLeap() in order to obtain a leap month.

Parameters:

month - standard month in the range [1-12]

Returns:

east asian month as wrapper around a number

Throws:

java.lang.IllegalArgumentException - if given argument is out of range

getNumber

public int getNumber()

Gets the corresponding numerical value which is not necessarily unique due to a possible leap month flag.

Lunisolar leap months have the same number as the preceding month.

Returns:

number of month in the range [1-12]

See Also:

isLeap()

isLeap

public boolean isLeap()

Is this month a lunisolar leap month?

Returns:

boolean

withLeap

public EastAsianMonth withLeap()

Obtains the leap month version of this month.

Returns:

east asian leap month with the same number as this month

getOldJapaneseName

public java.lang.String getOldJapaneseName(java.util.Locale locale)

Gets the traditional Japanese month name.

Note: The leap month flag is ignored.

Parameters:

locale - language setting

Returns:

descriptive text (never null)

getDisplayName

public java.lang.String getDisplayName(java.util.Locale locale,
                                       NumberSystem numsys)

Obtains a textual representation of this month for display purposes.

East Asian months are traditionally displayed in a numeric way. Example:

      EastAsianMonth month = EastAsianMonth.valueOf(1).withLeap();
      String s = month.getDisplayName(Locale.ENGLISH, NumberSystem.ARABIC);
      System.out.println(s); // output with leap-indicator "i": i1
 

The leap indicator is locale-sensitive. Time4J uses the asterisk as default, but for the major European languages with some affinity to Latin also the small letter "i" (intercalary). The East Asian languages Japanese, Chinese and Korean have their own special characters.

Parameters:

locale - language setting

numsys - number system

Returns:

descriptive text (never null)

compareTo

public int compareTo(EastAsianMonth other)

Specified by:

compareTo in interface java.lang.Comparable<EastAsianMonth>

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object