Class CECalendar

java.lang.Object

com.ibm.icu.util.Calendar

com.ibm.icu.util.CECalendar

All Implemented Interfaces:

Serializable, Cloneable, Comparable<Calendar>

Direct Known Subclasses:

CopticCalendar, EthiopicCalendar

abstract class CECalendar
extends Calendar

Base class for EthiopicCalendar and CopticCalendar.

Nested Class Summary

Nested classes/interfaces inherited from class Calendar

Calendar.FormatConfiguration, Calendar.PatternData, Calendar.WeekData

Field Summary

Fields

Modifier and Type	Field	Description
private static final int[][]	LIMITS
private static final long	serialVersionUID

Fields inherited from class Calendar

AM, AM_PM, APRIL, AUGUST, BASE_FIELD_COUNT, DATE, DATE_PRECEDENCE, DAY_OF_MONTH, DAY_OF_WEEK, DAY_OF_WEEK_IN_MONTH, DAY_OF_YEAR, DECEMBER, DOW_LOCAL, DOW_PRECEDENCE, 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_FIELD_COUNT, MAX_JULIAN, MAX_MILLIS, MAXIMUM, MAY, MILLISECOND, MILLISECONDS_IN_DAY, MIN_DATE, MIN_JULIAN, MIN_MILLIS, MINIMUM, MINIMUM_USER_STAMP, MINUTE, MONDAY, MONTH, MONTH_PRECEDENCE, 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, WEEKDAY, WEEKEND, WEEKEND_CEASE, WEEKEND_ONSET, YEAR, YEAR_WOY, ZONE_OFFSET

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	CECalendar()	Constructs a default CECalendar using the current time in the default time zone with the default FORMAT locale.
protected	CECalendar(int year, int month, int date)	Constructs a CECalendar with the given date set in the default time zone with the default FORMAT locale.
protected	CECalendar(int year, int month, int date, int hour, int minute, int second)	Constructs a CECalendar with the given date and time set for the default time zone with the default FORMAT locale.
protected	CECalendar(TimeZone zone)	Constructs a CECalendar based on the current time in the given time zone with the default FORMAT locale.
protected	CECalendar(TimeZone zone, ULocale locale)	Constructs a CECalendar based on the current time in the given time zone with the given locale.
protected	CECalendar(TimeZone zone, Locale aLocale)	Constructs a CECalendar based on the current time in the given time zone with the given locale.
protected	CECalendar(ULocale locale)	Constructs a CECalendar based on the current time in the default time zone with the given locale.
protected	CECalendar(Date date)	Constructs a CECalendar with the given date set in the default time zone with the default FORMAT locale.
protected	CECalendar(Locale aLocale)	Constructs a CECalendar based on the current time in the default time zone with the given locale.

Method Summary

Modifier and Type	Method	Description
static int	ceToJD(long year, int month, int day, int jdEpochOffset)	Convert an Coptic/Ethiopic year, month and day to a Julian day
protected abstract int	extendedYearToEra(int eyear)	Deprecated. This API is ICU internal only.
protected abstract int	extendedYearToYear(int eyear)	Deprecated. This API is ICU internal only.
protected abstract int	getJDEpochOffset()	The Coptic and Ethiopic calendars differ only in their epochs.
String	getTemporalMonthCode()	Gets The Temporal monthCode value corresponding to the month for the date.
protected void	handleComputeFields(int julianDay)	Deprecated. This API is ICU internal only.
protected int	handleComputeMonthStart(int eyear, int emonth, boolean useMonth)	Return JD of start of given month/extended year
protected int	handleGetLimit(int field, int limitType)	Calculate the limit for a specified type of limit and field
protected int	handleGetMonthLength(int extendedYear, int month)	Return the number of days in the given month of the given extended year of this calendar system.
static void	jdToCE(int julianDay, int jdEpochOffset, int[] fields)	Convert a Julian day to an Coptic/Ethiopic year, month and day
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.

Methods inherited from class Calendar

