Web基础之Calendar的应用

前言

在Web开发中也经常要做时间日期这样的操作，这篇文章简单的介绍了Calendar这个类的使用

正文

在java中经常使用到的两个操作时间的类是SimpleDateFormat和Calendar，前者主要是格式化指定的时间格式，后者则提供了非常丰富的时间操作的api，满足日常的业务需求

这里主要介绍一下Calendar这个类，可以先参考一下jdk7中的Calendar

Calendar两种模式

lenient 模式：可以接收更大范围的Calenar字段，使用get方法它将重新计算这个字段，让所有的Calenar回到正常范围内。比如设置Calendar字段为1月32号，使用Calendar的get方法会得到2月1号

non-lenient模式：这个模式和上面一个模式恰好相反，对任何的Calendar字段设置超过它对应的范围的值，则抛出异常。比如DAY_OF_MONTH 的范围在1-max，一旦超过这个范围就抛出一个异常

Calendar基本一些概念

DAY_OF_MONTH

当前时间在这个月是第几天，比如今天是11月10号，那么返回的就是10的值

WEEK_OF_MONTH

日历式的第几周，比如今天是2016年10月31，那么是10月1号是星期六，根据getFirstDayOfWeek知道一周的开始是星期日，那么10月1号（星期六-10月2号(星期日）为一周，10月2（星期日）号到8号（星期六）为第二周10月30号（星期日）-10月31号（星期一）是第六周

搭配calendar的get方法，返回的值就是当前时间在这个月的第几周

DAY_OF_WEEK_IN_MONTH

某月中第几周 按这个月1号算，1号起就是第1周，8号起就是第2周。以月份天数为标准

获取字段的最大值，最小值

getActualMaximum(int field)与getActualMinimum(int field)，比如要获取本月最大周数，同理获取本月最大天数

/**
* 当前这个月最大的周数
* @return
*/
public static int weeksInMonth() {
return calendar.getActualMaximum(Calendar.WEEK_OF_MONTH);
}

获取/设置一周的开始时间

美的一周开始是周日，在法国是一周开始时间是周一，可以通过

下面两个方法获取和设置一周开始的时间。上面罗列的获取本月最大周数是和这个一周的开始时间相关的

/**
* 一周的第一天是星期几
* 美国是星期日，而法国是星期一
* 这里返回值为1（Month），所以默认星期日作为一周的开始
* @return
*/
public static int getFirstDayOfWeek() {
return calendar.getFirstDayOfWeek();
}
/**
* 设置星期几作为一个星期的第一天
* Sunday = 1  saturday = 7
* @param firstDay
*/
public static void setFirstDayOfWeek(int firstDay) {
calendar.setFirstDayOfWeek(firstDay);
}

几个需要注意的api方法

set方法

/**
* set(f, value)，当使用set更改指定字段的值时，
* 这个方法里面一个内部的成员变量记录了这个字段的变化，
* 但是Calendar的时间值却未发送变化，除非调用以下方法
* get(), getTime(), getTimeInMillis(), add(), or roll()
* 当超过其内的字段的范围，就会自动调节，更大的字段增加或减少（模式1）
*/
public static Date setMonth(int month) {
//因为月份中0 代表一月，依次计算，这里为了符合正常逻辑思维，这里减去1调整
calendar.set(Calendar.MONTH, month-1);
return calendar.getTime();
}

add方法

/**
* add(f,delta)
* rule1:在现在的f字段上，增加delta的值，如果当前的f字段超出范围，那么下一个最大的字段增加或者减少
* 来调整这个f回到正常范围
* rule2:当字段f增加了delta以后，比f小的字段期望是不变的，但是这是不能和原先相等，因为字段f的最小和最大范围在变
* 或者其它约束如时区等，所以会调整为尽可能的接近之前的那个值，比如1992-8-31 ，add(Calendar.MONTH, 13)，
* 增加13个月后为2000-9-30. 比这个MONTH更小的字段 DAY_OF_MONTH不存在31，所以调整为最接近的数为30
*/
public static Date addMonth(int month) {
calendar.add(Calendar.MONTH, month);
return calendar.getTime();
}

roll方法

/**
* roll(f,delta) 方法，比指定的field更大的field不会变
* 比如指定是Month，那么比这个Month更大的字段就是YEAR
* 当f增加delta后超出这个字段的范围（比如Month范围在1-12），那么比
* 这个字段更大的字段（YEAR)是不会变的，而当前这个f字段的值是取范围的模
*/
public static Date rollMonth(int month) {
calendar.roll(Calendar.MONTH, month);
return calendar.getTime();
}

实战

情景：在学习Calendar的时候无意中看到了win10操作系统的时间样式，从上到下是时间，日期，日历的信息内容，故以此作为练习的例子

业务：

显示时间信息，按照“年月日，星期，时间“

可以随时更改哪一天作为一周的开始时间（周日，周一）

展现当前月份的所有周数的全部日期

代码：

根据哪天作为一周第一天来显示一周的星期文本，如：日 一 二 三 四 五 六

/**
* 使用循环与取模的方式，将固定数组中的值按照指定的方式展示
* 更改firstDayOfWeek:DateUtil.setFirstDayOfWeek(Calendar.SUNDAY);
* @return
*/
private String[] datas = new String[] {"日","一","二","三","四","五","六"};

public String getFirstDayOfWeekInfo() {
StringBuffer info = new StringBuffer();
int first = firstDayOfWeek = DateUtil.getFirstDayOfWeek(); //一周的第一天是星期几（日为1,六为7）
//1-7取模
int model = (first-1)%7;
int pos = -1;
while(pos != model) {
info.append(datas[((first-1)%7)]).append("  ");
first++;
pos = (first-1)%7;
}
return info.toString();
}

显示这个月的所有日期

/**
* 注意的是DateUtil这个工具类是共用一个Calendar对象
* 里面的值一个更改是会影响到其他地方，请小心操作
* @return
*/
public void showCalendarInfo() {
int begin = getBeginDateOfFirstWeek(); //第一周开始计算的日期
int weeks = DateUtil.weeksInMonth(); //当月最大周数
StringBuffer info = new StringBuffer();
DateUtil.addDay(begin); //设置开始的时间起点，比如11月份第一周第一天是10月30号
int increase = 1;
while((weeks--)>0) { //一共有几周
int count = 1;
info.delete(0,info.length()); //清空
while(count++ < 8) { //输出一周的日期
String showDay = DateUtil.transform2Text(DateUtil.showCurrentDate(), "dd");
info.append(showDay).append("   ");
DateUtil.addDay(increase);//递增时间
}
System.out.println(info.toString());//换行
}
}
private int getBeginDateOfFirstWeek() {
DateUtil.setDay(1);//设置为当月的1号
int firstDayOfWeekOfMonth = DateUtil.getDayOfWeek();
//计算第一周的第一天的日期，比如2016-11月份的第一周的第一天是10月30号
if(firstDayOfWeek > firstDayOfWeekOfMonth) {
firstDayOfWeekOfMonth = firstDayOfWeekOfMonth+7;
}
//和当月1号相差的天数，回退到那一天
int backDay = firstDayOfWeekOfMonth - firstDayOfWeek;
return -backDay;
}