com.ibm.icu.util

Class BuddhistCalendar

java.lang.Object

com.ibm.icu.util.Calendar

com.ibm.icu.util.GregorianCalendar

com.ibm.icu.util.BuddhistCalendar

All Implemented Interfaces:

Serializable, Cloneable, Comparable<Calendar>

public class BuddhistCalendar
extends GregorianCalendar

BuddhistCalendar is a subclass of GregorianCalendar that numbers years since the birth of the Buddha. This is the civil calendar in some predominantly Buddhist countries such as Thailand, and it is used for religious purposes elsewhere.

The Buddhist calendar is identical to the Gregorian calendar in all respects except for the year and era. Years are numbered since the birth of the Buddha in 543 BC (Gregorian), so that 1 AD (Gregorian) is equivalent to 544 BE (Buddhist Era) and 1998 AD is 2541 BE.

The Buddhist Calendar has only one allowable era: BE. If the calendar is not in lenient mode (see setLenient), dates before 1/1/1 BE are rejected with an IllegalArgumentException.

This class should not be subclassed.

BuddhistCalendar usually should be instantiated using Calendar.getInstance(ULocale) passing in a ULocale with the tag "@calendar=buddhist".

Author:

Laura Werner, Alan Liu

See Also:

Calendar, GregorianCalendar, Serialized Form

Status:

Stable ICU 2.8.

Nested Class Summary

Nested classes/interfaces inherited from class com.ibm.icu.util.Calendar

Calendar.FormatConfiguration, Calendar.WeekData

Field Summary

Fields

Modifier and Type	Field and Description
static int	BE Constant for the Buddhist Era.

Fields inherited from class com.ibm.icu.util.GregorianCalendar

AD, BC, invertGregorian, isGregorian

Fields inherited from class com.ibm.icu.util.Calendar

AM, AM_PM, APRIL, AUGUST, BASE_FIELD_COUNT, 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_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, 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

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

Method Summary

Modifier and Type	Method and Description
String	getType() [icu] Returns the calendar type name string for this Calendar object.
protected void	handleComputeFields(int julianDay) Override Calendar to compute several fields specific to the hybrid Gregorian-Julian calendar system.
protected int	handleComputeMonthStart(int eyear, int month, boolean useMonth) Return JD of start of given month/year
protected int	handleGetExtendedYear() Returns the extended year defined by the current fields.
protected int	handleGetLimit(int field, int limitType) Override GregorianCalendar.
protected boolean	isEra0CountingBackward() Deprecated. This API is ICU internal only.

Methods inherited from class com.ibm.icu.util.GregorianCalendar

getActualMaximum, getActualMinimum, getGregorianChange, handleComputeJulianDay, handleGetMonthLength, handleGetYearLength, hashCode, isEquivalentTo, isLeapYear, roll, setGregorianChange

Methods inherited from class com.ibm.icu.util.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, 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, getRepeatedWallTimeOption, getSkippedWallTimeOption, getStamp, getTemporalMonthCode, getTime, getTimeInMillis, getTimeZone, getWeekData, getWeekDataForRegion, getWeekendTransition, gregorianMonthLength, gregorianPreviousMonthLength, handleCreateFields, handleGetDateFormat, handleGetDateFormat, handleGetDateFormat, handleGetDateFormat, haveDefaultCentury, inTemporalLeapYear, internalGet, internalGet, internalGetMonth, internalGetMonth, internalGetTimeInMillis, internalSet, isGregorianLeapYear, isLenient, isSet, isWeekend, isWeekend, julianDayToDayOfWeek, julianDayToMillis, millisToJulianDay, newerField, newestStamp, pinField, prepareGetActual, resolveFields, roll, set, set, set, set, setFirstDayOfWeek, setLenient, setMinimalDaysInFirstWeek, setRelatedYear, setRepeatedWallTimeOption, setSkippedWallTimeOption, setTemporalMonthCode, setTime, setTimeInMillis, setTimeZone, setWeekData, toString, validateField, validateField, validateFields, weekNumber, weekNumber

Methods inherited from class java.lang.Object

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

Field Detail

BE

