Java Calendar

package cn.outofmemory.codes.Date;

import java.util.Calendar;
import java.util.Date;

public class CalendarDemo {
  public static void main(String[] args) {
     Calendar calendar=Calendar.getInstance();
     calendar.setTime(new Date());
     System.out.println("现在时间是："+new Date());
     String year=String.valueOf(calendar.get(Calendar.YEAR));
     String month=String.valueOf(calendar.get(Calendar.MONTH)+1);
     String day=String.valueOf(calendar.get(Calendar.DAY_OF_MONTH));
     String week=String.valueOf(calendar.get(Calendar.DAY_OF_WEEK)-1);
     System.out.println("现在时间是："+year+"年"+month+"月"+day+"日，星期"+week);
     long year2009=calendar.getTimeInMillis();
     calendar.set(1989,9,26);//这里与真实的月份之间相差1
     long year1989=calendar.getTimeInMillis();
     long days=(year2009-year1989)/(1000*60*60*24);
     System.out.println("今天和1989年10月26日相隔"+days+"天，"+"也就是说我在这个美丽的星球上已经幸福的生活了"+days+"天。");

  }
}

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

Calendar的常用方法示例

1、计算某一月份的最大天数

Calendar time=Calendar.getInstance();
time.clear();
time.set(Calendar.YEAR,year);
time.set(Calendar.MONTH,i-1);//注意,Calendar对象默认一月为0
int day=time.getActualMaximum(Calendar.DAY_OF_MONTH);//本月份的天数

注：在使用set方法之前，必须先clear一下，否则很多信息会继承自系统当前时间

2、Calendar和Date的转化

(1) Calendar转化为Date

Calendar cal=Calendar.getInstance();
Date date=cal.getTime();

(2) Date转化为Calendar

Date date=new Date();
Calendar cal=Calendar.getInstance();
cal.setTime(date);

3、格式化输出日期时间

Date date=new Date();
SimpleDateFormat df=new SimpleDateFormat("yyyy-MM-dd hh:mm:ss");
System.out.println(df.format(date));

4、计算一年中的第几星期

(1)计算某一天是一年中的第几星期

Calendar cal=Calendar.getInstance();
cal.set(Calendar.YEAR, 2006);
cal.set(Calendar.MONTH, 8);
cal.set(Calendar.DAY_OF_MONTH, 3);
int weekno=cal.get(Calendar.WEEK_OF_YEAR);

(2)计算一年中的第几星期是几号

SimpleDateFormat df=new SimpleDateFormat("yyyy-MM-dd");
Calendar cal=Calendar.getInstance();
cal.set(Calendar.YEAR, 2006);
cal.set(Calendar.WEEK_OF_YEAR, 1);
cal.set(Calendar.DAY_OF_WEEK, Calendar.MONDAY);
System.out.println(df.format(cal.getTime()));

输出:

2006-01-02

5、add()和roll()的用法

(1) add()方法

SimpleDateFormat df=new SimpleDateFormat("yyyy-MM-dd");
Calendar cal=Calendar.getInstance();
cal.set(Calendar.YEAR, 2006);
cal.set(Calendar.MONTH, 8);
cal.set(Calendar.DAY_OF_MONTH, 3);
cal.add(Calendar.DATE, -4);
Date date=cal.getTime();
System.out.println(df.format(date));
cal.add(Calendar.DATE, 4);
date=cal.getTime();
System.out.println(df.format(date));

输出：

    2006-08-30
    2006-09-03

(2)roll方法

cal.set(Calendar.YEAR, 2006);
cal.set(Calendar.MONTH, 8);
cal.set(Calendar.DAY_OF_MONTH, 3);
cal.roll(Calendar.DATE, -4);
date=cal.getTime();
System.out.println(df.format(date));
cal.roll(Calendar.DATE, 4);
date=cal.getTime();
System.out.println(df.format(date));

输出：

    2006-09-29
    2006-09-03

可见，roll()方法在本月内循环，一般使用add()方法；

6、计算两个任意时间中间的间隔天数

