Calenlar 简述

Calendar 简述
   Calendar类是一个抽象类，它为特定瞬间与一组诸如 YEAR、MONTH、DAY_OF_MONTH、HOUR 等 日历字段之间的转换提供了一些方法，并为操作日历字段（例如获得下星期的日期）

提供了一些方法。瞬间可用毫秒值来表示，它是距历元（即格林威治标准时间 1970 年 1 月 1 日的 00:00:00.000，格里高利历）的偏移量。


   1.创建Calendar对象：

       Calendar calendar = Calendar.getInstance();

   2.获得并设置日历字段值

          可以通过调用 set 方法来设置日历字段值。在需要计算时间值（距历元所经过的毫秒）或日历字段值之前，不会解释 Calendar 中的所有字段值设置。调用 get、getTimeInMillis、getTime、add 和 roll 涉及此类计算。

   3.常用字段摘要

static int ALL_STYLES 
          指示所有风格名称的 getDisplayNames 的风格说明符，比如 "January" 和 "Jan"。 

static int AM 
          指示从午夜到中午之前这段时间的 AM_PM 字段值。 

static int AM_PM 
          get 和 set 的字段数字，指示 HOUR 是在中午之前还是在中午之后。 

static int APRIL 
          指示在格里高利历和罗马儒略历中一年中第四个月的 MONTH 字段值。 


protected  boolean areFieldsSet 
          如果 fields[] 与当前的设置时间同步，则返回 true。 

static int AUGUST 
          指示在格里高利历和罗马儒略历中一年中第八个月的 MONTH 字段值。 

static int DATE 
          get 和 set 的字段数字，指示一个月中的某天。 


static int DAY_OF_MONTH 
          get 和 set 的字段数字，指示一个月中的某天。 

static int DAY_OF_WEEK 
          get 和 set 的字段数字，指示一个星期中的某天。 

static int DAY_OF_WEEK_IN_MONTH 
          get 和 set 的字段数字，指示当前月中的第几个星期。 


static int DAY_OF_YEAR 
          get 和 set 的字段数字，指示当前年中的天数。 

static int DECEMBER 
          指示在格里高利历和罗马儒略历中一年中第十二个月的 MONTH 字段值。 


static int DST_OFFSET 
          get 和 set 的字段数字，以毫秒为单位指示夏令时的偏移量。 


static int ERA 
          指示年代的 get 和 set 的字段数字，比如罗马儒略历中的 AD 或 BC。 

static int FEBRUARY 
          指示在格里高利历和罗马儒略历中一年中第二个月的 MONTH 字段值。 

static int FIELD_COUNT 
          get 和 set 可识别的不同字段的数量。 

protected  int[] fields 
          此日历当前设置时间的日历字段值。 

static int FRIDAY 
          指示 Friday 的 DAY_OF_WEEK 字段值。 

static int HOUR 
          get 和 set 的字段数字，指示上午或下午的小时。 


static int HOUR_OF_DAY 
          get 和 set 的字段数字，指示一天中的小时。 

protected  boolean[] isSet 
          通知是否设置了该日历某一指定日历字段的标志。 

protected  boolean isTimeSet 
          如果 time 值是一个有效值，则返回 true。 

static int JANUARY 
          指示在格里高利历和罗马儒略历中一年中第一个月的 MONTH 字段值。 

static int JULY 
          指示在格里高利历和罗马儒略历中一年中第七个月的 MONTH 字段值。 

static int JUNE 
          指示在格里高利历和罗马儒略历中一年中第六个月的 MONTH 字段值。 

static int LONG 
          指示长名称的 getDisplayName 和 getDisplayNames 的风格说明符，比如 "January"。 

static int MARCH 
          指示在格里高利历和罗马儒略历中一年中第三个月的 MONTH 字段值。 

static int MAY 
          指示在格里高利历和罗马儒略历中一年中第五个月的 MONTH 字段值。 

static int MILLISECOND 
          get 和 set 的字段数字，指示一秒中的毫秒。 

static int MINUTE 
          get 和 set 的字段数字，指示一小时中的分钟。 

static int MONDAY 
          指示 Monday 的 DAY_OF_WEEK 字段值。 

static int MONTH 
          指示月份的 get 和 set 的字段数字。 

