GregorianCalendar类方法的介绍及使用注意事项

在看《Java核心技术》卷1，GregorianCalendar 类有些东西记下：

1.GregorianCalendar 是 Calendar
的一个具体子类，提供了世界上大多数国家使用的标准日历系统他存在于java.util包中。

2.在默认情况下，它对应格里高利日历创立时的格里高利历日期（某些国家是在
1582 年 10 月 15 日创立，在其他国家要晚一些）。可由调用方通过调用setGregorianChange()来更改起始日期。使用
GregorianCalendar 得到的日期只在历史上从公元 4年3月1日之后是准确的。

3.GregorianCalendar 为每个日历字段使用以下默认值（如果该值未定义）

4. 日历类的一些构造方法

(1).public
GregorianCalendar():在具有默认语言环境的默认时区内使用当前时间构造一个默认的 GregorianCalendar

(2).public GregorianCalendar(TimeZone zone):在具有默认语言环境的给定时区内构造一个基于当前时间的
GregorianCalendar

参数：
zone - 给定的时区

(3).public GregorianCalendar(Locale aLocale)在具有给定语言环境的默认时区内构造一个基于当前时间的
GregorianCalendar
参数：
aLocale - 给定的语言环境

(4).public GregorianCalendar(int year,int month,int
dayOfMonth)在具有默认语言环境的默认时区内构造一个带有给定日期设置的 GregorianCalendar

参数：
year -用来在日历中设置 YEAR 日历字段的值

month-用来在日历中设置MONTH日历字段的值。Month值是基于
0 的，例如，0 表示 1 月

dayOfMonth - 用来在日历中设置 DAY_OF_MONTH 日历字段的值

(5). public GregorianCalendar(int
year,

                        
int
month,

                        
int
dayOfMonth,

                        
int
hourOfDay,

                        
int minute)为具有默认语言环境的默认时区构造一个具有给定日期和时间设置的 GregorianCalendar

参数：
year -
用来在日历中设置 YEAR 日历字段的值

month -用来在日历中设置MONTH日历字段的值。Month 值是基于0的，例如,0表示 1
月

dayOfMonth - 用来在日历中设置 DAY_OF_MONTH 日历字段的值

hourOfDay - 用来在日历中设置
HOUR_OF_DAY 日历字段的值

minute - 用来在日历中设置 MINUTE 日历字段的值

(6). public GregorianCalendar(int
year,

                        
int
month,

                        
int
dayOfMonth,

                        
int
hourOfDay,

                        
int
minute,

                        
int second) 为具有默认语言环境的默认时区构造一个具有给定日期和时间设置的 GregorianCalendar

参数：
year
- 用来在日历中设置 YEAR 日历字段的值

month -用来在日历中设置 MONTH日历字段的值,Month值是基于0 的，例如，0 表示 1
月

dayOfMonth - 用来在日历中设置 DAY_OF_MONTH 日历字段的值

hourOfDay - 用来在日历中设置
HOUR_OF_DAY 日历字段的值

minute - 用来在日历中设置 MINUTE 日历字段的值

second -
用来在日历中设置 SECOND 日历字段的值

 5.类的方法信息

(1).boolean isLeapYear(int
year)
作用:判断给定的年份是否为闰年,若是返回true,否则返回false

(2).boolean equals(object
obj)
作用:将此日历和指定的objecect对象进行比较看是否相等,当obj也是GregorianCalendar类的对象时,才会返回true

(3). public int compareTo(Calendar anotherCalendar) 比较两个 Calendar
对象表示的时间值（从历元至现在的毫秒偏移量）
指定者：
接口 Comparable 中的
compareTo
参数：
anotherCalendar - 要比较的 Calendar
返回：
如果参数表示的时间等于此
Calendar 表示的时间，则返回 0 值；如果此 Calendar 的时间在参数表示的时间之前，则返回小于 0 的值；如果此 Calendar
的时间在参数表示的时间之后，则返回大于 0 的值
=====说明:类GregorianCalendar是类Calendar的一个子类.
Calendar类是一个抽象的类,里面的许多方法都被GregorianCalendar继承过来并加以重写.所以我们用GregorianCalendar类里的很多方法都是Calendar类里面的

