Most visited

Recently visited

Results for

Added in API level 24

GregorianCalendar

public class GregorianCalendar
extends Calendar

java.lang.Object
	android.icu.util.Calendar
		android.icu.util.GregorianCalendar

Known Direct Subclasses

BuddhistCalendar, JapaneseCalendar, TaiwanCalendar

[icu增强] ICU的替代GregorianCalendar 。 ICU特有的方法，字段和其他功能标记为“ [icu] ”。

GregorianCalendar是的具体子 Calendar ，并提供了世界上大多数国家使用的标准日历。

标准（格里高利）日历有2个时代，BC和AD。

这个实现处理单个不连续性，默认情况下对应于公历日期（1582年10月15日在某些国家，后来在其他国家）。调用者可以通过调用setGregorianChange()来更改转换日期。

从历史上看，在那些首先采用公历的国家，1582年10月4日之后是1582年10月15日。这个日历正确地模拟了这一点。在公历转换之前， GregorianCalendar实现了儒略历。格里历和儒略历之间的唯一区别是闰年规则。朱利安历法规定了每四年的闰年，而公历年则忽略了不能被400整除的世纪年。

GregorianCalendar实现proleptic格里高利历和罗马儒略历。也就是说，日期的计算是通过将现有规则无限期地向前和向后推断。因此，所有年份均可使用GregorianCalendar来产生有意义且一致的结果。然而，使用GregorianCalendar获得的日期GregorianCalendar是准确的，只有从公元4年3月1日开始，现代儒略日历规则才被采用。在此之前，闰年规则不规则地适用，并且在公元前45年之前，朱利安日历甚至不存在。

在公历之前，元旦是3月25日。为避免混淆，该日历始终使用1月1日。如果需要，格里高利转换之前的日期和1月1日和3月24日。

为WEEK_OF_YEAR字段计算的值范围为1到53.第1周是从getFirstDayOfWeek()开始的最早的七天期间，其中包含至少getMinimalDaysInFirstWeek()天的该年。因而它取决于的值getMinimalDaysInFirstWeek() ， getFirstDayOfWeek() ，和1月1日周的周中的一个年的1周和周次年1按顺序编号从2到52或53（如需要）之间的那一天。

例如，1998年1月1日是星期四。如果getFirstDayOfWeek()是MONDAY和getMinimalDaysInFirstWeek()是4（这些是反映ISO 8601和许多国家标准的值），那么1998年的第1周从1997年12月29日开始，到1998年1月4日结束。但是，如果getFirstDayOfWeek()是SUNDAY ，那么1998年第1周从1998年1月4日开始，到1998年1月10日结束; 1998年的前三天是1997年第53周的一部分。

为WEEK_OF_MONTH字段范围计算的值范围从0或1到4或5.一个月的第1周（具有WEEK_OF_MONTH = 1 ）是最早的一组，该月的至少getMinimalDaysInFirstWeek()个连续日期，在getFirstDayOfWeek()前一天结束。与一年的第1周不同，一个月的第1周可能短于7天，不需要从getFirstDayOfWeek()开始，并且不包括上个月的天数。第1周前一个月的天数为WEEK_OF_MONTH 。

例如，如果 getFirstDayOfWeek()是 SUNDAY而 getMinimalDaysInFirstWeek()是4，那么1998年1月的第一周是1月4日星期日到1月10日星期六。这些日子的 WEEK_OF_MONTH是1.这个月的1月1日星期四到1月3日星期六有 WEEK_OF_MONTH为0.如果 getMinimalDaysInFirstWeek()更改为3，则1月1日至1月3日的 WEEK_OF_MONTH为1。

