8.算法竞赛中的常用JAVA API ：Calendar日期类

摘要

在蓝桥杯中有关于日期计算的问题，正好java中的Date类和Calendar类提供了对日期处理的一些方法。Date类大部分方法已经废弃了，所以本文将详细介绍Calendar类。

Calendar类

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

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

常用的日历字段

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

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

• DAY_OF_MONTH get 和 set 的字段数字, 指示一个月中的某天。

• DAY_OF_WEEK get 和 set 的字段数字, 指示一个星期中的某天。

• DAY_OF_YEAR get 和 set 的字段数字, 指示当前年中的天数。

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

• HOUR get 和 set 的字段数字,指示当天中的某小时

• MINUTE get 和 set 的字段数字,指示当前小时中的某分钟

• SECOND get 和 set 的字段数字,指示当前分钟中的某秒

  time 以毫秒为单位，表示自格林威治标准时间 1970 年 1月 1 日 0:00:00 后经过的时间。

  (字段就是Calendar类的成员变量，用于存储当前日历的年月日等时间信息。）

Calendar类的实例化

来看Calendar的声明：

public abstract class Calendar
extends Objectimplements Serializable, Cloneable, Comparable<Calendar>{}

该类被abstract所修饰，说明不能通过new的方式来获得实例，对此，Calendar提供了一个类方法getInstance，以获得此类型的一个通用的对象，getInstance方法返回一个Calendar对象（该对象为Calendar的子类对象），其日历字段已由当前日期和时间初始化：

getInstance();//返回一个默认时区和语言环境的日历

Calendar calendar = Calendar.getInstance();//赋值给calendar

之所以说返回的是Calendar的子类对象，是因为每个国家地区都有自己的一套日历算法，比如西方国家的第一个星期大部分为星期日，而中国则为星期一。我们来看看getInstance方法获取实例的源码：

public static Calendar getInstance(){
Calendar cal = createCalendar(TimeZone.getDefaultRef(), Locale.getDefault(Locale.Category.FORMAT));
cal.sharedZone = true;
return cal;
}

设置特定日期

set(int field, int value);//第一个参数是日期字段，诸如YEAR、MONTH 等将给定的日历字段设置为给定值。

set(int year, int month, int date)// 设置日历字段年月日的值

Calendar calendar = Calendar.getInstance();//创建个实例
int year = 2020;
int month = 1;//1是二月 0是1月
int day = 1;
calendar.set(Calendar.YEAR, year);// 将year的值赋给calender的YEAR字段
calendar.set(Calendar.MONTH, month);//将month的值赋给calender的MONTH字段
calendar.set(Calendar.DAY_OF_MONTH, day);//将day的值赋值给calendder的DAT_OF_MONTH字段//以上就完成了对calender的字段设置。

获取当前Calender实例的字段信息

get(int field);// 获取给定字段的值

Calendar calendar = Calendar.getInstance();
// 设置日期为: 2020.1.21
calendar.set(Calendar.YEAR, 2020);
calendar.set(Calendar.MONTH, 0);//月份从0开始。
calendar.set(Calendar.DAY_OF_MONTH, 21);
// 获取2020.1.21是星期几
System.out.print(calendar.get(Calendar.DAY_OF_WEEK));输出：
3 // 3代表星期二

注意事项

1. 在获取月份时，Calendar.MONTH + 1 的原因

Java中的月份遵循了罗马历中的规则：当时一年中的月份数量是不固定的，第一个月是JANUARY。而Java中Calendar.MONTH返回的数值其实是当前月距离第一个月有多少个月份的数值，所以月份为JANUARY在Java中返回“0”，依次类推也就是在取Calendar.MONTH的值时我们需要+1。

1. 在获取星期几 Calendar.DAY_OF_WEEK – 1 的原因

Java中Calendar.DAY_OF_WEEK其实表示：一周中的第几天，所以他会受到 第一天是星期几 的影响。

有些地区以星期日作为一周的第一天，而有些地区以星期一作为一周的第一天，这2种情况是需要区分的。

看下表的返回值

所以Calendar.DAY_OF_WEEK需要根据本地化设置的不同而确定是否需要 “-1”

Java中设置不同地区的输出可以使用 Locale.setDefault(Locale.地区名) 来实现。

3. 获取日期时 Calendar.DAY_OF_MONTH 不需要特殊的操作，他直接返回一个月中的第几天

1.获取时间

import java.text.SimpleDateFormat;
import java.util.Calendar;
public class CalenderTest {
//获取时间：以目前系统时间 ：2019:01:27 16:27:27 为例
@Test
public void testGetCalender() {
Calendar cal = Calendar.getInstance();    //Calendar类的实例化
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");//时间的格式化//当前系统时间
Date date = cal.getTime();//date=Sun Jan 27 16:27:27 CST 2019
String nowTime = sdf.format(cal.getTime());//nowTime=2019-01-27 16:27:27//当前年
int year = cal.get(Calendar.YEAR);//year=2019//当前月 Calendar.MONTH从0开始 ,使用时通常会+1
int month = cal.get(Calendar.MONTH) + 1;//month=1//当前日：两种方法等价
int day_of_month = cal.get(Calendar.DAY_OF_MONTH);//day_of_month=27
int day = cal.get(Calendar.DATE);  //day=27//获取当月day的最大值！！
int max_day_of_month = cal.getActualMaximum(Calendar.DAY_OF_MONTH);//max_day_of_month=31//当前时钟：24小时制
int hour24 = cal.get(Calendar.HOUR_OF_DAY);//hour24=16//当前时钟：12小时制
int hour12 = cal.get(Calendar.HOUR); //hour12=4//当前:分钟
int minute = cal.get(Calendar.MINUTE);   //minute=27//当前秒
int second = cal.get(Calendar.SECOND);  //second=27//星期几：用数字（1~7）表示（星期日~星期六），使用时通常会-1
int day_of_week = cal.get(Calendar.DAY_OF_WEEK) - 1;//day_of_week=0//上午-0；下午-1
int amOrPm = cal.get(Calendar.AM_PM);  //amOrPm=1//当前年的第几周
int week_of_year = cal.get(Calendar.WEEK_OF_YEAR);//week_of_year=5//当前月的星期数
int week_of_month = cal.get(Calendar.WEEK_OF_MONTH);//week_of_month=5//当前月中的第几个星期
int day_of_week_in_month = cal.get(Calendar.DAY_OF_WEEK_IN_MONTH); //day_of_week_in_month=4//当前年的第几天
int day_of_year = cal.get(Calendar.DAY_OF_YEAR);//day_of_year=27
}
}

2. 设置时间

import java.text.SimpleDateFormat;
import java.util.Calendar;
public class CalenderTest {
//设置时间：以目前系统时间 ：2019:01:27 16:27:27 为例
@Test
public void testSetCalender() {
Calendar cal = Calendar.getInstance();    //Calendar类的实例化
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");//时间的格式化//1.当前系统时间
Date date = cal.getTime();//data=Sun Jan 27 16:27:27 CST 2019
String nowTime = sdf.format(cal.getTime());//nowTime=2019-01-27 16:27:27//2.设置时间：不设置项，默认Calendar已经存在日期
cal.set(Calendar.HOUR_OF_DAY, 11);
cal.set(Calendar.MINUTE, 30);
cal.set(Calendar.SECOND, 30);
String date1 = sdf.format(cal.getTime());//time=2019-01-27 11:30:30//3.设置时间：全部设置，则输出自定义时间
cal.set(Calendar.YEAR, 2018);
cal.set(Calendar.MARCH, 7);
cal.set(Calendar.DATE, 21);
String date2 = sdf.format(cal.getTime());//time=2018-08-21 11:30:30//4.时间重置：Date date = new date();
String newDate1 = sdf.format(cal.getTime());//newDate1=2018-08-21 11:30:30
String newDate2 = sdf.format(new Date());//newDate2=2019:01:27 16:27:27
}
}

3. 时间运算

import java.text.SimpleDateFormat;
import java.util.Calendar;
public class CalenderTest {
//时间运算：以目前系统时间 ：2019:01:27 16:27:27 为例
@Test
public void testAddCalender() {
Calendar cal = Calendar.getInstance();    //Calendar类的实例化
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");//时间的格式化String nowTime = sdf.format(cal.getTime());//nowTime=2019-01-27 16:27:27cal.add(Calendar.YEAR, 1);
String time1 = sdf.format(cal.getTime());//年:2020-01-27 16:27:27cal.add(Calendar.MONTH, 2);
String time2 = sdf.format(cal.getTime());//月:2020-03-27 16:27:27cal.add(Calendar.DATE, 5);
String time3 = sdf.format(cal.getTime());//日:2020-04-01 16:27:27cal.add(Calendar.HOUR_OF_DAY, -1);
String time4 = sdf.format(cal.getTime());//时:2020-04-01 15:27:27cal.add(Calendar.MINUTE, 1);
String time5 = sdf.format(cal.getTime());//分:2020-04-01 15:28:27cal.add(Calendar.SECOND, 1);
String time6 = sdf.format(cal.getTime());//秒:2020-04-01 15:27:28
}
}

注意事项

1. Calendar的容错性

我们直接举例说明：

调用Calendar对象的set()方法改变指定时间字段的值时，有可能传入一个不合法的参数，例如：为MONTH字段设置13，这将会导致什么结果呢？

//Calendar：容错性测试
@Test
public void testCalender() {
SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
Calendar calendar = Calendar.getInstance();// Calendar容错性：true-打开；false-关闭
calendar.setLenient(false);calendar.set(Calendar.MONTH, 13);
System.out.println("A="+simpleDateFormat.format(calendar.getTime()));// A标记}

当打开calendar.setLenient(true)时（默认）：

A处代码可以正常运行，因为将MONTH字段设置为13，将会使YEAR字段计算加1；

输出结果：A=2020-02-12 13:59:33。

当关闭calendar.setLenient(false)时：

A处将会导致运行异常，因为设置的MONTH字段超出了所允许的范围。

关键在于程序中注释有“容错性”的代码行：

Calendar提供一个setLenient用于设置它的容错性，Calendar默认支持比较好的容错性，通过setLenient(false)关闭Calendar的容错性，让它进行严格的参数检查。

Calendar有两种解释日历字段的模式：lenient模式，non-lenient模式

当处于lenient模式时，每个字段都可接受超出范围的值；

当处于non-lenient模式时，每个字段都进行严格的参数检查，不接收超出字段的值。

2.set()的延迟性

set(int field, int value)方法日历的某个字段修改为value值，此外它还设置了一个内部成员变量，以指示日历字段field已经被更改。尽管日历字段field是立即更改的，但该Calendar所代表的事件却不会立即修改，直到下次调用get()、getTime()、getTimeInMillis()、add()或roll()时才会重新计算日历的时间。

这被称为set()方法的延迟修改，采用延迟修改的优势是多次调用set()不会触发多次不必要的运算，下面来看一个例子：

// set():延迟修改性
@Test
public void testCalender1() {
SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");        Calendar calendar = Calendar.getInstance();        calendar.set(2019, 2, 31);        calendar.set(Calendar.MONTH, 8); //包含getTime()方法，注释掉此行代码，运行结果截然不同
        System.out.println("A="+simpleDateFormat.format(calendar.getTime())); // A标记        calendar.set(Calendar.DATE, 5);        System.out.println("B="+simpleDateFormat.format(calendar.getTime())); // B标记
}

打印结果：

• 注释掉 A行 之前：（set一次，get一次，一步一运算）

  A=2019-10-01 13:27:55

  B=2019-10-05 13:27:55

• 注释掉 A行 之后：（set两次，get一次，最后再运算）

  B=2019-09-05 13:33:21

小结

1. Calendar 类区分不同的时区输出时间格式；

2. Calendar 类的计算优势非常明显，不需要考虑每个月有多少天，非常便利。举个例子：如果要计算昨天的日期，你要考虑昨天是不是某月的最后一天，某年的最后一天，要考虑平年、闰年，考虑上个月是31天，30天，29天还是28天…但是Calendar类省去了你所有的顾虑，直接减1天就可以输出正确的日期了；

3. Calendar 类使用时要注意它的容错性和延迟性。

注： 转载于 https://blog.csdn.net/GD_ONE/article/details/104061292

https://blog.csdn.net/weixin_44259720/article/details/86669177