static int NOVEMBER 
          指示在格里高利历和罗马儒略历中一年中第十一个月的 MONTH 字段值。 

static int OCTOBER 
          指示在格里高利历和罗马儒略历中一年中第十个月的 MONTH 字段值。 

static int PM 
          指示从中午到午夜之前这段时间的 AM_PM 字段值。 

static int SATURDAY 
          指示 Saturday 的 DAY_OF_WEEK 字段值。 

static int SECOND 
          get 和 set 的字段数字，指示一分钟中的秒。 

static int SEPTEMBER 
          指示在格里高利历和罗马儒略历中一年中第九个月的 MONTH 字段值。 

static int SHORT 
          指示短名称的 getDisplayName 和 getDisplayNames 的风格说明符，比如 "Jan"。 

static int SUNDAY 
          指示 Sunday 的 DAY_OF_WEEK 字段值。 

static int THURSDAY 
          指示 Thursday 的 DAY_OF_WEEK 字段值。 

protected  long time 
          日历的当前设置时间，以毫秒为单位，表示自格林威治标准时间 1970 年 1月 1 日 0:00:00 后经过的时间。 
static int TUESDAY 
          指示 Tuesday 的 DAY_OF_WEEK 字段值。 

static int UNDECIMBER 
          指示一年中第十三个月的 MONTH 字段值。 

static int WEDNESDAY 
          指示 Wednesday 的 DAY_OF_WEEK 字段值。 

static int WEEK_OF_MONTH 
          get 和 set 的字段数字，指示当前月中的星期数。 

static int WEEK_OF_YEAR 
          get 和 set 的字段数字，指示当前年中的星期数。 

static int YEAR 
          指示年的 get 和 set 的字段数字。 

static int ZONE_OFFSET 
          get 和 set 的字段数字，以毫秒为单位指示距 GMT 的大致偏移量。 



    4.常用方法
abstract  void add(int field, int amount) 
          根据日历的规则，为给定的日历字段添加或减去指定的时间量。 

 boolean after(Object when) 
          判断此 Calendar 表示的时间是否在指定 Object 表示的时间之后，返回判断结果。 

 boolean before(Object when) 
          判断此 Calendar 表示的时间是否在指定 Object 表示的时间之前，返回判断结果。 

 void clear() 
          将此 Calendar 的所日历字段值和时间值（从历元至现在的毫秒偏移量）设置成未定义。 

 void clear(int field) 
          将此 Calendar 的给定日历字段值和时间值（从历元至现在的毫秒偏移量）设置成未定义。 

 Object clone() 
          创建并返回此对象的一个副本。 

 int compareTo(Calendar anotherCalendar) 
          比较两个 Calendar 对象表示的时间值（从历元至现在的毫秒偏移量）。 

protected  void complete() 
          填充日历字段中所有未设置的字段。 

protected abstract  void computeFields() 
          将当前毫秒时间值 time 转换为 fields[] 中的日历字段值。 

protected abstract  void computeTime() 
          将 fields[] 中的当前日历字段值转换为毫秒时间值 time。 

 boolean equals(Object obj) 
          将此 Calendar 与指定 Object 比较。 

 int get(int field) 
          返回给定日历字段的值。 

 int getActualMaximum(int field) 
          给定此 Calendar 的时间值，返回指定日历字段可能拥有的最大值。 

 int getActualMinimum(int field) 
          给定此 Calendar 的时间值，返回指定日历字段可能拥有的最小值。 

static Locale[] getAvailableLocales() 
          返回所有语言环境的数组，此类的 getInstance 方法可以为其返回本地化的实例。 

 String getDisplayName(int field, int style, Locale locale) 
          返回给定 style 和 locale 下的日历 field 值的字符串表示形式。 

 Map<String,Integer> getDisplayNames(int field, int style, Locale locale) 
          返回给定 style 和 locale 下包含日历 field 所有名称的 Map 及其相应字段值。 

 int getFirstDayOfWeek() 
          获取一星期的第一天；例如，在美国，这一天是 SUNDAY，而在法国，这一天是 MONDAY。 

abstract  int getGreatestMinimum(int field) 
          返回此 Calendar 实例给定日历字段的最高的最小值。 