add, after, before, clear, clear, clone, compareTo, complete, computeFields, computeGregorianFields, computeGregorianMonthStart, computeJulianDay, computeMillisInDay, computeMillisInDayLong, computeTime, computeZoneOffset, computeZoneOffset, equals, fieldDifference, fieldName, floorDivide, floorDivide, floorDivide, floorDivide, get, getActualMaximum, getActualMinimum, getAvailableLocales, getAvailableULocales, getDateAtTimePattern, getDateTimeFormat, getDateTimeFormat, getDateTimePattern, getDayOfWeekType, getDefaultDayInMonth, getDefaultMonthInYear, getDisplayName, getDisplayName, getFieldCount, getFieldResolutionTable, getFirstDayOfWeek, getGreatestMinimum, getGregorianDayOfMonth, getGregorianDayOfYear, getGregorianMonth, getGregorianYear, getInstance, getInstance, getInstance, getInstance, getInstance, getInstance, getKeywordValuesForLocale, getLeastMaximum, getLimit, getLocale, getMaximum, getMinimalDaysInFirstWeek, getMinimum, getRelatedYear, getRelatedYearDifference, getRepeatedWallTimeOption, getSkippedWallTimeOption, getStamp, getTime, getTimeInMillis, getTimeZone, getType, getWeekData, getWeekDataForRegion, getWeekendTransition, gregorianMonthLength, gregorianPreviousMonthLength, handleComputeJulianDay, handleCreateFields, handleGetDateFormat, handleGetDateFormat, handleGetDateFormat, handleGetDateFormat, handleGetExtendedYear, handleGetYearLength, hashCode, haveDefaultCentury, inTemporalLeapYear, internalGet, internalGet, internalGetMonth, internalGetMonth, internalGetTimeInMillis, internalSet, isEquivalentTo, isEra0CountingBackward, isGregorianLeapYear, isLenient, isSet, isWeekend, isWeekend, julianDayToDayOfWeek, julianDayToMillis, millisToJulianDay, newerField, newestStamp, pinField, prepareGetActual, resolveFields, roll, roll, set, set, set, set, setFirstDayOfWeek, setLenient, setLocale, setMinimalDaysInFirstWeek, setRelatedYear, setRepeatedWallTimeOption, setSkippedWallTimeOption, setTime, setTimeInMillis, setTimeZone, setWeekData, toString, validateField, validateField, validateFields, weekNumber, weekNumber

Methods inherited from class Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

serialVersionUID

private static final long serialVersionUID

See Also:

• Constant Field Values

LIMITS

private static final int[][] LIMITS

Constructor Details

CECalendar

protected CECalendar()

Constructs a default CECalendar using the current time in the default time zone with the default FORMAT locale.

CECalendar

protected CECalendar(TimeZone zone)

Constructs a CECalendar based on the current time in the given time zone with the default FORMAT locale.

Parameters:

zone - The time zone for the new calendar.

CECalendar

protected CECalendar(Locale aLocale)

Constructs a CECalendar based on the current time in the default time zone with the given locale.

Parameters:

aLocale - The locale for the new calendar.

CECalendar

protected CECalendar(ULocale locale)

Constructs a CECalendar based on the current time in the default time zone with the given locale.

Parameters:

locale - The locale for the new calendar.

CECalendar

protected CECalendar(TimeZone zone,
 Locale aLocale)

Constructs a CECalendar based on the current time in the given time zone with the given locale.

Parameters:

zone - The time zone for the new calendar.

aLocale - The locale for the new calendar.

CECalendar

protected CECalendar(TimeZone zone,
 ULocale locale)

Constructs a CECalendar based on the current time in the given time zone with the given locale.

Parameters:

zone - The time zone for the new calendar.

locale - The locale for the new calendar.

CECalendar

protected CECalendar(int year,
 int month,
 int date)

Constructs a CECalendar with the given date set in the default time zone with the default FORMAT locale.

Parameters:

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 Tishri.

date - The value used to set the calendar's DATE time field.

