public class JapaneseCalendar
extends GregorianCalendar
java.lang.Object | |||
↳ | android.icu.util.Calendar | ||
↳ | android.icu.util.GregorianCalendar | ||
↳ | android.icu.util.JapaneseCalendar |
JapaneseCalendar
是的子类GregorianCalendar
那数字年和时代的基础上,日本天皇的统治。 除了年份和时代以外,日历在各个方面都与公历相同。 每个皇帝的升天开始了一个新的时代,那个时代的年代从第一年的提升年开始编号。
请注意,在皇帝提升的年份,有两套可能的年代和时代价值观:旧时代和新时代。 例如,1989年1月7日AD开始了一个新时代。 严格来说,那年的前六天是在昭和时代,例如“昭和64年1月6日”,而今年的其余时间是在平成时代,例如“1月7日,1岁”。 这个类在计算日期时正确处理这种区别。 但是,在宽松模式下,任何形式的日期都可以作为输入。
近代以来,公元1868年1月8日,明治,1912年7月30日(大正),1926年12月25日(昭和),1989年1月7日(平成)开始实施。 这个时期的常量,适用于ERA
领域,在这个课程中提供。 请注意,每个时代使用的数字或多或少都是任意的。 目前,公元1053年开始的时代是#0时代; 然而,随着我们添加更多历史数据,这可能会在未来发生变化。 使用预定义的常量而不是使用实际的绝对数字。
这个类不应该被分类。
JapaneseCalendar通常应该使用 getInstance(ULocale)
实例化, ULocale
的标签为 "@calendar=japanese"
。
也可以看看:
Inherited constants |
---|
From class android.icu.util.GregorianCalendar
|
From class android.icu.util.Calendar
|
Fields |
|
---|---|
public static final int |
CURRENT_ERA |
public static final int |
HEISEI 1月份开始的时代不变。 |
public static final int |
MEIJI 9月份开始的时代不变。 |
public static final int |
SHOWA 不断为12月开始的时代。 |
public static final int |
TAISHO 公元1912年7月30日开始的时代不变。 |
Inherited fields |
---|
From class android.icu.util.GregorianCalendar
|
From class android.icu.util.Calendar
|
Public constructors |
|
---|---|
JapaneseCalendar() 使用缺省语言环境的默认时区中的当前时间构造默认 |
|
JapaneseCalendar(TimeZone zone) 根据给定时区中的当前时间以默认语言环境构造 |
|
JapaneseCalendar(Locale aLocale) 根据给定语言环境的默认时区中的当前时间构造 |
|
JapaneseCalendar(ULocale locale) 根据给定语言环境的默认时区中的当前时间构造 |
|
JapaneseCalendar(TimeZone zone, Locale aLocale) 基于给定语言环境给定时区中的当前时间构造 |
|
JapaneseCalendar(TimeZone zone, ULocale locale) 根据给定语言环境给定时区中的当前时间构造一个 |
|
JapaneseCalendar(Date date) 使用缺省语言环境在默认时区中设置的给定日期构造 |
|
JapaneseCalendar(int era, int year, int month, int date) 使用缺省区域设置在默认时区中设置的给定日期构造 |
|
JapaneseCalendar(int year, int month, int date) 使用缺省区域设置在默认时区中设置的给定日期构造 |
|
JapaneseCalendar(int year, int month, int date, int hour, int minute, int second) 使用默认语言环境为默认时区设置的给定日期和时间构造 |
Public methods |
|
---|---|
int |
getActualMaximum(int field) 给定当前日期,返回此字段可能具有的最大值。 |
String |
getType() [icu]返回此Calendar对象的日历类型名称字符串。 |
Protected methods |
|
---|---|
void |
handleComputeFields(int julianDay) 重写日历以计算特定于混合公历 - 儒略历日历系统的几个字段。 |
int |
handleGetExtendedYear() 返回当前字段定义的扩展年份。 |
int |
handleGetLimit(int field, int limitType) 覆盖GregorianCalendar。 |
Inherited methods |
|
---|---|
From class android.icu.util.GregorianCalendar
|
|
From class android.icu.util.Calendar
|
|
From class java.lang.Object
|
|
From interface java.lang.Comparable
|
JapaneseCalendar ()
使用缺省语言环境的默认时区中的当前时间构造默认 JapaneseCalendar
。
JapaneseCalendar (TimeZone zone)
根据给定时区中的当前时间以默认语言环境构造 JapaneseCalendar
。
Parameters | |
---|---|
zone |
TimeZone : the given time zone. |
JapaneseCalendar (Locale aLocale)
根据给定语言环境的默认时区中的当前时间构造 JapaneseCalendar
。
Parameters | |
---|---|
aLocale |
Locale : the given locale. |
JapaneseCalendar (ULocale locale)
根据给定语言环境的默认时区中的当前时间构造 JapaneseCalendar
。
Parameters | |
---|---|
locale |
ULocale : the given ulocale. |
JapaneseCalendar (TimeZone zone, Locale aLocale)
基于给定语言环境给定时区内的当前时间构造 JapaneseCalendar
。
Parameters | |
---|---|
zone |
TimeZone : the given time zone. |
aLocale |
Locale : the given locale. |
JapaneseCalendar (TimeZone zone, ULocale locale)
根据给定语言环境给定时区内的当前时间构造一个 JapaneseCalendar
。
Parameters | |
---|---|
zone |
TimeZone : the given time zone. |
locale |
ULocale : the given ulocale. |
JapaneseCalendar (Date date)
使用缺省区域设置在默认时区中设置的给定日期构造 JapaneseCalendar
。
Parameters | |
---|---|
date |
Date : The date to which the new calendar is set. |
JapaneseCalendar (int era, int year, int month, int date)
使用缺省区域设置在缺省时区中设置的给定日期构造 JapaneseCalendar
。
Parameters | |
---|---|
era |
int : The imperial era used to set the calendar's ERA field. Eras are numbered starting with the Tenki era, which began in 1053 AD Gregorian, as era zero. Recent eras can be specified using the constants MEIJI (which started in 1868 AD), TAISHO (1912 AD), SHOWA (1926 AD), and HEISEI (1989 AD). |
year |
int : The value used to set the calendar's YEAR field, in terms of the era. |
month |
int : The value used to set the calendar's MONTH field. The value is 0-based. e.g., 0 for January. |
date |
int : The value used to set the calendar's DATE field. |
JapaneseCalendar (int year, int month, int date)
使用缺省区域设置在缺省时区中设置的给定日期构造 JapaneseCalendar
。
Parameters | |
---|---|
year |
int : The value used to set the calendar's YEAR field, in the era Heisei, the most current at the time this class was last updated. |
month |
int : The value used to set the calendar's MONTH field. The value is 0-based. e.g., 0 for January. |
date |
int : The value used to set the calendar's DATE field. |
JapaneseCalendar (int year, int month, int date, int hour, int minute, int second)
使用默认语言环境为默认时区设置的给定日期和时间构造 JapaneseCalendar
。
Parameters | |
---|---|
year |
int : The value used to set the calendar's YEAR time field, in the era Heisei, the most current at the time of this writing. |
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. |
int getActualMaximum (int field)
给定当前日期,返回此字段可能具有的最大值。 例如,在日期“1997年2月3日”和DAY_OF_MONTH字段中,实际最大值为28; 对于“1996年2月3日”,它是29.同样对于希伯来语日历,几年来,MONTH的实际最大值是12,对于其他13。
Parameters | |
---|---|
field |
int : the field whose maximum is desired |
Returns | |
---|---|
int |
the maximum of the given field for the current date of this calendar |
String getType ()
[icu]返回此Calendar对象的日历类型名称字符串。 返回的字符串是传统的ICU日历属性值,例如“gregorian”或“japanese”。
请参阅http://www.unicode.org/reports/tr35/#Key_Type_Definitions中有关语言环境ID的日历属性的type =“old type name”
Returns | |
---|---|
String |
legacy calendar type name string |
void handleComputeFields (int julianDay)
重写日历以计算特定于混合公历 - 儒略历日历系统的几个字段。 这些是:
Parameters | |
---|---|
julianDay |
int
|
int handleGetExtendedYear ()
返回当前字段定义的扩展年份。 这将使用EXTENDED_YEAR字段或特定于日历系统的YEAR和超年字段(如ERA),具体取决于哪一组字段较新。
Returns | |
---|---|
int |
the extended year |
int handleGetLimit (int field, int limitType)
覆盖GregorianCalendar。 我们应该在这里处理YEAR_WOY和EXTENDED_YEAR以实现1..5000000的范围,但这并不重要。
Parameters | |
---|---|
field |
int : one of the above field numbers |
limitType |
int : one of MINIMUM , GREATEST_MINIMUM , LEAST_MAXIMUM , or MAXIMUM |
Returns | |
---|---|
int |