例：

 // get the supported ids for GMT-08:00 (Pacific Standard Time)
 String[] ids = TimeZone.getAvailableIDs(-8 * 60 * 60 * 1000);
 // if no ids were returned, something is wrong. get out.
 if (ids.length == 0)
     System.exit(0);

  // begin output
 System.out.println("Current Time");

 // create a Pacific Standard Time time zone
 SimpleTimeZone pdt = new SimpleTimeZone(-8 * 60 * 60 * 1000, ids[0]);

 // set up rules for daylight savings time
 pdt.setStartRule(Calendar.MARCH, 2, Calendar.SUNDAY, 2 * 60 * 60 * 1000);
 pdt.setEndRule(Calendar.NOVEMBER, 1, Calendar.SUNDAY, 2 * 60 * 60 * 1000);

 // create a GregorianCalendar with the Pacific Daylight time zone
 // and the current date and time
 Calendar calendar = new GregorianCalendar(pdt);
 Date trialTime = new Date();
 calendar.setTime(trialTime);

 // print out a bunch of interesting things
 System.out.println("ERA: " + calendar.get(Calendar.ERA));
 System.out.println("YEAR: " + calendar.get(Calendar.YEAR));
 System.out.println("MONTH: " + calendar.get(Calendar.MONTH));
 System.out.println("WEEK_OF_YEAR: " + calendar.get(Calendar.WEEK_OF_YEAR));
 System.out.println("WEEK_OF_MONTH: " + calendar.get(Calendar.WEEK_OF_MONTH));
 System.out.println("DATE: " + calendar.get(Calendar.DATE));
 System.out.println("DAY_OF_MONTH: " + calendar.get(Calendar.DAY_OF_MONTH));
 System.out.println("DAY_OF_YEAR: " + calendar.get(Calendar.DAY_OF_YEAR));
 System.out.println("DAY_OF_WEEK: " + calendar.get(Calendar.DAY_OF_WEEK));
 System.out.println("DAY_OF_WEEK_IN_MONTH: "
                    + calendar.get(Calendar.DAY_OF_WEEK_IN_MONTH));
 System.out.println("AM_PM: " + calendar.get(Calendar.AM_PM));
 System.out.println("HOUR: " + calendar.get(Calendar.HOUR));
 System.out.println("HOUR_OF_DAY: " + calendar.get(Calendar.HOUR_OF_DAY));
 System.out.println("MINUTE: " + calendar.get(Calendar.MINUTE));
 System.out.println("SECOND: " + calendar.get(Calendar.SECOND));
 System.out.println("MILLISECOND: " + calendar.get(Calendar.MILLISECOND));
 System.out.println("ZONE_OFFSET: "
                    + (calendar.get(Calendar.ZONE_OFFSET)/(60*60*1000)));
 System.out.println("DST_OFFSET: "
                    + (calendar.get(Calendar.DST_OFFSET)/(60*60*1000)));

 System.out.println("Current Time, with hour reset to 3");
 calendar.clear(Calendar.HOUR_OF_DAY); // so doesn't override
 calendar.set(Calendar.HOUR, 3);
 System.out.println("ERA: " + calendar.get(Calendar.ERA));
 System.out.println("YEAR: " + calendar.get(Calendar.YEAR));
 System.out.println("MONTH: " + calendar.get(Calendar.MONTH));
 System.out.println("WEEK_OF_YEAR: " + calendar.get(Calendar.WEEK_OF_YEAR));
 System.out.println("WEEK_OF_MONTH: " + calendar.get(Calendar.WEEK_OF_MONTH));
 System.out.println("DATE: " + calendar.get(Calendar.DATE));
 System.out.println("DAY_OF_MONTH: " + calendar.get(Calendar.DAY_OF_MONTH));
 System.out.println("DAY_OF_YEAR: " + calendar.get(Calendar.DAY_OF_YEAR));
 System.out.println("DAY_OF_WEEK: " + calendar.get(Calendar.DAY_OF_WEEK));
 System.out.println("DAY_OF_WEEK_IN_MONTH: "
                    + calendar.get(Calendar.DAY_OF_WEEK_IN_MONTH));
 System.out.println("AM_PM: " + calendar.get(Calendar.AM_PM));
 System.out.println("HOUR: " + calendar.get(Calendar.HOUR));
 System.out.println("HOUR_OF_DAY: " + calendar.get(Calendar.HOUR_OF_DAY));
 System.out.println("MINUTE: " + calendar.get(Calendar.MINUTE));
 System.out.println("SECOND: " + calendar.get(Calendar.SECOND));
 System.out.println("MILLISECOND: " + calendar.get(Calendar.MILLISECOND));
 System.out.println("ZONE_OFFSET: "
        + (calendar.get(Calendar.ZONE_OFFSET)/(60*60*1000))); // in hours
 System.out.println("DST_OFFSET: "
        + (calendar.get(Calendar.DST_OFFSET)/(60*60*1000))); // in hours

通常应使用 getInstance(ULocale)传递 ULocale与标记 "@calendar=gregorian"来实例化 "@calendar=gregorian" 。

也可以看看：

Calendar
TimeZone

摘要(Summary)

常量(Constants)
`int`	`AD` `ERA`字段的值表示共同时代（Anno Domini），也被称为CE。
`int`	`BC` `ERA`字段的值表示共同时代之前（基督之前）的时期，也被称为BCE。

Inherited constants

From class android.icu.util.Calendar

