java工具类——calendar

最近代码中需要做很多和时间相关的处理，以时间为条件查询、string——Date转换、分秒的加减、日期的加减、日期的前后比较、相隔的天数（小时、分钟、秒）、获取年月日、获取星期、获取某月第一天、设置某个时间为当天的起始时间……

用到的时候，发现calendar的强大，不管什么样的需求，都是在一些基本操作之上自己进行组合应用。查看calendar源码，了解更多细节应用。

Calendar类的静态方法getInstance()可以初始化一个日历对象:
Calendar now = Calendar.getInstance();

可以使用下面三个方法把日历定到任何一个时间：
set(int year ,int month,int date) 
set(int year ,int month,int date,int hour,int minute) 
set(int year ,int month,int date,int hour,int minute,int second) 

如果想获得年份、月份、小时等信息可以使用：
Now.get(Calendar.Month) 这样的方法 0表示一月，1表示二月
get(Calendar.DAY_OF_MONTH)获得这个月的第几天
get(Calendar.DAY_OF_WEEK)获得这个星期的第几天
get(Calendar.DAY_OF_YEAR)获得这个年的第几天
getTimeMillis()获得当前时间的毫秒表示

如下是Calendar类方法简介

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 的值。
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() 返回此日历的字符串表示形式

简单实验一些代码：

public static void main(String[] args)  
	  {  
	    // 字符串转换日期格式  
	    // DateFormat fmtDateTime = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");  
	    // 得到日期格式对象  
	    // Date date = fmtDateTime.parse(strDateMake);  
	  
	    // 完整显示日期时间  
	    String str = (new SimpleDateFormat("yyyy-MM-dd HH:mm:ss:SSS")).format(new Date());  
	    System.out.println(str);  
	  
	    // 创建 Calendar 对象  
	    Calendar calendar = Calendar.getInstance();  
	    // 初始化 Calendar 对象，但并不必要，除非需要重置时间  
	    calendar.setTime(new Date());  
	  
	    // setTime 类似上面一行  
	    // Date date = new Date();  
	    // calendar.setTime(date);  
	  
	    // 显示年份  
	    int year = calendar.get(Calendar.YEAR);  
	    System.out.println("YEAR is = " + String.valueOf(year));  
	  
	    // 显示月份 (从0开始, 实际显示要加一)  
	    int MONTH = calendar.get(Calendar.MONTH);  
	    System.out.println("MONTH is = " + (MONTH + 1));  
	  
	    // 今年的第 N 天  
	    int DAY_OF_YEAR = calendar.get(Calendar.DAY_OF_YEAR);  
	    System.out.println("DAY_OF_YEAR is = " + DAY_OF_YEAR);  
	  
	    // 本月第 N 天  
	    int DAY_OF_MONTH = calendar.get(Calendar.DAY_OF_MONTH);  
	    System.out.println("DAY_OF_MONTH = " + String.valueOf(DAY_OF_MONTH));  
	  
	    // 3小时以后  
	    calendar.add(Calendar.HOUR_OF_DAY, 3);  
	    int HOUR_OF_DAY = calendar.get(Calendar.HOUR_OF_DAY);  
	    System.out.println("HOUR_OF_DAY + 3 = " + HOUR_OF_DAY);  
	  
	    // 当前分钟数  
	    int MINUTE = calendar.get(Calendar.MINUTE);  
	    System.out.println("MINUTE = " + MINUTE);  
	  
	    // 15 分钟以后  
	    calendar.add(Calendar.MINUTE, 15);  
	    MINUTE = calendar.get(Calendar.MINUTE);  
	    System.out.println("MINUTE + 15 = " + MINUTE);  
	  
	    // 30分钟前  
	    calendar.add(Calendar.MINUTE, -30);  
	    MINUTE = calendar.get(Calendar.MINUTE);  
	    System.out.println("MINUTE - 30 = " + MINUTE);  
	  
	    // 格式化显示  
	    str = (new SimpleDateFormat("yyyy-MM-dd HH:mm:ss:SS")).format(calendar.getTime());  
	    System.out.println(str);  
	  
	    // 重置 Calendar 显示当前时间  
	    calendar.setTime(new Date());  
	    str = (new SimpleDateFormat("yyyy-MM-dd HH:mm:ss:SS")).format(calendar.getTime());  
	    System.out.println(str);  
	  
	    // 创建一个 Calendar 用于比较时间  
	    Calendar calendarNew = Calendar.getInstance();  
	  
	    // 设定为 5 小时以前，后者大，显示 -1  
	    calendarNew.add(Calendar.HOUR, -5);  
	    System.out.println("时间比较：" + calendarNew.compareTo(calendar));  
	  
	    // 设定7小时以后，前者大，显示 1  
	    calendarNew.add(Calendar.HOUR, +7);  
	    System.out.println("时间比较：" + calendarNew.compareTo(calendar));  
	  
	    // 退回 2 小时，时间相同，显示 0  
	    calendarNew.add(Calendar.HOUR, -2);  
	    System.out.println("时间比较：" + calendarNew.compareTo(calendar));  
	  }