TaiwanCalendar
public
class
TaiwanCalendar
extends GregorianCalendar
java.lang.Object | |||
↳ | android.icu.util.Calendar | ||
↳ | android.icu.util.GregorianCalendar | ||
↳ | android.icu.util.TaiwanCalendar |
TaiwanCalendar
is a subclass of GregorianCalendar
that numbers years since 1912.
The Taiwan calendar is identical to the Gregorian calendar in all respects except for the year and era. Years are numbered since 1912 AD (Gregorian).
The Taiwan Calendar has one era: MINGUO
.
This class should not be subclassed.
TaiwanCalendar usually should be instantiated using
Calendar.getInstance(ULocale)
passing in a ULocale
with the tag "@calendar=roc"
.
See also:
Summary
Constants | |
---|---|
int |
BEFORE_MINGUO
Constant for the Taiwan Era for years before Minguo 1. |
int |
MINGUO
Constant for the Taiwan Era for Minguo. |
Inherited constants |
---|
Inherited fields |
---|
Public constructors | |
---|---|
TaiwanCalendar()
Constructs a |
|
TaiwanCalendar(TimeZone zone)
Constructs a |
|
TaiwanCalendar(TimeZone zone, ULocale locale)
Constructs a |
|
TaiwanCalendar(TimeZone zone, Locale aLocale)
Constructs a |
|
TaiwanCalendar(ULocale locale)
Constructs a |
|
TaiwanCalendar(int year, int month, int date)
Constructs a |
|
TaiwanCalendar(int year, int month, int date, int hour, int minute, int second)
Constructs a TaiwanCalendar with the given date and time set for the default time zone with the default locale. |
|
TaiwanCalendar(Date date)
Constructs a |
|
TaiwanCalendar(Locale aLocale)
Constructs a |
Public methods | |
---|---|
String
|
getType()
[icu] Returns the calendar type name string for this Calendar object. |
Protected methods | |
---|---|
void
|
handleComputeFields(int julianDay)
Override Calendar to compute several fields specific to the hybrid Gregorian-Julian calendar system. |
int
|
handleGetExtendedYear()
Returns the extended year defined by the current fields. |
int
|
handleGetLimit(int field, int limitType)
Override GregorianCalendar. |
Inherited methods | |
---|---|
Constants
BEFORE_MINGUO
public static final int BEFORE_MINGUO
Constant for the Taiwan Era for years before Minguo 1. Before Minuo 1 is Gregorian 1911, Before Minguo 2 is Gregorian 1910 and so on.
See also:
Constant Value: 0 (0x00000000)
MINGUO
public static final int MINGUO
Constant for the Taiwan Era for Minguo. Minguo 1 is 1912 in Gregorian calendar.
See also:
Constant Value: 1 (0x00000001)
Public constructors
TaiwanCalendar
public TaiwanCalendar ()
Constructs a TaiwanCalendar
using the current time
in the default time zone with the default locale.
TaiwanCalendar
public TaiwanCalendar (TimeZone zone)
Constructs a TaiwanCalendar
based on the current time
in the given time zone with the default locale.
Parameters | |
---|---|
zone |
TimeZone : the given time zone. |
TaiwanCalendar
public TaiwanCalendar (TimeZone zone, ULocale locale)
Constructs a TaiwanCalendar
based on the current time
in the given time zone with the given locale.
Parameters | |
---|---|
zone |
TimeZone : the given time zone. |
locale |
ULocale : the given ulocale. |
TaiwanCalendar
public TaiwanCalendar (TimeZone zone, Locale aLocale)
Constructs a TaiwanCalendar
based on the current time
in the given time zone with the given locale.
Parameters | |
---|---|
zone |
TimeZone : the given time zone. |
aLocale |
Locale |
TaiwanCalendar
public TaiwanCalendar (ULocale locale)
Constructs a TaiwanCalendar
based on the current time
in the default time zone with the given locale.
Parameters | |
---|---|
locale |
ULocale : the given ulocale. |
TaiwanCalendar
public TaiwanCalendar (int year, int month, int date)
Constructs a TaiwanCalendar
with the given date set
in the default time zone with the default locale.
Parameters | |
---|---|
year |
int : The value used to set the calendar's YEAR time field. |
month |
int : The value used to set the calendar's MONTH time field.
The value is 0-based. e.g., 0 for January. |
date |
int : The value used to set the calendar's DATE time field. |
TaiwanCalendar
public TaiwanCalendar (int year, int month, int date, int hour, int minute, int second)
Constructs a TaiwanCalendar with the given date and time set for the default time zone with the default locale.
Parameters | |
---|---|
year |
int : The value used to set the calendar's YEAR time field. |
month |
int : The value used to set the calendar's MONTH time field.
The value is 0-based. e.g., 0 for January. |
date |
int : The value used to set the calendar's DATE time field. |
hour |
int : The value used to set the calendar's HOUR_OF_DAY time field. |
minute |
int : The value used to set the calendar's MINUTE time field. |
second |
int : The value used to set the calendar's SECOND time field. |
TaiwanCalendar
public TaiwanCalendar (Date date)
Constructs a TaiwanCalendar
with the given date set
in the default time zone with the default locale.
Parameters | |
---|---|
date |
Date : The date to which the new calendar is set. |
TaiwanCalendar
public TaiwanCalendar (Locale aLocale)
Constructs a TaiwanCalendar
based on the current time
in the default time zone with the given locale.
Parameters | |
---|---|
aLocale |
Locale : the given locale. |
Public methods
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
Returns | |
---|---|
String |
legacy calendar type name string |
Protected methods
handleComputeFields
protected void handleComputeFields (int julianDay)
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
Parameters | |
---|---|
julianDay |
int |
handleGetExtendedYear
protected int handleGetExtendedYear ()
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.
Returns | |
---|---|
int |
the extended year |
handleGetLimit
protected int handleGetLimit (int field, int limitType)
Override GregorianCalendar. There is only one Taiwan ERA. We should really handle YEAR, YEAR_WOY, and EXTENDED_YEAR here too to implement the 1..5000000 range, but it's not critical.
Parameters | |
---|---|
field |
int : one of the above field numbers |
limitType |
int : one of MINIMUM , GREATEST_MINIMUM ,
LEAST_MAXIMUM , or MAXIMUM |
Returns | |
---|---|
int |