`int`	`AM` `AM_PM`字段的值表示从午夜到中午之前的一天的时段。
`int`	`AM_PM` `get`和 `set`字段编号，指示 `HOUR`是在中午之前还是之后。
`int`	`APRIL` 指示一年中的第四个月的 `MONTH`字段的值。
`int`	`AUGUST` `MONTH`字段的值表示一年中的第八个月。
`int`	`BASE_FIELD_COUNT` 此类定义的字段数。
`int`	`DATE` `get`和 `set`字段编号，指示月份的当天。
`int`	`DAY_OF_MONTH` `get`和 `set`字段编号，指示月份的当天。
`int`	`DAY_OF_WEEK` 表示星期几的 `get`和 `set`字段编号。
`int`	`DAY_OF_WEEK_IN_MONTH` `get`和 `set`字段编号，指示当前月份中一周的第几天的序号。
`int`	`DAY_OF_YEAR` `get`和 `set`字段编号，指示当年的日期编号。
`int`	`DECEMBER` `MONTH`字段的值表示一年中的第十二个月。
`int`	`DOW_LOCAL` [icu] `get()`和 `set()`字段编号，指示当地的当天。
`int`	`DST_OFFSET` `get`和 `set`字段编号，指示以毫秒为单位的夏令时偏移量。
`int`	`EPOCH_JULIAN_DAY` 这个时代的Julian日，即1970年1月1日的公历日。
`int`	`ERA` 表示时代的 `get`和 `set`字段编号，例如Julian日历中的AD或BC。
`int`	`EXTENDED_YEAR` [icu] `get()`和 `set()`字段数字，表示延长的年份。
`int`	`FEBRUARY` 指示一年中第二个月的 `MONTH`字段的值。
`int`	`FRIDAY` 指示星期五的 `DAY_OF_WEEK`字段的值。
`int`	`GREATEST_MINIMUM` 限制类型为 `getLimit()`和 `handleGetLimit()`指示字段可以采用的最大最小值。
`int`	`HOUR` `get`和 `set`字段编号表示上午或下午的小时。
`int`	`HOUR_OF_DAY` `get`和 `set`字段编号指示当天的小时。
`int`	`INTERNALLY_SET` 时间戳 `stamp[]`值表示已经通过时间或其他字段的计算设置了一个字段。
`int`	`IS_LEAP_MONTH` [icu]指示当前月份是否为闰月的字段。
`int`	`JANUARY` `MONTH`字段的值表示一年中的第一个月。
`int`	`JAN_1_1_JULIAN_DAY` 格里历时代的Julian日，即公历1月1日1日。
`int`	`JULIAN_DAY` [icu] `get()`和 `set()`字段编号，指示修改的Julian日数。
`int`	`JULY` `MONTH`字段的值表示一年中的第七个月。
`int`	`JUNE` `MONTH`字段的值表示一年中的第六个月。
`int`	`LEAST_MAXIMUM` 限制类型为 `getLimit()`和 `handleGetLimit()`指示字段可以采用的最小值。
`int`	`MARCH` `MONTH`字段的值表示一年中的第三个月。
`int`	`MAXIMUM` 限制类型 `getLimit()`和 `handleGetLimit()`指示字段可以采用的最大值（最大值）。
`int`	`MAX_FIELD_COUNT` 可能的最大数量的字段。
`int`	`MAX_JULIAN` 最大支持的朱利安日。
`long`	`MAX_MILLIS` 支持的最大纪元毫秒数。
`int`	`MAY` 指示一年中的第五个月的 `MONTH`字段的值。
`int`	`MILLISECOND` `get`和 `set`字段编号指示第二秒内的毫秒数。
`int`	`MILLISECONDS_IN_DAY` [icu] `get()`和 `set()`字段编号，指示当天的毫秒数。
`int`	`MINIMUM` 限制类型为 `getLimit()`和 `handleGetLimit()`指示字段可以采用的最小值（最小值）。
`int`	`MINIMUM_USER_STAMP` 如果时间戳 `stamp[]`的值大于或等于 `MINIMUM_USER_SET`则它已由用户通过调用 `set()`来 `set()` 。
`int`	`MINUTE` 指示一小时内分钟的 `get`和 `set`字段编号。
`int`	`MIN_JULIAN` 最低支持的Julian日。
`long`	`MIN_MILLIS` 支持的最小时间毫秒数。
`int`	`MONDAY` 指示星期一的 `DAY_OF_WEEK`字段的值。
`int`	`MONTH` 指示月份的字段号为 `get`和 `set` 。
`int`	`NOVEMBER` 指示一年中的第十一个月的 `MONTH`字段的值。
`int`	`OCTOBER` `MONTH`字段的值表示一年中的第十个月。
`long`	`ONE_DAY` 一天中的毫秒数。
`int`	`ONE_HOUR` 一小时内的毫秒数。
`int`	`ONE_MINUTE` 一分钟内的毫秒数。
`int`	`ONE_SECOND` 一秒钟内的毫秒数。
`long`	`ONE_WEEK` 一周内的毫秒数。
`int`	`PM` `AM_PM`字段的值表示从中午到午夜之前的一天中的时段。
`int`	`RESOLVE_REMAP` 对重新映射的解析表字段值进行或运算的值。
`int`	`SATURDAY` 指示星期六的 `DAY_OF_WEEK`字段的值。
`int`	`SECOND` `get`和 `set`字段编号表示分钟内的第二个字段。
`int`	`SEPTEMBER` 指示一年中第九个月的 `MONTH`字段的值。
`int`	`SUNDAY` 指示周日的 `DAY_OF_WEEK`字段的值。
`int`	`THURSDAY` 指示星期四的 `DAY_OF_WEEK`字段的值。
`int`	`TUESDAY` 指示星期二的 `DAY_OF_WEEK`字段的值。
`int`	`UNDECIMBER` `MONTH`字段的值表示一年中的第13个月。
`int`	`UNSET` 时间戳 `stamp[]`值表示自上次调用 `clear()`以来没有设置字段。
`int`	`WALLTIME_FIRST` [icu]由 `setRepeatedWallTimeOption(int)`和 `setSkippedWallTimeOption(int)`使用的 `setRepeatedWallTimeOption(int)` ，指定不明确的墙壁时间以解释为最早的。
`int`	`WALLTIME_LAST` [icu] `setRepeatedWallTimeOption(int)`和 `setSkippedWallTimeOption(int)`使用的 `setRepeatedWallTimeOption(int)` ，指定了一个模糊的墙壁时间，以解释为最新的。
`int`	`WALLTIME_NEXT_VALID` [icu]由 `setSkippedWallTimeOption(int)`使用的选项，指定不明确的墙壁时间以解释为下一个有效的墙壁时间。
`int`	`WEDNESDAY` 指示周三的 `DAY_OF_WEEK`字段的值。
`int`	`WEEK_OF_MONTH` `get`和 `set`字段编号，指示当前月份内的星期编号。
`int`	`WEEK_OF_YEAR` `get`和 `set`字段编号，指示当前年份内的星期编号。
`int`	`YEAR` 表示年份的字段号为 `get`和 `set` 。
`int`	`YEAR_WOY` [icu] `get()`和 `set()`字段编号，指示对应于 `WEEK_OF_YEAR`字段的扩展年份。
`int`	`ZONE_OFFSET` `get`和 `set`字段编号，指示以毫秒为单位的GMT的原始偏移量。

