GregorianCalendar

public class GregorianCalendar
extends Calendar

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

GregorianCalendar是一种混合日历，支持Julian和Gregorian日历系统，并支持单一的不连续性，默认情况下，公历对应于公历（1582年10月15日在某些国家，后来在其他国家）。 调用者可以通过调用setGregorianChange()来更改转换日期。

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

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

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

Week Of Year and Week Year

为WEEK_OF_YEAR字段计算的值范围从1到53.日历年的第一周是从getFirstDayOfWeek()开始的最早的七天期间，其中包含至少getMinimalDaysInFirstWeek()天。 因而它取决于的值getMinimalDaysInFirstWeek() ， getFirstDayOfWeek() ，和一周的一月的一年1周和下一年的1周（不包括）顺序地被编号为2至52或53（除了间1.周一天参与Julian-Gregorian过渡的年份）。

的getFirstDayOfWeek()个getMinimalDaysInFirstWeek()值构建在使用区域设置相关的资源初始化GregorianCalendar 。 The week determination is compatible与ISO 8601标准，当getFirstDayOfWeek()是MONDAY和getMinimalDaysInFirstWeek()是4时，这些值用于首选标准区域。 这些值可以通过调用setFirstDayOfWeek()和setMinimalDaysInFirstWeek()来明确设置。

A week year与WEEK_OF_YEAR周期同步。 第一周和最后一周（含）之间的所有星期具有相同的周年价值。 因此，一周的第一天和最后一天可能会有不同的日历年度值。

例如，1998年1月1日是星期四。 如果getFirstDayOfWeek()是MONDAY和getMinimalDaysInFirstWeek()是4（符合ISO 8601标准兼容设置），那么1998年第一周从1997年12月29日开始，到1998年1月4日结束。周年是1998年，为1997历年的最后三天。但是，如果getFirstDayOfWeek()是SUNDAY ，那么1998年第一周从1998年1月4日开始，到1998年1月10日结束; 1998年的前三天是1997年第53周的一部分，他们的周年是1997年。

Week Of Month

为WEEK_OF_MONTH字段计算的值范围为0到6.一个月的第1周（具有WEEK_OF_MONTH = 1 ）是最早的一组，该月的至少getMinimalDaysInFirstWeek()个连续日，终止于getFirstDayOfWeek()前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 WEEK_OF_MONTH为0.如果 getMinimalDaysInFirstWeek()更改为3，则1月1日至1月3日的 WEEK_OF_MONTH为1。

Default Fields Values

clear方法设置未定义的日历字段。 GregorianCalendar如果其值未定义，则为每个日历字段使用以下默认值。