(1)传进Calendar对象

/
**计算两个时间之间相隔天数
 * @param startday  开始时间
 * @param endday 结束时间
 * @return
 */
public int getIntervalDays(Calendar startday,Calendar endday){
    //确保startday在endday之前
    if(startday.after(endday)){
        Calendar cal=startday;
        startday=endday;
        endday=cal;
    }
    //分别得到两个时间的毫秒数
    long sl=startday.getTimeInMillis();
    long el=endday.getTimeInMillis();

    long ei=el-sl;
    //根据毫秒数计算间隔天数
    return (int)(ei/(1000*60*60*24));
}

(2)传进Date对象

/**计算两个时间之间相隔天数
 * @param startday  开始时间
 * @param endday 结束时间
 * @return
 */
public int getIntervalDays(Date startday,Date endday){
    //确保startday在endday之前
    if(startday.after(endday)){
        Date cal=startday;
        startday=endday;
        endday=cal;
    }
    //分别得到两个时间的毫秒数
    long sl=startday.getTime();
    long el=endday.getTime();

    long ei=el-sl;
    //根据毫秒数计算间隔天数
    return (int)(ei/(1000*60*60*24));
}

同理，可以用相同的方法计算出任意两个时间相隔的小时数，分钟数，秒钟数等

注：以上方法是完全按时间计算，有时并不能令人满意，如：

startday="2006-10-11 20:00:00" endday="2006-10-12 8:00:00"

计算结果为0，但是我们也许相让计算结果变为1，此时可以用如下方法实现：

在传参之前，先设定endday的时间，如：

endday.set(Calendar.HOUR_OF_DAY, 23);
endday.set(Calendar.MINUTE, 59);
endday.set(Calendar.SECOND, 59);
endday.set(Calendar.MILLISECOND, 59);

这样再传进去startday,endday，则结果就如我们所愿了。不过，如果嫌以上方法麻烦，可以参考以下方法：

(3)改进精确计算相隔天数的方法

    public int getDaysBetween (Calendar d1, Calendar d2) {
        if (d1.after(d2)) {  // swap dates so that d1 is start and d2 is end
            java.util.Calendar swap = d1;
            d1 = d2;
            d2 = swap;
        }
        int days = d2.get(Calendar.DAY_OF_YEAR) - d1.get(Calendar.DAY_OF_YEAR);
        int y2 = d2.get(Calendar.YEAR);
        if (d1.get(Calendar.YEAR) != y2) {
            d1 = (Calendar) d1.clone();
            do {
                days += d1.getActualMaximum(Calendar.DAY_OF_YEAR);//得到当年的实际天数
                d1.add(Calendar.YEAR, 1);
            } while (d1.get(Calendar.YEAR) != y2);
        }
        return days;
    }

注意事项：

Calendar 的 month 从 0 开始，也就是全年 12 个月由 0 ~ 11 进行表示。

而 Calendar.DAY_OF_WEEK 定义值如下，每周从 SUNDAY 开始，从 1 ~ 7：

Calendar.SUNDAY = 1
Calendar.MONDAY = 2
Calendar.TUESDAY = 3
Calendar.WEDNESDAY = 4
Calendar.THURSDAY = 5
Calendar.FRIDAY = 6
Calendar.SATURDAY = 7

SimpleDateFormat 的格式定义

Letter	Date or Time Component	Presentation	Examples
G	Era designator	Text	AD
y	Year	Year	1996; 96
Y	Week year	Year	2009; 09
M	Month in year (context sensitive)	Month	July; Jul; 07
L	Month in year (standalone form)	Month	July; Jul; 07
w	Week in year	Number	27
W	Week in month	Number	2
D	Day in year	Number	189
d	Day in month	Number	10
F	Day of week in month	Number	2
E	Day name in week	Text	Tuesday; Tue
u	Day number of week (1 = Monday, ..., 7 = Sunday)	Number	1
a	Am/pm marker	Text	PM
H	Hour in day (0-23)	Number	0
k	Hour in day (1-24)	Number	24
K	Hour in am/pm (0-11)	Number	0
h	Hour in am/pm (1-12)	Number	12
m	Minute in hour	Number	30
s	Second in minute	Number	55
S	Millisecond	Number	978
z	Time zone	General time zone	Pacific Standard Time; PST; GMT-08:00
Z	Time zone	RFC 822 time zone	-0800
X	Time zone	ISO 8601 time zone	-08; -0800; -08:00