Fields
`protected boolean`	`invertGregorian` 由handleComputeJulianDay（）和handleComputeMonthStart（）使用。
`protected boolean`	`isGregorian` 由handleComputeJulianDay（）和handleComputeMonthStart（）使用。

Inherited fields

From class android.icu.util.Calendar

Public constructors
`GregorianCalendar()` 使用默认时区中的当前时间构造默认的GregorianCalendar，默认的区域设置为 `FORMAT` 。
`GregorianCalendar(TimeZone zone)` 根据给定时区中的当前时间构造GregorianCalendar，并使用默认的 `FORMAT`语言环境。
`GregorianCalendar(Locale aLocale)` 根据给定语言环境的默认时区中的当前时间构造GregorianCalendar。
`GregorianCalendar(ULocale locale)` [icu]根据给定语言环境的默认时区中的当前时间构造GregorianCalendar。
`GregorianCalendar(TimeZone zone, Locale aLocale)` [icu]根据给定语言环境给定时区中的当前时间构造GregorianCalendar。
`GregorianCalendar(TimeZone zone, ULocale locale)` 根据给定语言环境给定时区中的当前时间构造GregorianCalendar。
`GregorianCalendar(int year, int month, int date)` 在缺省时区中使用默认的 `FORMAT`语言环境设置的给定日期构造GregorianCalendar。
`GregorianCalendar(int year, int month, int date, int hour, int minute)` 使用默认的 `FORMAT`区域设置为默认时区设置的给定日期和时间构造GregorianCalendar。
`GregorianCalendar(int year, int month, int date, int hour, int minute, int second)` 使用默认的 `FORMAT`区域设置为默认时区设置的给定日期和时间构造GregorianCalendar。

公共方法(Public methods)
`int`	`getActualMaximum(int field)` 给定当前日期，返回此字段可能具有的最大值。
`int`	`getActualMinimum(int field)` 给定当前日期，返回此字段可能具有的最小值。
`final Date`	`getGregorianChange()` 获取公历日历更改日期。
`String`	`getType()` [icu]返回此Calendar对象的日历类型名称字符串。
`int`	`hashCode()` 覆盖hashCode。
`boolean`	`isEquivalentTo(Calendar other)` 如果给定的Calendar对象与此对象相等，则返回true。
`boolean`	`isLeapYear(int year)` 确定给定年份是否为闰年。
`void`	`roll(int field, int amount)` 滚动字段的签名数量。
`void`	`setGregorianChange(Date date)` 设置GregorianCalendar更改日期。

Protected methods
`void`	`handleComputeFields(int julianDay)` 重写日历以计算特定于混合公历 - 儒略历日历系统的几个字段。
`int`	`handleComputeJulianDay(int bestField)` 子类可以覆盖这个。
`int`	`handleComputeMonthStart(int eyear, int month, boolean useMonth)` 返回给定月/年开始的JD
`int`	`handleGetExtendedYear()` 返回当前字段定义的扩展年份。
`int`	`handleGetLimit(int field, int limitType)` 用于定义不同类型限制的子类API。
`int`	`handleGetMonthLength(int extendedYear, int month)` 返回此日历系统给定扩展年的给定月份中的天数。
`int`	`handleGetYearLength(int eyear)` 返回此日历系统的给定扩展年份中的天数。

继承方法(Inherited methods)

From class android.icu.util.Calendar