例：

 // 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 Saving Time
 pdt.setStartRule(Calendar.APRIL, 1, Calendar.SUNDAY, 2 * 60 * 60 * 1000);
 pdt.setEndRule(Calendar.OCTOBER, -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
 

Summary

Inherited constants

From class java.util.Calendar int ALL_STYLES getDisplayNames的样式说明 getDisplayNames指示所有样式的名称，例如“January”和“Jan”。 int AM AM_PM字段的值表示从午夜到中午之前的一天的时段。 int AM_PM get和 set字段编号指示 HOUR是在中午之前还是之后。 int APRIL MONTH字段的值表示格里历和Julian日历中的一年中的第四个月。 int AUGUST MONTH字段的值表示格里历和Julian日历中的一年中的第八个月。 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字段的值表示格里历和Julian日历中的一年中的第十二个月。 int DST_OFFSET get和 set字段编号，指示以毫秒为单位的夏令时偏移量。 int ERA 指示时间的 get和 set字段编号，例如Julian日历中的AD或BC。 int FEBRUARY MONTH字段的值表示格里历和Julian日历中的第二个月。 int FIELD_COUNT 由 get和 set识别的不同字段的数量。 int FRIDAY 指示星期五的 DAY_OF_WEEK字段的值。 int HOUR get和 set字段编号表示上午或下午的小时。 int HOUR_OF_DAY 表示当天的小时的 get和 set字段编号。 int JANUARY MONTH字段的值表示格里历和Julian日历中的一年中的第一个月。 int JULY MONTH字段的值表示格里历和Julian日历中一年中的第七个月。 int JUNE MONTH字段的值表示格里历和Julian日历中一年中的第六个月。 int LONG getDisplayName和 getDisplayNames样式说明 getDisplayName ，表示长名称，例如“January”。 int MARCH MONTH字段的值表示格里历和Julian日历中的一年中的第三个月。 int MAY MONTH字段的值表示格里历和Julian日历中的一年中的第五个月。 int MILLISECOND get和 set字段编号表明秒内的毫秒数。 int MINUTE 指示一小时内的分钟的 get和 set字段编号。 int MONDAY 指示星期一的 DAY_OF_WEEK字段的值。 int MONTH 表示当月的 get和 set字段号。 int NOVEMBER MONTH字段的值表示格里历和Julian日历中的年份中的第11个月。 int OCTOBER MONTH字段的值表示格里历和Julian日历中的一年中的第十个月。 int PM AM_PM字段的值表示从中午到午夜之前的一天的时间段。 int SATURDAY 指示星期六的 DAY_OF_WEEK字段的值。 int SECOND get和 set字段编号指示分钟内的第二个。 int SEPTEMBER MONTH字段的值表示格里历和Julian日历中的一年中的第九个月。 int SHORT 指定短名称（如“Jan”）的 getDisplayName和 getDisplayNames样式说明符。 int SUNDAY 指示周日的 DAY_OF_WEEK字段的值。 int THURSDAY 指示周四的 DAY_OF_WEEK字段的值。 int TUESDAY 指示星期二的 DAY_OF_WEEK字段的值。 int UNDECIMBER MONTH字段的值表示今年的第13个月。 int WEDNESDAY 指示周三的 DAY_OF_WEEK字段的值。 int WEEK_OF_MONTH get和 set字段编号，指示当前月份内的星期编号。 int WEEK_OF_YEAR get和 set字段编号，指示当前年份内的星期编号。 int YEAR 表示年份的字段编号为 get和 set 。 int ZONE_OFFSET get和 set字段编号，指示以毫秒为单位的GMT的原始偏移量。

Inherited fields
From class java.util.Calendar protected boolean areFieldsSet 如果 fields[]与当前设定的时间同步， fields[]真。 protected int[] fields 该日历的当前设置时间的日历字段值。 protected boolean[] isSet 指示日历的指定日历字段是否已设置的标志。 protected boolean isTimeSet 如果 time的值有效， time真。 protected long time 此日历的当前设置时间，以1970年1月1日格林威治标准时间0:00:00之后的毫秒数表示。

Inherited methods
From class java.util.Calendar abstract void add(int field, int amount) 根据日历的规则，将指定的时间量添加或减去给定的日历字段。 boolean after(Object when) 返回此 Calendar是否表示指定的 Object表示的时间之后的时间。 boolean before(Object when) 返回此 Calendar是否表示由指定的 Object表示的时间之前的时间。 final void clear() 设置此 Calendar未定义的所有日历字段值和时间值（ Epoch的毫秒偏移量）。 final void clear(int field) 设置未定义的此 Calendar的给定日历字段值和时间值（ Epoch的毫秒偏移量）。 Object clone() 创建并返回此对象的副本。 int compareTo(Calendar anotherCalendar) 比较两个 Calendar对象所表示的时间值（来自 Epoch的毫秒偏移量）。 void complete() 填写日历栏中的任何未设置的字段。 abstract void computeFields() 当前毫秒时间值转换为 time的日历字段值 fields[] 。 abstract void computeTime() 将 fields[]的当前日历字段值 fields[]为毫秒时间值 time 。 boolean equals(Object obj) 将此 Calendar与指定的 Object 。 int get(int field) 返回给定日历字段的值。 int getActualMaximum(int field) 给定此 Calendar的时间值，返回指定日历字段可能具有的 Calendar 。 int getActualMinimum(int field) 给定此 Calendar的时间值，返回指定的日历字段可能具有的 Calendar 。 static Locale[] getAvailableLocales() 返回 getInstance方法可返回本地化实例的所有语言环境的数组。 String getDisplayName(int field, int style, Locale locale) 返回给定 style和 locale日历 field值的字符串表示 locale 。 Map<String, Integer> getDisplayNames(int field, int style, Locale locale) 返回 Map其中包含给定 style和 locale中的日历 field所有名称及其相应的字段值。 int getFirstDayOfWeek() 获取一周的第一天是什么; 例如， SUNDAY在美国， MONDAY在法国。 abstract int getGreatestMinimum(int field) 返回此 Calendar实例的给定日历字段的最高最小值。 static Calendar getInstance() 使用默认时区和区域设置获取日历。 static Calendar getInstance(Locale aLocale) 使用默认时区和指定区域设置获取日历。 static Calendar getInstance(TimeZone zone, Locale aLocale) 获取具有指定时区和区域设置的日历。 static Calendar getInstance(TimeZone zone) 使用指定的时区和默认语言环境获取日历。 abstract int getLeastMaximum(int field) 返回此 Calendar实例的给定日历字段的最小最大值。 abstract int getMaximum(int field) 返回此 Calendar实例的给定日历字段的 Calendar 。 int getMinimalDaysInFirstWeek() 获取一年中第一周所需的最短日期; 例如，如果第一周定义为包含一年中第一个月的第一天的一周，则此方法返回1。 abstract int getMinimum(int field) 返回此 Calendar实例的给定日历字段的 Calendar 。 final Date getTime() 返回表示此 Calendar的时间值（与 Epoch毫秒偏移量）的 Date对象。 long getTimeInMillis() 以毫秒为单位返回此日历的时间值。 TimeZone getTimeZone() 获取时区。 int getWeekYear() 返回此 Calendar代表的 Calendar 。 int getWeeksInWeekYear() 返回此 Calendar表示的一周中的星期 Calendar 。 int hashCode() 返回此日历的哈希码。 final int internalGet(int field) 返回给定日历字段的值。 boolean isLenient() 告诉日期/时间解释是否宽松。 final boolean isSet(int field) 确定给定的日历字段是否具有值集，包括通过 get方法调用触发的内部字段计算设置值的情况。 boolean isWeekDateSupported() 返回此 Calendar是否支持星期日期。 abstract void roll(int field, boolean up) 在给定时间字段上添加或减去（上/下）单个时间单位而不改变更大的字段。 void roll(int field, int amount) 将指定的（已签名）金额添加到指定的日历字段，而不更改较大的字段。 final void set(int year, int month, int date, int hourOfDay, int minute, int second) 设置字段中的值 YEAR ， MONTH ， DAY_OF_MONTH ， HOUR ， MINUTE ，并 SECOND 。 final void set(int year, int month, int date, int hourOfDay, int minute) 设置日历字段的值 YEAR ， MONTH ， DAY_OF_MONTH ， HOUR_OF_DAY ，并 MINUTE 。 void set(int field, int value) 将给定的日历字段设置为给定值。 final void set(int year, int month, int date) 设置日历字段的值 YEAR ， MONTH ，并 DAY_OF_MONTH 。 void setFirstDayOfWeek(int value) 设置一周的第一天是什么; 例如， SUNDAY在美国， MONDAY在法国。 void setLenient(boolean lenient) 指定日期/时间解释是否宽松。 void setMinimalDaysInFirstWeek(int value) 设置一年中第一周所需的最短日期; 例如，如果第一周被定义为包含一年的第一个月的第一天的一周，则使用值1调用此方法。 final void setTime(Date date) 使用给定的 Date设置此日历的时间。 void setTimeInMillis(long millis) 根据给定的长值设置此日历的当前时间。 void setTimeZone(TimeZone value) 使用给定的时区值设置时区。 void setWeekDate(int weekYear, int weekOfYear, int dayOfWeek) 使用给定的日期说明符设置此 Calendar的日期 - 星期几，星期几和星期几。 String toString() 返回此日历的字符串表示形式。
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为此对象调用 notify()方法或 notifyAll()方法，或其他某个线程中断当前线程或经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。
From interface java.lang.Comparable abstract int compareTo(Calendar o) 将此对象与指定的对象进行比较以进行排序。

Constants

int AD

int BC

Public constructors

GregorianCalendar ()

GregorianCalendar (TimeZone zone)

GregorianCalendar (Locale aLocale)

GregorianCalendar (TimeZone zone, 
                Locale aLocale)

GregorianCalendar (int year, 
                int month, 
                int dayOfMonth)

GregorianCalendar (int year, 
                int month, 
                int dayOfMonth, 
                int hourOfDay, 
                int minute)

GregorianCalendar (int year, 
                int month, 
                int dayOfMonth, 
                int hourOfDay, 
                int minute, 
                int second)

Public methods

void add (int field, 
                int amount)

Object clone ()

boolean equals (Object obj)

int getActualMaximum (int field)

int getActualMinimum (int field)

int getGreatestMinimum (int field)

Date getGregorianChange ()

int getLeastMaximum (int field)

int getMaximum (int field)

int getMinimum (int field)

TimeZone getTimeZone ()

int getWeekYear ()

int getWeeksInWeekYear ()

int hashCode ()

boolean isLeapYear (int year)

boolean isWeekDateSupported ()

void roll (int field, 
                boolean up)

void roll (int field, 
                int amount)

void setGregorianChange (Date date)

void setTimeZone (TimeZone zone)

void setWeekDate (int weekYear, 
                int weekOfYear, 
                int dayOfWeek)

Protected methods

void computeFields ()

void computeTime ()