public static final int BE

Constant for the Buddhist Era. This is the only allowable ERA value for the Buddhist calendar.

See Also:

Calendar.ERA, Constant Field Values

Status:

Stable ICU 2.8.

Constructor Detail

BuddhistCalendar

public BuddhistCalendar()

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

Status:

Stable ICU 2.8.

BuddhistCalendar

public BuddhistCalendar(TimeZone zone)

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

Parameters:

zone - the given time zone.

Status:

Stable ICU 2.8.

BuddhistCalendar

public BuddhistCalendar(Locale aLocale)

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

Parameters:

aLocale - the given locale.

Status:

Stable ICU 2.8.

BuddhistCalendar

public BuddhistCalendar(ULocale locale)

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

Parameters:

locale - the given ulocale.

Status:

Stable ICU 3.2.

BuddhistCalendar

public BuddhistCalendar(TimeZone zone,
                        Locale aLocale)

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

Parameters:

zone - the given time zone.

aLocale - the given locale.

Status:

Stable ICU 2.8.

BuddhistCalendar

public BuddhistCalendar(TimeZone zone,
                        ULocale locale)

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

Parameters:

zone - the given time zone.

locale - the given ulocale.

Status:

Stable ICU 3.2.

BuddhistCalendar

public BuddhistCalendar(Date date)

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

Parameters:

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

Status:

Stable ICU 2.8.

BuddhistCalendar

public BuddhistCalendar(int year,
                        int month,
                        int date)

Constructs a BuddhistCalendar with the given date set in the default time zone with the default 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 January.

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

Status:

Stable ICU 2.8.

BuddhistCalendar

public BuddhistCalendar(int year,
                        int month,
                        int date,
                        int hour,
                        int minute,
                        int second)

Constructs a BuddhistCalendar with the given date and time set for the default time zone with the default 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 January.

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.

Status:

Stable ICU 2.8.

Method Detail

handleGetExtendedYear

protected int handleGetExtendedYear()

Description copied from class: Calendar

Returns the extended year defined by the current fields. This will use the EXTENDED_YEAR field or the YEAR and supra-year fields (such as ERA) specific to the calendar system, depending on which set of fields is newer.

Overrides:

handleGetExtendedYear in class GregorianCalendar

Returns:

the extended year

Status:

Stable ICU 2.8.

handleComputeMonthStart

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

Description copied from class: GregorianCalendar

Return JD of start of given month/year

Overrides:

handleComputeMonthStart in class GregorianCalendar

Parameters:

eyear - the extended year

month - 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

Status:

Stable ICU 2.8.

handleComputeFields

protected void handleComputeFields(int julianDay)

Description copied from class: GregorianCalendar

Override Calendar to compute several fields specific to the hybrid Gregorian-Julian calendar system. These are:

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

Overrides:

handleComputeFields in class GregorianCalendar

Status:

Stable ICU 2.8.

handleGetLimit

protected int handleGetLimit(int field,
                             int limitType)

Override GregorianCalendar. There is only one Buddhist ERA. We should really handle YEAR, YEAR_WOY, and EXTENDED_YEAR here too to implement the 1..5000000 range, but it's not critical.

Overrides:

handleGetLimit in class GregorianCalendar

Parameters:

field - one of the above field numbers

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

Status:

Stable ICU 2.8.

getType

public String getType()

[icu] Returns the calendar type name string for this Calendar object. The returned string is the legacy ICU calendar attribute value, for example, "gregorian" or "japanese".

See type="old type name" for the calendar attribute of locale IDs at http://www.unicode.org/reports/tr35/#Key_Type_Definitions

Overrides:

getType in class GregorianCalendar

Returns:

legacy calendar type name string

Status:

Stable ICU 3.8.

isEra0CountingBackward

@Deprecated
protected boolean isEra0CountingBackward()

Deprecated. This API is ICU internal only.

The year in this calendar is counting from 1 backward if the era is 0.

Overrides:

isEra0CountingBackward in class GregorianCalendar

Returns:

The year in era 0 of this calendar is counting backward from 1.

Status:

Internal. This API is ICU internal only.