`void`	`add(int field, int amount)` 使用此日历规则将已签名的金额添加到指定的字段。
`boolean`	`after(Object when)` 比较时间字段记录。
`boolean`	`before(Object when)` 比较时间字段记录。
`final void`	`clear()` 清除所有时间字段的值。
`final void`	`clear(int field)` 清除给定时间字段中的值。
`Object`	`clone()` 覆盖可复制
`int`	`compareTo(Calendar that)` 比较由两个 `Calendar`对象表示的时间（以 `Calendar` 。
`void`	`complete()` 填写时间字段列表中未设置的字段。
`void`	`computeFields()` 当前毫秒时间值转换为 `time`的字段值 `fields[]` 。
`final void`	`computeGregorianFields(int julianDay)` 从Julian日计算公历的年，月和日。
`int`	`computeGregorianMonthStart(int year, int month)` 计算公历一个月的儒略日。
`int`	`computeJulianDay()` 计算此日历字段指定的Julian日数。
`int`	`computeMillisInDay()` 从字段计算当天的毫秒数。
`void`	`computeTime()` 将 `fields[]`的当前字段值转换为毫秒时间值 `time` 。
`int`	`computeZoneOffset(long millis, int millisInDay)` 此方法可以假定已设置EXTENDED_YEAR。
`boolean`	`equals(Object obj)` 将此日历与指定的对象进行比较。
`int`	`fieldDifference(Date when, int field)` [icu]返回给定时间与此日历对象设置为的时间之间的差异。
`String`	`fieldName(int field)` 返回字段的字符串名称，用于调试和异常。
`static final int`	`floorDivide(int numerator, int denominator, int[] remainder)` 除两个整数，返回商的层数，和模数余数。
`static final int`	`floorDivide(int numerator, int denominator)` 除以两个整数，返回商的底线。
`static final long`	`floorDivide(long numerator, long denominator)` 分两个长整数，返回商的底线。
`static final int`	`floorDivide(long numerator, int denominator, int[] remainder)` 除两个整数，返回商的层数，和模数余数。
`final int`	`get(int field)` 返回给定时间字段的值。
`int`	`getActualMaximum(int field)` 给定当前日期，返回此字段可能具有的最大值。
`int`	`getActualMinimum(int field)` 给定当前日期，返回此字段可能具有的最小值。
`static Locale[]`	`getAvailableLocales()` 返回安装日历的语言环境列表。
`DateFormat`	`getDateTimeFormat(int dateStyle, int timeStyle, ULocale loc)` [icu]返回适合此日历的 `DateFormat` 。
`DateFormat`	`getDateTimeFormat(int dateStyle, int timeStyle, Locale loc)` [icu]返回适合此日历的 `DateFormat` 。
`String`	`getDisplayName(ULocale loc)` 以给定语言环境的语言返回此日历的名称。
`String`	`getDisplayName(Locale loc)` 以给定语言环境的语言返回此日历的名称。
`final int`	`getFieldCount()` [icu]返回此日历定义的字段数。
`int[][][]`	`getFieldResolutionTable()` 返回此日历的字段分辨率数组。
`int`	`getFirstDayOfWeek()` 返回一周中的第一天，其中1 = `SUNDAY`和7 = `SATURDAY` 。
`final int`	`getGreatestMinimum(int field)` 如果变化，则返回给定字段的最大最小值。
`final int`	`getGregorianDayOfMonth()` 按照 `computeGregorianFields()`计算的公历日期返回公历日期（从1开始）。
`final int`	`getGregorianDayOfYear()` 根据 `computeGregorianFields()`计算的公历日返回公历日（从1开始）。
`final int`	`getGregorianMonth()` 按照 `computeGregorianFields()`计算结果返回公历上的月份（从0开始）。
`final int`	`getGregorianYear()` 按照 `computeGregorianFields()`计算的公历年返回公历日历。
`static Calendar`	`getInstance()` 使用默认时区和区域设置返回日历。
`static Calendar`	`getInstance(Locale aLocale)` 使用默认时区和指定区域设置返回日历。
`static Calendar`	`getInstance(TimeZone zone, Locale aLocale)` 返回具有指定时区和区域设置的日历。
`static Calendar`	`getInstance(TimeZone zone, ULocale locale)` 返回具有指定时区和区域设置的日历。
`static Calendar`	`getInstance(TimeZone zone)` 使用指定的时区和默认语言环境返回日历。
`static Calendar`	`getInstance(ULocale locale)` 使用默认时区和指定区域设置返回日历。
`static final String[]`	`getKeywordValuesForLocale(String key, ULocale locale, boolean commonlyUsed)` [icu]给定一个键和一个语言环境，以一个首选顺序返回一个字符串值数组，它会产生变化。
`final int`	`getLeastMaximum(int field)` 如果变化，则返回给定字段的最小最大值。
`int`	`getLimit(int field, int limitType)` 返回一个字段的限制。
`final int`	`getMaximum(int field)` 返回给定时间字段的最大值。
`int`	`getMinimalDaysInFirstWeek()` 返回一年中第一周所需的最短日期。
`final int`	`getMinimum(int field)` 返回给定时间字段的最小值。
`int`	`getRepeatedWallTimeOption()` [icu]获取在负时区偏移转换时重复多次重复墙壁时间的行为。
`int`	`getSkippedWallTimeOption()` [icu]获取在正时区偏移转换处理跳过的墙壁时间的行为。
`final int`	`getStamp(int field)` 返回一个字段的时间戳。
`final Date`	`getTime()` 返回此日历的当前时间。
`long`	`getTimeInMillis()` 长时间返回此日历的当前时间。
`TimeZone`	`getTimeZone()` 返回时区。
`String`	`getType()` [icu]返回此Calendar对象的日历类型名称字符串。
`Calendar.WeekData`	`getWeekData()` [icu]返回简单的，不可变的类结构类来访问此日历中的周末数据。
`static Calendar.WeekData`	`getWeekDataForRegion(String region)` [icu]返回简单的，不可变的类结构类来访问CLDR周末数据。
`static final int`	`gregorianMonthLength(int y, int m)` 返回公历的一个月的长度。
`static final int`	`gregorianPreviousMonthLength(int y, int m)` 返回公历日历前一个月的长度。
`void`	`handleComputeFields(int julianDay)` 子类可以重写此方法来计算特定于每个日历系统的几个字段。
`int`	`handleComputeJulianDay(int bestField)` 子类可以覆盖这个。
`abstract int`	`handleComputeMonthStart(int eyear, int month, boolean useMonth)` 返回给定扩展年份中给定月份的第一天之前的Julian日数。
`int[]`	`handleCreateFields()` 使用超出 `Calendar`定义的字段的子类应该重写此方法以返回适当长度的 `int[]`数组。
`DateFormat`	`handleGetDateFormat(String pattern, String override, Locale locale)` 创建适合此日历的 `DateFormat` 。
`DateFormat`	`handleGetDateFormat(String pattern, ULocale locale)` 创建适合此日历的 `DateFormat` 。
`DateFormat`	`handleGetDateFormat(String pattern, Locale locale)` 创建适合此日历的 `DateFormat` 。
`abstract int`	`handleGetExtendedYear()` 返回当前字段定义的扩展年份。
`abstract int`	`handleGetLimit(int field, int limitType)` 用于定义不同类型限制的子类API。
`int`	`handleGetMonthLength(int extendedYear, int month)` 返回此日历系统给定扩展年的给定月份中的天数。
`int`	`handleGetYearLength(int eyear)` 返回此日历系统的给定扩展年份中的天数。
`int`	`hashCode()` 返回此日历的哈希码。
`final int`	`internalGet(int field)` 返回给定时间字段的值。
`final int`	`internalGet(int field, int defaultValue)` 返回给定时间字段的值，如果未设置字段，则返回给定的默认值。
`final long`	`internalGetTimeInMillis()` 返回当前毫秒数而不重新计算。
`final void`	`internalSet(int field, int value)` 将一个字段设置为一个值。
`boolean`	`isEquivalentTo(Calendar other)` [icu]如果给定的Calendar对象与此对象相等，则返回true。
`static final boolean`	`isGregorianLeapYear(int year)` 确定给定年份是否为闰年。
`boolean`	`isLenient()` 告诉日期/时间解释是否宽松。
`final boolean`	`isSet(int field)` 确定给定时间字段是否设置了值。
`boolean`	`isWeekend(Date date)` [icu]如果给定日期和时间在该日历系统的周末，则返回true。
`boolean`	`isWeekend()` [icu]如果此日历的当前日期和时间在该日历系统的周末，则返回true。
`static final int`	`julianDayToDayOfWeek(int julian)` 给定Julian日，返回从星期日到星期六的星期几。
`static final long`	`julianDayToMillis(int julian)` 每天将Julian转换为毫秒。
`static final int`	`millisToJulianDay(long millis)` 将时间转换为毫秒到Julian日。
`int`	`newerField(int defaultField, int alternateField)` 返回更新的字段，即defaultField或alternateField。
`int`	`newestStamp(int first, int last, int bestStampSoFar)` 返回给定范围的字段的最新邮票。
`void`	`pinField(int field)` 调整指定的字段，使其在日历设置日期的允许范围内。
`void`	`prepareGetActual(int field, boolean isMinimum)` 准备这个日历来计算实际的最小值或最大值。
`int`	`resolveFields(int[][][] precedenceTable)` 给定一个优先表，返回表中最新的字段组合，如果没有找到，则返回-1。
`final void`	`roll(int field, boolean up)` 在给定字段上滚动（上/下）单个时间单位。
`void`	`roll(int field, int amount)` 在给定字段上滚动（向上/向下）指定的时间量。
`final void`	`set(int year, int month, int date, int hour, int minute, int second)` 设置字段年，月，日，时，分和秒的值。
`final void`	`set(int year, int month, int date, int hour, int minute)` 设置字段年，月，日，小时和分钟的值。
`final void`	`set(int field, int value)` 使用给定值设置时间字段。
`final void`	`set(int year, int month, int date)` 设置字段年，月和日期的值。
`void`	`setFirstDayOfWeek(int value)` 设置一周中的第一天，其中1 = `SUNDAY`和7 = `SATURDAY` 。
`void`	`setLenient(boolean lenient)` 指定日期/时间解释是否宽松。
`void`	`setMinimalDaysInFirstWeek(int value)` 设置一年中第一周所需的最短日期。
`void`	`setRepeatedWallTimeOption(int option)` [icu]设置在负时区偏移转换时重复多次处理墙壁时间的行为。
`void`	`setSkippedWallTimeOption(int option)` [icu]设置在正时区偏移转换时处理跳过墙壁时间的行为。
`final void`	`setTime(Date date)` 将此日历的当前时间设置为给定的日期。
`void`	`setTimeInMillis(long millis)` 根据给定的长值设置此日历的当前时间。
`void`	`setTimeZone(TimeZone value)` 使用给定的时区值设置时区。
`Calendar`	`setWeekData(Calendar.WeekData wdata)` [icu]根据WeekData输入设置此日历中的数据。
`String`	`toString()` 返回此日历的字符串表示形式。
`void`	`validateField(int field)` 验证此日历的单个字段。
`final void`	`validateField(int field, int min, int max)` 给定其最小和最大允许值，验证此日历的单个字段。
`void`	`validateFields()` 通过在已设置的每个字段上调用 `validateField(int)` ，确保每个字段在其有效范围内。
`int`	`weekNumber(int desiredDay, int dayOfPeriod, int dayOfWeek)` 返回一段时间内一天中的星期数。
`final int`	`weekNumber(int dayOfPeriod, int dayOfWeek)` 返回一段时间内一天中的星期数。

