com.tencent.kona.sun.util.calendar

Class BaseCalendar

java.lang.Object

com.tencent.kona.sun.util.calendar.CalendarSystem

com.tencent.kona.sun.util.calendar.AbstractCalendar

com.tencent.kona.sun.util.calendar.BaseCalendar

Direct Known Subclasses:

Gregorian, JulianCalendar, LocalGregorianCalendar

public abstract class BaseCalendar
extends AbstractCalendar

The BaseCalendar provides basic calendar calculation functions to support the Julian, Gregorian, and Gregorian-based calendar systems.

Since:

1.5

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BaseCalendar.Date

Field Summary

Fields

Modifier and Type	Field and Description
static int	APRIL
static int	AUGUST
static int	DECEMBER
static int	FEBRUARY
static int	FRIDAY
static int	JANUARY
static int	JULY
static int	JUNE
static int	MARCH
static int	MAY
static int	MONDAY
static int	NOVEMBER
static int	OCTOBER
static int	SATURDAY
static int	SEPTEMBER
static int	SUNDAY
static int	THURSDAY
static int	TUESDAY
static int	WEDNESDAY

Constructor Summary

Constructors

Constructor and Description
BaseCalendar()

Method Summary

Modifier and Type	Method and Description
void	getCalendarDateFromFixedDate(CalendarDate date, long fixedDate) Calculates calendar fields and store them in the specified CalendarDate.
int	getDayOfWeek(CalendarDate date) Returns the day of week of the given Gregorian date.
static int	getDayOfWeekFromFixedDate(long fixedDate)
long	getDayOfYear(CalendarDate date)
long	getFixedDate(CalendarDate date) Returns the fixed date calculated with the specified calendar date.
long	getFixedDate(int year, int month, int dayOfMonth, BaseCalendar.Date cache)
int	getMonthLength(CalendarDate date) Returns the length in days of the month specified by the calendar date.
int	getYearFromFixedDate(long fixedDate)
int	getYearLength(CalendarDate date) Returns 366 if the specified date is in a leap year, or 365 otherwise This method does not perform the normalization with the specified CalendarDate.
int	getYearLengthInMonths(CalendarDate date) Returns the number of months of the specified year.
protected boolean	isLeapYear(CalendarDate date)
boolean	normalize(CalendarDate date) Normalizes calendar fields in the specified date.
boolean	validate(CalendarDate date) Checks whether the calendar fields specified by date represents a valid date and time in this calendar system.

Methods inherited from class com.tencent.kona.sun.util.calendar.AbstractCalendar

getCalendarDate, getCalendarDate, getCalendarDate, getCalendarDate, getDayOfWeekDateOnOrBefore, getEra, getEras, getNthDayOfWeek, getTime, getTimeOfDay, getTimeOfDayValue, getWeekLength, setEra, setEras, setTimeOfDay, validateTime

Methods inherited from class com.tencent.kona.sun.util.calendar.CalendarSystem

forName, getGregorianCalendar, getName, newCalendarDate, newCalendarDate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

JANUARY

public static final int JANUARY

See Also:

Constant Field Values

FEBRUARY

public static final int FEBRUARY

See Also:

Constant Field Values

MARCH

public static final int MARCH

See Also:

Constant Field Values

APRIL

public static final int APRIL

See Also:

Constant Field Values

MAY

public static final int MAY

See Also:

Constant Field Values

JUNE

public static final int JUNE

See Also:

Constant Field Values

JULY

public static final int JULY

See Also:

Constant Field Values

AUGUST

public static final int AUGUST

See Also:

Constant Field Values

SEPTEMBER

public static final int SEPTEMBER

See Also:

Constant Field Values

OCTOBER

public static final int OCTOBER

See Also:

Constant Field Values

NOVEMBER

public static final int NOVEMBER

See Also:

Constant Field Values

DECEMBER

public static final int DECEMBER

See Also:

Constant Field Values

SUNDAY

public static final int SUNDAY

See Also:

Constant Field Values

MONDAY

public static final int MONDAY

See Also:

Constant Field Values

TUESDAY

public static final int TUESDAY

See Also:

Constant Field Values

WEDNESDAY

public static final int WEDNESDAY

See Also:

Constant Field Values

THURSDAY

public static final int THURSDAY

See Also:

Constant Field Values

FRIDAY

public static final int FRIDAY

See Also:

Constant Field Values

SATURDAY

public static final int SATURDAY

See Also:

Constant Field Values

Constructor Detail

BaseCalendar

public BaseCalendar()

Method Detail

validate

public boolean validate(CalendarDate date)

Description copied from class: CalendarSystem

Checks whether the calendar fields specified by date represents a valid date and time in this calendar system. If the given date is valid, date is marked as normalized.

Specified by:

validate in class CalendarSystem

Parameters:

date - the CalendarDate to be validated

Returns:

true if all the calendar fields are consistent, otherwise, false is returned.

normalize

public boolean normalize(CalendarDate date)

Description copied from class: CalendarSystem

Normalizes calendar fields in the specified date. Also all undefined fields are set to correct values. The actual normalization process is calendar system dependent.

Specified by:

normalize in class CalendarSystem

Parameters:

date - the calendar date to be validated

Returns:

true if all fields have been normalized; false otherwise.

getYearLength

public int getYearLength(CalendarDate date)

Returns 366 if the specified date is in a leap year, or 365 otherwise This method does not perform the normalization with the specified CalendarDate. The CalendarDate must be normalized to get a correct value.

Specified by:

getYearLength in class CalendarSystem

Parameters:

date - a CalendarDate

Returns:

a year length in days

Throws:

java.lang.ClassCastException - if the specified date is not a BaseCalendar.Date

getYearLengthInMonths

public int getYearLengthInMonths(CalendarDate date)

Description copied from class: CalendarSystem

Returns the number of months of the specified year. This method does not perform the normalization with the specified CalendarDate. The CalendarDate must be normalized to get a correct value.

Specified by:

getYearLengthInMonths in class CalendarSystem

getMonthLength

public int getMonthLength(CalendarDate date)

Description copied from class: CalendarSystem

Returns the length in days of the month specified by the calendar date. This method does not perform the normalization with the specified calendar date. The CalendarDate must be normalized to get a correct value.

Specified by:

getMonthLength in class CalendarSystem

Parameters:

date - the date from which the month value is obtained

Returns:

the number of days in the month

getDayOfYear

public long getDayOfYear(CalendarDate date)

getFixedDate

public long getFixedDate(CalendarDate date)

Description copied from class: AbstractCalendar

Returns the fixed date calculated with the specified calendar date. If the specified date is not normalized, its date fields are normalized.

Specified by:

getFixedDate in class AbstractCalendar

Parameters:

date - a CalendarDate with which the fixed date is calculated

Returns:

the calculated fixed date

See Also:

AbstractCalendar.html#fixed_date

getFixedDate

public long getFixedDate(int year,
                         int month,
                         int dayOfMonth,
                         BaseCalendar.Date cache)

getCalendarDateFromFixedDate

public void getCalendarDateFromFixedDate(CalendarDate date,
                                         long fixedDate)

Calculates calendar fields and store them in the specified CalendarDate.

Specified by:

getCalendarDateFromFixedDate in class AbstractCalendar

Parameters:

date - a CalendarDate to stored the calculated calendar fields.

fixedDate - a fixed date to calculate calendar fields

See Also:

AbstractCalendar.html#fixed_date

getDayOfWeek

public int getDayOfWeek(CalendarDate date)

Returns the day of week of the given Gregorian date.

getDayOfWeekFromFixedDate

public static final int getDayOfWeekFromFixedDate(long fixedDate)

getYearFromFixedDate

public int getYearFromFixedDate(long fixedDate)

isLeapYear

protected boolean isLeapYear(CalendarDate date)

Specified by:

isLeapYear in class AbstractCalendar

Returns:

true if the specified year is a Gregorian leap year, or false otherwise.

See Also:

BaseCalendar#isGregorianLeapYear