CECalendar

protected CECalendar(Date date)

Constructs a CECalendar with the given date set in the default time zone with the default FORMAT locale.

Parameters:

date - The date to which the new calendar is set.

CECalendar

protected CECalendar(int year,
 int month,
 int date,
 int hour,
 int minute,
 int second)

Constructs a CECalendar with the given date and time set for the default time zone with the default FORMAT locale.

Parameters:

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 Tishri.

date - The value used to set the calendar's DATE time field.

hour - The value used to set the calendar's HOUR_OF_DAY time field.

minute - The value used to set the calendar's MINUTE time field.

second - The value used to set the calendar's SECOND time field.

Method Details

getJDEpochOffset

protected abstract int getJDEpochOffset()

The Coptic and Ethiopic calendars differ only in their epochs. This method must be implemented by CECalendar subclasses to return the date offset from Julian.

handleComputeFields

@Deprecated
protected void handleComputeFields(int julianDay)

Deprecated.

This API is ICU internal only.

Subclasses may override this method to compute several fields specific to each calendar system. These are:

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

Subclasses can refer to the DAY_OF_WEEK and DOW_LOCAL fields, which will be set when this method is called. Subclasses can also call the getGregorianXxx() methods to obtain Gregorian calendar equivalents for the given Julian day.

In addition, subclasses should compute any subclass-specific fields, that is, fields from BASE_FIELD_COUNT to getFieldCount() - 1.

The default implementation in Calendar implements a pure proleptic Gregorian calendar.

Overrides:

handleComputeFields in class Calendar

extendedYearToEra

@Deprecated
protected abstract int extendedYearToEra(int eyear)

Deprecated.

This API is ICU internal only.

Convert extended year to era

extendedYearToYear

@Deprecated
protected abstract int extendedYearToYear(int eyear)

Deprecated.

This API is ICU internal only.

Convert extended year to year

handleComputeMonthStart

protected int handleComputeMonthStart(int eyear,
 int emonth,
 boolean useMonth)

Return JD of start of given month/extended year

Specified by:

handleComputeMonthStart in class Calendar

Parameters:

eyear - the extended year

emonth - the zero-based month, or 0 if useMonth is false

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 month

Returns:

the Julian day number of the day before the first day of the given month and year

handleGetLimit

protected int handleGetLimit(int field,
 int limitType)

Calculate the limit for a specified type of limit and field

Specified by:

handleGetLimit in class Calendar

Parameters:

field - one of the above field numbers

limitType - one of MINIMUM, GREATEST_MINIMUM, LEAST_MAXIMUM, or MAXIMUM

handleGetMonthLength

protected int handleGetMonthLength(int extendedYear,
 int month)

Return the number of days in the given month of the given extended year of this calendar system. Subclasses should override this method if they can provide a more correct or more efficient implementation than the default implementation in Calendar.

Overrides:

handleGetMonthLength in class Calendar

ceToJD

public static int ceToJD(long year,
 int month,
 int day,
 int jdEpochOffset)

Convert an Coptic/Ethiopic year, month and day to a Julian day

Parameters:

year - the extended year

month - the month

day - the day

Returns:

Julian day

jdToCE

public static void jdToCE(int julianDay,
 int jdEpochOffset,
 int[] fields)

Convert a Julian day to an Coptic/Ethiopic year, month and day

getTemporalMonthCode

public String getTemporalMonthCode()

Gets The Temporal monthCode value corresponding to the month for the date. The value 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. For the short thirteen month in each year in the CECalendar, the value is "M13".

Overrides:

getTemporalMonthCode in class Calendar

Returns:

One of 13 possible strings in {"M01".. "M12", "M13"}.

setTemporalMonthCode

public 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. For CECalendar calendar, the values are "M01" .. "M13" while the "M13" is represent the short thirteen month in each year.

Overrides:

setTemporalMonthCode in class Calendar

Parameters:

temporalMonth - One of 13 possible strings in {"M01".. "M12", "M13"}.