From class java.lang.Object

From interface java.lang.Comparable

常量(Constants)

Added in API level 24

int AD

ERA字段的值表示共同时代（Anno Domini），也被称为CE。从BC到AD的过渡年AD是...，2 BC，1 BC，1 AD，2 AD，...

也可以看看：

ERA

常数值：1（0x00000001）

BC

Added in API level 24

int BC

ERA字段的值表示共同时代之前（基督之前）的时期，也被称为BCE。从BC到AD的过渡年AD是...，2 BC，1 BC，1 AD，2 AD，...

也可以看看：

ERA

常量值：0（0x00000000）

Fields

invertGregorian

Added in API level 24

boolean invertGregorian

由handleComputeJulianDay（）和handleComputeMonthStart（）使用。

isGregorian

Added in API level 24

boolean isGregorian

由handleComputeJulianDay（）和handleComputeMonthStart（）使用。

Public constructors

GregorianCalendar

Added in API level 24

GregorianCalendar ()

使用默认时区中的当前时间构建默认的GregorianCalendar，并使用默认的 FORMAT区域设置。

也可以看看：

FORMAT

GregorianCalendar

Added in API level 24

GregorianCalendar (TimeZone zone)

根据给定时区中的当前时间构建一个GregorianCalendar，并使用默认的 FORMAT语言环境。