(4) public final Date getTime() 返回一个表示此 Calendar 时间值（从历元至现在的毫秒偏移量）的 Date
对象。
返回：
表示时间值的Date

(5). public final void setTime(Date date) 使用给定的 Date 设置此 Calendar
的时间。
注：使用 Date(Long.MAX_VALUE) 或 Date(Long.MIN_VALUE) 调用 setTime() 可能产生来自
get() 的错误字段值
参数：
date - 给定的 Date

(6). public long getTimeInMillis() 返回此 Calendar
的时间值，以毫秒为单位
返回：
当前时间，以从历元至现在所经过的 UTC 毫秒数形式

(7). public final void set(int year,  int month, int date) 设置日历字段
YEAR、MONTH 和 DAY_OF_MONTH 的值。保留其他日历字段以前的值。如果不需要这样做，则先调用 clear()
参数：
year -
用来设置 YEAR 日历字段的值
month - 用来设置 MONTH 日历字段的值。Month 值是基于 0 的。例如，0 表示
January
date - 用来设置 DAY_OF_MONTH 日历字段的值

(8). public boolean before(Object when) 判断此 Calendar 表示的时间是否在指定 Object
表示的时间之前，返回判断结果。此方法等效于：
      compareTo(when) <
0
当且仅当 when 是一个 Calendar 实例时才返回 true。否则该方法返回 false
参数：
when - 要比较的
Object
返回：
如果此 Calendar 的时间在 when 表示的时间之前，则返回 true；否则返回 false

(9). public boolean after(Object when) 判断此 Calendar 表示的时间是否在指定 Object
表示的时间之后，返回判断结果。此方法等效于：
      compareTo(when) >
0

当且仅当 when 是一个 Calendar 实例时才返回 true。否则该方法返回 false
参数：
when - 要比较的
Object
返回：
如果此 Calendar 的时间在 when 表示的时间之后，则返回 true；否则返回 false

(10). ppublic abstract void add(int field, int amount) 
根据日历的规则，为给定的日历字段添加或减去指定的时间量。例如，要从当前日历时间减去 5
天，可以通过调用以下方法做到这一点：
       
add(Calendar.DAY_OF_MONTH, -5)
       
参数：
            
field -
日历字段
            
amount - 为字段添加的日期或时间量

(11). public abstract void roll(int field, boolean up)
在给定的时间字段上添加或减去（上/下）单个时间单元，不更改更大的字段。例如，要将当前日期向上滚动一天，可以通过调用以下方法做到这一点：
roll(Calendar.DATE,
true)。在 year 或 Calendar.YEAR 字段上滚动时，将在从 1 到调用 getMaximum(Calendar.YEAR)
的返回值之间的范围内滚动 year 值。在 month 或 Calendar.MONTH 字段上滚动时，其他字段（如
date）可能发生冲突，因此需要更改它们。例如，在日期 01/31/96 上滚动month 将产生 02/29/96 的日期。在 hour-in-day或
Calendar.HOUR_OF_DAY字段上滚动时小时值会在0到23之间的范围内滚动，它是基于0 的
参数：
field - 时间字段
up
- 指示指定时间字段的值是向上滚动还是向下滚动。如果向上滚动，则使用 true，否则使用 false

(12). public void setTimeZone (TimeZone
value)使用给定的时区值来设置时区
参数：
value - 给定的时区

(13). public TimeZone getTimeZone()获得时区
返回：与此日历有关的时区对象

(14). public void setFirstDayOfWeek(int value)设置一星期的第一天是哪一天；例如，在美国，这一天是
SUNDAY，而在法国，这一天是 MONDAY
参数：
value - 给出的一星期的第一天

(15). public Object clone()创建并返回此对象的一个副本
覆盖：类 Object 中的
clone
返回：
此对象的一个副本

(16). public String
toString()返回此日历的字符串表示形式。此方法仅在进行调试的时候使用，不同实现之间所返回的字符串格式可能有所不同。返回的字符串可能为空，但不可能为
null
覆盖：类 Object 中的 toString
返回：
此日历的字符串表示形式