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

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 using the current time in the default time zone with the default locale.

TaiwanCalendar(TimeZone zone)

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

TaiwanCalendar(TimeZone zone, ULocale locale)

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

TaiwanCalendar(TimeZone zone, Locale aLocale)

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

TaiwanCalendar(ULocale locale)

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

TaiwanCalendar(int year, int month, int date)

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

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 with the given date set in the default time zone with the default locale.

TaiwanCalendar(Locale aLocale)

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

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

Added in API level 24
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

Added in API level 24
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

Added in API level 24
public TaiwanCalendar ()

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

TaiwanCalendar

Added in API level 24
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

Added in API level 24
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

Added in API level 24
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

Added in API level 24
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

Added in API level 24
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

Added in API level 24
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

Added in API level 24
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

Added in API level 24
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

Added in API level 24
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

Added in API level 24
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

Added in API level 24
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

Added in API level 24
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