参数(Parameters)
`zone`	`TimeZone`: the given time zone.

也可以看看：

FORMAT

GregorianCalendar

Added in API level 24

GregorianCalendar (Locale aLocale)

根据给定语言环境的默认时区中的当前时间构造GregorianCalendar。

参数(Parameters)
`aLocale`	`Locale`: the given locale.

GregorianCalendar

Added in API level 24

GregorianCalendar (ULocale locale)

[icu]根据给定语言环境的默认时区中的当前时间构造GregorianCalendar。

参数(Parameters)
`locale`	`ULocale`: the given ulocale.

GregorianCalendar

Added in API level 24

GregorianCalendar (TimeZone zone, 
                Locale aLocale)

[icu]根据给定语言环境给定时区中的当前时间构造GregorianCalendar。

参数(Parameters)
`zone`	`TimeZone`: the given time zone.
`aLocale`	`Locale`: the given locale.

GregorianCalendar

Added in API level 24

GregorianCalendar (TimeZone zone, 
                ULocale locale)

根据给定语言环境给定时区中的当前时间构造GregorianCalendar。

参数(Parameters)
`zone`	`TimeZone`: the given time zone.
`locale`	`ULocale`: the given ulocale.

GregorianCalendar

Added in API level 24

GregorianCalendar (int year, 
                int month, 
                int date)

使用默认时区中设置的给定日期构造GregorianCalendar，默认时区为 FORMAT区域设置。

参数(Parameters)
`year`	`int`: the value used to set the YEAR time field in the calendar.
`month`	`int`: the value used to set the MONTH time field in the calendar. Month value is 0-based. e.g., 0 for January.
`date`	`int`: the value used to set the DATE time field in the calendar.

也可以看看：

FORMAT

GregorianCalendar

Added in API level 24

GregorianCalendar (int year, 
                int month, 
                int date, 
                int hour, 
                int minute)

使用默认的 FORMAT区域设置为默认时区设置的给定日期和时间构造GregorianCalendar。

参数(Parameters)
`year`	`int`: the value used to set the YEAR time field in the calendar.
`month`	`int`: the value used to set the MONTH time field in the calendar. Month value is 0-based. e.g., 0 for January.
`date`	`int`: the value used to set the DATE time field in the calendar.
`hour`	`int`: the value used to set the HOUR_OF_DAY time field in the calendar.
`minute`	`int`: the value used to set the MINUTE time field in the calendar.

也可以看看：

FORMAT

GregorianCalendar

Added in API level 24

GregorianCalendar (int year, 
                int month, 
                int date, 
                int hour, 
                int minute, 
                int second)

使用默认的 FORMAT区域设置为默认时区设置的给定日期和时间构造GregorianCalendar。

参数(Parameters)
`year`	`int`: the value used to set the YEAR time field in the calendar.
`month`	`int`: the value used to set the MONTH time field in the calendar. Month value is 0-based. e.g., 0 for January.
`date`	`int`: the value used to set the DATE time field in the calendar.
`hour`	`int`: the value used to set the HOUR_OF_DAY time field in the calendar.
`minute`	`int`: the value used to set the MINUTE time field in the calendar.
`second`	`int`: the value used to set the SECOND time field in the calendar.

