public class ChineseCalendar extends Calendar
ChineseCalendar is a concrete subclass of Calendar
that implements a traditional Chinese calendar. The traditional Chinese
calendar is a lunisolar calendar: Each month starts on a new moon, and
the months are numbered according to solar events, specifically, to
guarantee that month 11 always contains the winter solstice. In order
to accomplish this, leap months are inserted in certain years. Leap
months are numbered the same as the month they follow. The decision of
which month is a leap month depends on the relative movements of the sun
and moon.
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:
This class should not be subclassed.
ChineseCalendar usually should be instantiated using
Calendar.getInstance(ULocale) passing in a ULocale
with the tag "@calendar=chinese".
Calendar,
Serialized FormCalendar.WeekDataAM, AM_PM, APRIL, AUGUST, DATE, DAY_OF_MONTH, DAY_OF_WEEK, DAY_OF_WEEK_IN_MONTH, DAY_OF_YEAR, DECEMBER, DOW_LOCAL, DST_OFFSET, EPOCH_JULIAN_DAY, ERA, EXTENDED_YEAR, FEBRUARY, FRIDAY, GREATEST_MINIMUM, HOUR, HOUR_OF_DAY, INTERNALLY_SET, IS_LEAP_MONTH, JAN_1_1_JULIAN_DAY, JANUARY, JULIAN_DAY, JULY, JUNE, LEAST_MAXIMUM, MARCH, MAX_DATE, MAX_JULIAN, MAX_MILLIS, MAXIMUM, MAY, MILLISECOND, MILLISECONDS_IN_DAY, MIN_DATE, MIN_JULIAN, MIN_MILLIS, MINIMUM, MINIMUM_USER_STAMP, MINUTE, MONDAY, MONTH, NOVEMBER, OCTOBER, ONE_DAY, ONE_HOUR, ONE_MINUTE, ONE_SECOND, ONE_WEEK, ORDINAL_MONTH, PM, RESOLVE_REMAP, SATURDAY, SECOND, SEPTEMBER, SUNDAY, THURSDAY, TUESDAY, UNDECIMBER, UNSET, WALLTIME_FIRST, WALLTIME_LAST, WALLTIME_NEXT_VALID, WEDNESDAY, WEEK_OF_MONTH, WEEK_OF_YEAR, YEAR, YEAR_WOY, ZONE_OFFSET| Constructor and Description |
|---|
ChineseCalendar()
Construct a
ChineseCalendar with the default time zone and locale. |
ChineseCalendar(Date date)
Construct a
ChineseCalendar with the give date set in the default time zone
with the default locale. |
ChineseCalendar(int year,
int month,
int isLeapMonth,
int date)
Constructs a
ChineseCalendar with the given date set
in the default time zone with the default FORMAT locale. |
ChineseCalendar(int era,
int year,
int month,
int isLeapMonth,
int date)
Constructs a
ChineseCalendar with the given date set
in the default time zone with the default FORMAT locale. |
ChineseCalendar(int year,
int month,
int isLeapMonth,
int date,
int hour,
int minute,
int second)
Constructs a
ChineseCalendar with the given date
and time set for the default time zone with the default FORMAT locale. |
ChineseCalendar(int era,
int year,
int month,
int isLeapMonth,
int date,
int hour,
int minute,
int second)
Constructs a
ChineseCalendar with the given date
and time set for the default time zone with the default FORMAT locale. |
ChineseCalendar(Locale aLocale)
Constructs a
ChineseCalendar based on the current time
in the default time zone with the given locale. |
ChineseCalendar(TimeZone zone)
Construct a
ChineseCalendar based on the current time
in the given time zone with the default FORMAT locale. |
ChineseCalendar(TimeZone zone,
Locale aLocale)
Construct a
ChineseCalendar based on the current time
in the given time zone with the given locale. |
ChineseCalendar(TimeZone zone,
ULocale locale)
Construct a
ChineseCalendar based on the current time
with the given time zone with the given locale. |
ChineseCalendar(ULocale locale)
Constructs a
ChineseCalendar based on the current time
in the default time zone with the given locale. |
| Modifier and Type | Method and Description |
|---|---|
void |
add(int field,
int amount)
Override Calendar to handle leap months properly.
|
protected int[][][] |
getFieldResolutionTable()
Override Calendar to add IS_LEAP_MONTH to the field resolution
table.
|
String |
getTemporalMonthCode()
Gets The Temporal monthCode value corresponding to the month for the date.
|
String |
getType()
Returns the calendar type name string for this Calendar object.
|
protected void |
handleComputeFields(int julianDay)
Override Calendar to compute several fields specific to the Chinese
calendar system.
|
protected int |
handleComputeMonthStart(int eyear,
int month,
boolean useMonth)
Return the Julian day number of day before the first day of the
given month in the given extended year.
|
protected DateFormat |
handleGetDateFormat(String pattern,
String override,
ULocale locale)
Creates a
DateFormat appropriate to this calendar. |
protected int |
handleGetExtendedYear()
Implement abstract Calendar method to return the extended year
defined by the current fields.
|
protected int |
handleGetLimit(int field,
int limitType)
Override Calendar to return the limit value for the given field.
|
protected int |
handleGetMonthLength(int extendedYear,
int month)
Override Calendar method to return the number of days in the given
extended year and month.
|
boolean |
inTemporalLeapYear()
Returns true if the date is in a leap year.
|
void |
roll(int field,
int amount)
Override Calendar to handle leap months properly.
|
void |
setTemporalMonthCode(String temporalMonth)
Sets The Temporal monthCode which is a string identifier that starts
with the literal grapheme "M" followed by two graphemes representing
the zero-padded month number of the current month in a normal
(non-leap) year and suffixed by an optional literal grapheme "L" if this
is a leap month in a lunisolar calendar.
|
after, before, clear, clear, clone, compareTo, complete, computeFields, computeGregorianFields, computeGregorianMonthStart, computeJulianDay, computeTime, equals, fieldDifference, fieldName, floorDivide, floorDivide, floorDivide, floorDivide, get, getActualMaximum, getActualMinimum, getAvailableLocales, getAvailableULocales, getDateTimeFormat, getDateTimeFormat, getDefaultDayInMonth, getDefaultMonthInYear, getDisplayName, getDisplayName, getFieldCount, getFirstDayOfWeek, getGreatestMinimum, getGregorianDayOfMonth, getGregorianDayOfYear, getGregorianMonth, getGregorianYear, getInstance, getInstance, getInstance, getInstance, getInstance, getInstance, getKeywordValuesForLocale, getLeastMaximum, getLimit, getLocale, getMaximum, getMinimalDaysInFirstWeek, getMinimum, getRepeatedWallTimeOption, getSkippedWallTimeOption, getStamp, getTime, getTimeInMillis, getTimeZone, getWeekData, getWeekDataForRegion, gregorianMonthLength, gregorianPreviousMonthLength, handleComputeJulianDay, handleCreateFields, handleGetDateFormat, handleGetDateFormat, handleGetDateFormat, handleGetYearLength, hashCode, internalGet, internalGet, internalGetTimeInMillis, internalSet, isEquivalentTo, isGregorianLeapYear, isLenient, isSet, isWeekend, isWeekend, julianDayToDayOfWeek, julianDayToMillis, millisToJulianDay, newerField, newestStamp, pinField, prepareGetActual, resolveFields, roll, set, set, set, set, setFirstDayOfWeek, setLenient, setMinimalDaysInFirstWeek, setRepeatedWallTimeOption, setSkippedWallTimeOption, setTime, setTimeInMillis, setTimeZone, setWeekData, toString, validateField, validateField, validateFields, weekNumber, weekNumberpublic ChineseCalendar()
ChineseCalendar with the default time zone and locale.public ChineseCalendar(Date date)
ChineseCalendar with the give date set in the default time zone
with the default locale.date - The date to which the new calendar is set.public ChineseCalendar(int year,
int month,
int isLeapMonth,
int date)
ChineseCalendar with the given date set
in the default time zone with the default FORMAT locale.year - The value used to set the calendar's YEAR time field.month - The value used to set the calendar's MONTH time field.
The value is 0-based. e.g., 0 for January.isLeapMonth - The value used to set the Chinese calendar's Calendar.IS_LEAP_MONTH
time field.date - The value used to set the calendar's DATE time field.ULocale.Category.FORMATpublic ChineseCalendar(int year,
int month,
int isLeapMonth,
int date,
int hour,
int minute,
int second)
ChineseCalendar with the given date
and time set for the default time zone with the default FORMAT locale.year - the value used to set the YEAR time field in the calendar.month - the value used to set the MONTH time field in the calendar.
Note that the month value is 0-based. e.g., 0 for January.isLeapMonth - the value used to set the Calendar.IS_LEAP_MONTH time field
in the calendar.date - the value used to set the DATE time field in the calendar.hour - the value used to set the HOUR_OF_DAY time field
in the calendar.minute - the value used to set the MINUTE time field
in the calendar.second - the value used to set the SECOND time field
in the calendar.ULocale.Category.FORMATpublic ChineseCalendar(int era,
int year,
int month,
int isLeapMonth,
int date)
ChineseCalendar with the given date set
in the default time zone with the default FORMAT locale.era - The value used to set the calendar's ERA time field.year - The value used to set the calendar's YEAR time field.month - The value used to set the calendar's MONTH time field.
The value is 0-based. e.g., 0 for January.isLeapMonth - The value used to set the Chinese calendar's Calendar.IS_LEAP_MONTH
time field.date - The value used to set the calendar's DATE time field.ULocale.Category.FORMATpublic ChineseCalendar(int era,
int year,
int month,
int isLeapMonth,
int date,
int hour,
int minute,
int second)
ChineseCalendar with the given date
and time set for the default time zone with the default FORMAT locale.era - the value used to set the calendar's ERA time field.year - the value used to set the YEAR time field in the calendar.month - the value used to set the MONTH time field in the calendar.
Note that the month value is 0-based. e.g., 0 for January.isLeapMonth - the value used to set the Calendar.IS_LEAP_MONTH time field
in the calendar.date - the value used to set the DATE time field in the calendar.hour - the value used to set the HOUR_OF_DAY time field
in the calendar.minute - the value used to set the MINUTE time field
in the calendar.second - the value used to set the SECOND time field
in the calendar.ULocale.Category.FORMATpublic ChineseCalendar(Locale aLocale)
ChineseCalendar based on the current time
in the default time zone with the given locale.aLocale - The given localepublic ChineseCalendar(TimeZone zone)
ChineseCalendar based on the current time
in the given time zone with the default FORMAT locale.zone - the given time zoneULocale.Category.FORMATpublic ChineseCalendar(TimeZone zone, Locale aLocale)
ChineseCalendar based on the current time
in the given time zone with the given locale.zone - the given time zoneaLocale - the given localepublic ChineseCalendar(ULocale locale)
ChineseCalendar based on the current time
in the default time zone with the given locale.locale - the given ulocaleprotected int handleGetLimit(int field,
int limitType)
handleGetLimit in class Calendarfield - one of the above field numberslimitType - one of MINIMUM, GREATEST_MINIMUM,
LEAST_MAXIMUM, or MAXIMUMprotected int handleGetExtendedYear()
handleGetExtendedYear in class Calendarprotected int handleGetMonthLength(int extendedYear,
int month)
Note: This method also reads the IS_LEAP_MONTH field to determine whether or not the given month is a leap month.
handleGetMonthLength in class Calendarprotected DateFormat handleGetDateFormat(String pattern, String override, ULocale locale)
DateFormat appropriate to this calendar.
This is a framework method for subclasses to override. This method
is responsible for creating the calendar-specific DateFormat and
DateFormatSymbols objects as needed.handleGetDateFormat in class Calendarpattern - the pattern, specific to the DateFormat
subclasslocale - the locale for which the symbols should be drawnDateFormat appropriate to this calendarprotected int[][][] getFieldResolutionTable()
getFieldResolutionTable in class CalendarCalendar.resolveFields(int[][][])public void add(int field,
int amount)
add in class Calendarfield - the time field.amount - the amount to add to the field.Calendar.roll(int, int)public void roll(int field,
int amount)
roll in class Calendarfield - the calendar field to roll.amount - the amount by which the field should be rolled.Calendar.roll(int, boolean),
Calendar.add(int, int)protected void handleComputeFields(int julianDay)
Compute the ChineseCalendar-specific field IS_LEAP_MONTH.
handleComputeFields in class Calendarprotected int handleComputeMonthStart(int eyear,
int month,
boolean useMonth)
Note: This method reads the IS_LEAP_MONTH field to determine whether the given month is a leap month.
handleComputeMonthStart in class Calendareyear - the extended yearmonth - the zero-based month. The month is also determined
by reading the IS_LEAP_MONTH field.useMonth - if false, compute the day before the first day of
the given year, otherwise, compute the day before the first day of
the given monthpublic String getType()
See type="old type name" for the calendar attribute of locale IDs at http://www.unicode.org/reports/tr35/#Key_Type_Definitions
public boolean inTemporalLeapYear()
inTemporalLeapYear in class Calendarpublic String getTemporalMonthCode()
getTemporalMonthCode in class Calendarpublic void setTemporalMonthCode(String temporalMonth)
setTemporalMonthCode in class CalendartemporalMonth - One of 25 possible strings in {"M01".. "M12", "M13", "M01L",
"M12L"}.