Java Calendar 演示代码如下：

1.  
   package demo;
2.  
    
3.  
   import java.util.Date;
4.  
   import java.text.SimpleDateFormat;
5.  
   import java.text.DateFormat;
6.  
   import java.text.ParseException;
7.  
   import java.util.Calendar;
8.  
    
9.  
   public class Test
10.  
    {
11.  
    public Test()
12.  
    {
13.  
    }
14.  
     
15.  
    public static void main(String[] args)
16.  
    {
17.  
    // 字符串转换日期格式
18.  
    // DateFormat fmtDateTime = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
19.  
    // 接收传入参数
20.  
    // String strDate = args[1];
21.  
    // 得到日期格式对象
22.  
    // Date date = fmtDateTime.parse(strDate);
23.  
     
24.  
    // 完整显示今天日期时间
25.  
    String str = (new SimpleDateFormat("yyyy-MM-dd HH:mm:ss:SSS")).format(new Date());
26.  
    System.out.println(str);
27.  
     
28.  
    // 创建 Calendar 对象
29.  
    Calendar calendar = Calendar.getInstance();
30.  
     
31.  
    try
32.  
    {
33.  
    // 对 calendar 设置时间的方法
34.  
    // 设置传入的时间格式
35.  
    SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-M-d H:m:s");
36.  
    // 指定一个日期
37.  
    Date date = dateFormat.parse("2013-6-1 13:24:16");
38.  
    // 对 calendar 设置为 date 所定的日期
39.  
    calendar.setTime(date);
40.  
     
41.  
    // 按特定格式显示刚设置的时间
42.  
    str = (new SimpleDateFormat("yyyy-MM-dd HH:mm:ss:SSS")).format(calendar.getTime());
43.  
    System.out.println(str);
44.  
    }
45.  
    catch (ParseException e)
46.  
    {
47.  
    e.printStackTrace();
48.  
    }
49.  
     
50.  
    // 或者另一種設置 calendar 方式
51.  
    // 分別爲 year, month, date, hourOfDay, minute, second
52.  
    calendar = Calendar.getInstance();
53.  
    calendar.set(2013, 1, 2, 17, 35, 44);
54.  
    str = (new SimpleDateFormat("yyyy-MM-dd HH:mm:ss:SSS")).format(calendar.getTime());
55.  
    System.out.println(str);
56.  
     
57.  
    // Calendar 取得当前时间的方法
58.  
    // 初始化 (重置) Calendar 对象
59.  
    calendar = Calendar.getInstance();
60.  
    // 或者用 Date 来初始化 Calendar 对象
61.  
    calendar.setTime(new Date());
62.  
     
63.  
    // setTime 类似上面一行
64.  
    // Date date = new Date();
65.  
    // calendar.setTime(date);
66.  
     
67.  
    str = (new SimpleDateFormat("yyyy-MM-dd HH:mm:ss:SSS")).format(calendar.getTime());
68.  
    System.out.println(str);
69.  
     
70.  
    // 显示年份
71.  
    int year = calendar.get(Calendar.YEAR);
72.  
    System.out.println("year is = " + String.valueOf(year));
73.  
     
74.  
    // 显示月份 (从0开始, 实际显示要加一)
75.  
    int month = calendar.get(Calendar.MONTH);
76.  
    System.out.println("nth is = " + (month + 1));
77.  
     
78.  
    // 本周几
79.  
    int week = calendar.get(Calendar.DAY_OF_WEEK);
80.  
    System.out.println("week is = " + week);
81.  
     
82.  
    // 今年的第 N 天
83.  
    int DAY_OF_YEAR = calendar.get(Calendar.DAY_OF_YEAR);
84.  
    System.out.println("DAY_OF_YEAR is = " + DAY_OF_YEAR);
85.  
     
86.  
    // 本月第 N 天
87.  
    int DAY_OF_MONTH = calendar.get(Calendar.DAY_OF_MONTH);
88.  
    System.out.println("DAY_OF_MONTH = " + String.valueOf(DAY_OF_MONTH));
89.  
     
90.  
    // 3小时以后
91.  
    calendar.add(Calendar.HOUR_OF_DAY, 3);
92.  
    int HOUR_OF_DAY = calendar.get(Calendar.HOUR_OF_DAY);
93.  
    System.out.println("HOUR_OF_DAY + 3 = " + HOUR_OF_DAY);
94.  
     
95.  
    // 当前分钟数
96.  
    int MINUTE = calendar.get(Calendar.MINUTE);
97.  
    System.out.println("MINUTE = " + MINUTE);
98.  
     
99.  
    // 15 分钟以后
100.  
     calendar.add(Calendar.MINUTE, 15);
101.  
     MINUTE = calendar.get(Calendar.MINUTE);
102.  
     System.out.println("MINUTE + 15 = " + MINUTE);
103.  
      
104.  
     // 30分钟前
105.  
     calendar.add(Calendar.MINUTE, -30);
106.  
     MINUTE = calendar.get(Calendar.MINUTE);
107.  
     System.out.println("MINUTE - 30 = " + MINUTE);
108.  
      
109.  
     // 格式化显示
110.  
     str = (new SimpleDateFormat("yyyy-MM-dd HH:mm:ss:SS")).format(calendar.getTime());
111.  
     System.out.println(str);
112.  
      
113.  
     // 重置 Calendar 显示当前时间
114.  
     calendar.setTime(new Date());
115.  
     str = (new SimpleDateFormat("yyyy-MM-dd HH:mm:ss:SS")).format(calendar.getTime());
116.  
     System.out.println(str);
117.  
      
118.  
     // 创建一个 Calendar 用于比较时间
119.  
     Calendar calendarNew = Calendar.getInstance();
120.  
      
121.  
     // 设定为 5 小时以前，后者大，显示 -1
122.  
     calendarNew.add(Calendar.HOUR, -5);
123.  
     System.out.println("时间比较：" + calendarNew.compareTo(calendar));
124.  
      
125.  
     // 设定7小时以后，前者大，显示 1
126.  
     calendarNew.add(Calendar.HOUR, +7);
127.  
     System.out.println("时间比较：" + calendarNew.compareTo(calendar));
128.  
      
129.  
     // 退回 2 小时，时间相同，显示 0
130.  
     calendarNew.add(Calendar.HOUR, -2);
131.  
     System.out.println("时间比较：" + calendarNew.compareTo(calendar));
132.  
     }
133.  
     }

运行结果

1.  
   2013-06-07 23:27:34:195
2.  
   2013-06-01 13:24:16:000
3.  
   2013-02-02 17:35:44:197
4.  
   2013-06-07 23:27:34:197
5.  
   year is = 2013
6.  
   nth is = 6
7.  
   week is = 6
8.  
   DAY_OF_YEAR is = 158
9.  
   DAY_OF_MONTH = 7
10.  
    HOUR_OF_DAY + 3 = 2
11.  
    MINUTE = 27
12.  
    MINUTE + 15 = 42
13.  
    MINUTE - 30 = 12
14.  
    2013-06-08 02:12:34:197
15.  
    2013-06-07 23:27:34:199
16.  
    时间比较：-1
17.  
    时间比较：1
18.  
    时间比较：0

要计算时间差，可用 Calendar.getTimeInMillis() 取得两个时间的微秒级的时间差，再加以换算即可，比如获得相差天数，代码如下：

1.  
   // 得微秒级时间差
2.  
   long val = calendarEnd.getTimeInMillis() - calendarBegin.getTimeInMillis();
3.  
   // 换算后得到天数
4.  
   long day = val / (1000 * 60 * 60 * 24);