也可以看看：

FORMAT

公共方法(Public methods)

getActualMaximum

Added in API level 24

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

getActualMinimum

Added in API level 24

int getActualMinimum (int field)

给定当前日期，返回此字段可能具有的最小值。对于公历，这与getMinimum（）和getGreatestMinimum（）相同。

参数(Parameters)
`field`	`int`: the field whose actual minimum value is desired.

返回(Returns)
`int`	the minimum of the given field for the current date of this calendar

getGregorianChange

Added in API level 24

Date getGregorianChange ()

获取公历日历更改日期。这是从朱利安日期切换到阳历日期的时刻。默认是1582年10月15日。在此之前，日期将在Julian日历中。

返回(Returns)
`Date`	the Gregorian cutover date for this calendar.

getType

Added in API level 24

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

hashCode

Added in API level 24

int hashCode ()

覆盖hashCode。生成GregorianCalendar对象的哈希码

返回(Returns)
`int`	a hash code value for this object.

isEquivalentTo

Added in API level 24

boolean isEquivalentTo (Calendar other)

如果给定的Calendar对象与此对象相等，则返回true。日历覆盖。

参数(Parameters)
`other`	`Calendar`: the Calendar to be compared with this Calendar

返回(Returns)
`boolean`

isLeapYear

Added in API level 24

boolean isLeapYear (int year)

确定给定年份是否为闰年。如果给定的年份是闰年，则返回true。

参数(Parameters)
`year`	`int`: the given year.

返回(Returns)
`boolean`	true if the given year is a leap year; false otherwise.

roll

Added in API level 24

void roll (int field, 
                int amount)

滚动字段的签名数量。

参数(Parameters)
`field`	`int`: the calendar field to roll.
`amount`	`int`: the amount by which the field should be rolled.

setGregorianChange

Added in API level 24

void setGregorianChange (Date date)

设置GregorianCalendar更改日期。这是从朱利安日期切换到阳历日期的时刻。默认是1582年10月15日。在此之前，日期将在Julian日历中。

要获取纯朱利安日历，请将更改日期设置为Date(Long.MAX_VALUE) 。要获取纯公历日历，请将更改日期设置为Date(Long.MIN_VALUE) 。

参数(Parameters)
`date`	`Date`: the given Gregorian cutover date.

Protected methods

handleComputeFields

Added in API level 24

void handleComputeFields (int julianDay)

重写日历以计算特定于混合公历 - 儒略历日历系统的几个字段。这些是：

ERA
YEAR
MONTH
DAY_OF_MONTH
DAY_OF_YEAR
EXTENDED_YEAR

参数(Parameters)
`julianDay`	`int`

handleComputeJulianDay

Added in API level 24

int handleComputeJulianDay (int bestField)

子类可以覆盖这个。此方法调用handleGetMonthLength（）以获取日历特定的月份长度。

参数(Parameters)
`bestField`	`int`

返回(Returns)
`int`

handleComputeMonthStart

Added in API level 24

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

返回给定月/年开始的JD

参数(Parameters)
`eyear`	`int`: the extended year
`month`	`int`: the zero-based month, or 0 if useMonth is false
`useMonth`	`boolean`: 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)
`int`	the Julian day number of the day before the first day of the given month and year

handleGetExtendedYear

Added in API level 24

int handleGetExtendedYear ()

返回当前字段定义的扩展年份。这将使用EXTENDED_YEAR字段或特定于日历系统的YEAR和超年字段（如ERA），具体取决于哪一组字段较新。

返回(Returns)
`int`	the extended year

handleGetLimit

Added in API level 24

int handleGetLimit (int field, 
                int limitType)

用于定义不同类型限制的子类API。子类必须实现此方法才能返回以下字段的限制：

ERA
 YEAR
 MONTH
 WEEK_OF_YEAR
 WEEK_OF_MONTH
 DAY_OF_MONTH
 DAY_OF_YEAR
 DAY_OF_WEEK_IN_MONTH
 YEAR_WOY
 EXTENDED_YEAR

参数(Parameters)
`field`	`int`: one of the above field numbers
`limitType`	`int`: one of `MINIMUM`, `GREATEST_MINIMUM`, `LEAST_MAXIMUM`, or `MAXIMUM`

返回(Returns)
`int`

handleGetMonthLength

Added in API level 24

int handleGetMonthLength (int extendedYear, 
                int month)

返回此日历系统给定扩展年的给定月份中的天数。如果子类可以提供比日历中的默认实现更正确或更高效的实现，则子类应该重写此方法。

参数(Parameters)
`extendedYear`	`int`
`month`	`int`

返回(Returns)
`int`

handleGetYearLength

Added in API level 24

int handleGetYearLength (int eyear)

返回此日历系统的给定扩展年份中的天数。如果子类可以提供比日历中的默认实现更正确或更高效的实现，则子类应该重写此方法。

参数(Parameters)
`eyear`	`int`

返回(Returns)
`int`