static Calendar getInstance() 
          使用默认时区和语言环境获得一个日历。 新建一个日历对象

static Calendar getInstance(Locale aLocale) 
          使用默认时区和指定语言环境获得一个日历。 

static Calendar getInstance(TimeZone zone) 
          使用指定时区和默认语言环境获得一个日历。 

static Calendar getInstance(TimeZone zone, Locale aLocale) 
          使用指定时区和语言环境获得一个日历。 

abstract  int getLeastMaximum(int field) 
          返回此 Calendar 实例给定日历字段的最低的最大值。 

abstract  int getMaximum(int field) 
          返回此 Calendar 实例给定日历字段的最大值。 

 int getMinimalDaysInFirstWeek() 
          获取一年中第一个星期所需的最少天数，例如，如果定义第一个星期包含一年第一个月的第一天，则此方法将返回 1。 

abstract  int getMinimum(int field) 
          返回此 Calendar 实例给定日历字段的最小值。 

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

 long getTimeInMillis() 
          返回此 Calendar 的时间值，以毫秒为单位。 

 TimeZone getTimeZone() 
          获得时区。 

 int hashCode() 
          返回该此日历的哈希码。 

protected  int internalGet(int field) 
          返回给定日历字段的值。 

 boolean isLenient() 
          判断日期/时间的解释是否为宽松的。 

 boolean isSet(int field) 
          确定给定日历字段是否已经设置了一个值，其中包括因为调用 get 方法触发内部字段计算而导致已经设置该值的情况。 

abstract  void roll(int field, boolean up) 
          在给定的时间字段上添加或减去（上/下）单个时间单元，不更改更大的字段。 

 void roll(int field, int amount) 
          向指定日历字段添加指定（有符号的）时间量，不更改更大的字段。 

 void set(int field, int value) 
          将给定的日历字段设置为给定值。 

 void set(int year, int month, int date) 
          设置日历字段 YEAR、MONTH 和 DAY_OF_MONTH 的值。 
          YEAR + MONTH + DAY_OF_MONTH

 void set(int year, int month, int date, int hourOfDay, int minute) 
          设置日历字段 YEAR、MONTH、DAY_OF_MONTH、HOUR_OF_DAY 和 MINUTE 的值。 
          
 void set(int year, int month, int date, int hourOfDay, int minute, int second) 
          设置字段 YEAR、MONTH、DAY_OF_MONTH、HOUR、MINUTE 和 SECOND 的值。 

 void setFirstDayOfWeek(int value) 
          设置一星期的第一天是哪一天；例如，在美国，这一天是 SUNDAY，而在法国，这一天是 MONDAY。 

 void setLenient(boolean lenient) 
          指定日期/时间解释是否是宽松的。 

 void setMinimalDaysInFirstWeek(int value) 
          设置一年中第一个星期所需的最少天数，例如，如果定义第一个星期包含一年第一个月的第一天，则使用值 1 调用此方法。 

 void setTime(Date date) 
          使用给定的 Date 设置此 Calendar 的时间。
 
 void setTimeInMillis(long millis) 
          用给定的 long 值设置此 Calendar 的当前时间值。 

 void setTimeZone(TimeZone value) 
          使用给定的时区值来设置时区。 

 String toString() 
          返回此日历的字符串表示形式。



   5.日历字段解析
如果日历字段值中存在任何冲突，则 Calendar 将为最近设置的日历字段提供优先权。以下是日历字段的默认组合。将使用由最近设置的单个字段所确定的最近组合。 

对于日期字段： 

 YEAR + MONTH + DAY_OF_MONTH 年 + 月 + 一个月里的第几天
 YEAR + MONTH + WEEK_OF_MONTH + DAY_OF_WEEK 年 + 月 + 当前月的星期数 + 一个星期中的某天
 YEAR + MONTH + DAY_OF_WEEK_IN_MONTH + DAY_OF_WEEK 年 + 月 + 当前月中的第几个星期 + 一个星期中的某天
 YEAR + DAY_OF_YEAR  年 + 一年里的第几天
 YEAR + DAY_OF_WEEK + WEEK_OF_YEAR 年 + 一个星期中的某天 + 当前年中的星期数。
 对于时间字段： 
 HOUR_OF_DAY
 AM_PM + HOUR