Java Doc for ChineseCalendar.java in  » Internationalization-Localization » icu4j » com » ibm » icu » util » Java Source Code / Java DocumentationJava Source Code and Java Documentation

This class defines one addition field beyond those defined by Calendar: The IS_LEAP_MONTH field takes the value of 0 for normal months, or 1 for leap months.

All astronomical computations are performed with respect to a time zone of GMT+8:00 and a longitude of 120 degrees east. Although some calendars implement a historically more accurate convention of using Beijing's local longitude (116 degrees 25 minutes east) and time zone (GMT+7:45:40) for dates before 1929, we do not implement this here.

Years are counted in two different ways in the Chinese calendar. The first method is by sequential numbering from the 61st year of the reign of Huang Di, 2637 BCE, which is designated year 1 on the Chinese calendar. The second method uses 60-year cycles from the same starting point, which is designated year 1 of cycle 1. In this class, the EXTENDED_YEAR field contains the sequential year count. The ERA field contains the cycle number, and the YEAR field contains the year of the cycle, a value between 1 and 60.

There is some variation in what is considered the starting point of the calendar, with some sources starting in the first year of the reign of Huang Di, rather than the 61st. This gives continuous year numbers 60 years greater and cycle numbers one greater than what this class implements.

Because ChineseCalendar defines an additional field and redefines the way the ERA field is used, it requires a new format class, ChineseDateFormat. As always, use the methods DateFormat.getXxxInstance(Calendar cal,...) to obtain a formatter for this calendar.

References:

• Dershowitz and Reingold, Calendrical Calculations, Cambridge University Press, 1997
• Helmer Aslaksen's Chinese Calendar page
• The Calendar FAQ

This class should not be subclassed.

ChineseCalendar usually should be instantiated using com.ibm.icu.util.Calendar.getInstance(ULocale) passing in a ULocale with the tag "@calendar=chinese".

Note: This method reads the IS_LEAP_MONTH field to determine whether the given month is a leap month.
Parameters:
  eyear - the extended year
Parameters:
  month - the zero-based month.

• ERA
• YEAR
• MONTH
• DAY_OF_MONTH
• DAY_OF_YEAR
• EXTENDED_YEAR

Compute the ChineseCalendar-specific field IS_LEAP_MONTH.

Note: This method reads the IS_LEAP_MONTH field to determine whether the given month is a leap month.
Parameters:
  eyear - the extended year
Parameters:
  month - the zero-based month. The month is also determinedby reading the IS_LEAP_MONTH field. the Julian day number of the day before the firstday of the given month and year

Note: This method also reads the IS_LEAP_MONTH field to determine whether or not the given month is a leap month.