Calendar目录
一、概述
java.util.Calendar类是一个抽象类, 无法通过直接实例化得到对象 ,并且它是java日期处理的核心类之一。Calendar类为操作日历的类。日历字段包含YEAR、MONTH、DAY_OF_MONTH、HOUR等,它们都是Calendar类的静态常量。
创建实例对象如下 ,默认当前日期。
Calendar calendar = Calendar.getInstance();
System.out.println(cal.getTime());//Mon Jun 28 19:30:31 CST 2021
二、常量
//指示年
Calendar.YEAR
//指示月份
Calendar.MONTH
//指示当前时间为多少号(日历式的多少号)
Calendar.DATE
//指示小时(12小时制)
Calendar.HOUR
//指示小时(24小时制)
Calendar.HOUR_OF_DAY
//指示分钟数
Calendar.MINUTE
//指示秒数
Calendar.SECOND
//指示毫秒
Calendar.MILLISECOND
//当前时间是所在当前月的第几个星期(日历式的第几周)
Calendar.WEEK_OF_MONTH
//当前时间是所在当前年的第几个星期
Calendar.WEEK_OF_YEAR
//当前时间是所在当前月的第几个星期,以月份天数为标准,一个月的1号为第一周,8号为第二周
Calendar.DAY_OF_WEEK_IN_MONTH
//一周7天当中,当前时间是星期几
Calendar.DAY_OF_WEEK
//指示一年中的第几天
Calendar.DAY_OF_YEAR
//指示一月中的第几天,结果等同于Calendar.DATE
Calendar.DAY_OF_MONTH
//指示上午还是下午
Calendar.AM_PM
//周天
Calendar.SUNDAY
//周一
Calendar.MONDAY
//周二
Calendar.TUESDAY
//周三
Calendar.WEDNESDAY
//周四
Calendar.THURSDAY
//周五
Calendar.FRIDAY
//周六
Calendar.SATURDAY
三、取日历的值
//获得年、月、日、时、分、秒、毫秒
ca.get(Calendar.YEAR);
ca.get(Calendar.MONTH);
ca.get(Calendar.DATE);
ca.get(Calendar.HOUR_OF_DAY);
ca.get(Calendar.MINUTE);
ca.get(Calendar.SECOND);
ca.get(Calendar.MILLISECOND);
//当前时间是所在当前月的第几个星期(日历式的第几周)
ca.get(Calendar.WEEK_OF_MONTH);
//当前时间是所在当前年的第几个星期(日历式的第几周)
ca.get(Calendar.WEEK_OF_YEAR));
//当前时间是所在当前月的第几个星期,以月份天数为标准,一个月的1号为第一周,8号为第二周
ca.get(Calendar.DAY_OF_WEEK_IN_MONTH);
//一周7天当中,当前时间是星期几, 返回结果为1-7
ca.get(Calendar.DAY_OF_WEEK);
//一年中的第几天
ca.get(Calendar.DAY_OF_YEAR);
//判断当前时间是AM,还是PM,若是AM返回结果为0,若是PM返回结果为1
ca.get(Calendar.AM_PM);
四、设置日历字段的值。
set(int field, int value);
set(int year, int month, int day);
set(int year, int month, int day, int hour, int minute);
set(int year, int month, int day, int hour, int minute, int second);
设置年、月、日、时、分、秒、毫秒
月份的正常值范围为0-11,0表示一月,以此类推。日期的正常值范围为1-31,结尾数字视月份而定。
//2021-06-28 00:00:00
Calendar ca = Calendar.getInstance();
ca.set(Calendar.YEAR,2021);
ca.set(Calendar.MONTH,06);
ca.set(Calendar.DATE,28);
ca.set(Calendar.HOUR_OF_DAY,0);
ca.set(Calendar.MINUTE,0);
ca.set(Calendar.SECOND,0);
五、日历可以前后设置
//2020-12-31
ca.set(Calendar.YEAR,2021);
ca.set(Calendar.MONTH,0);
//设置为0天,指向上月的最后一天
ca.set(Calendar.DATE,0);
//2020-12-30
ca.set(Calendar.YEAR,2021);
ca.set(Calendar.MONTH,0);
ca.set(Calendar.DATE,-1);
//10:09:59
ca.set(Calendar.HOUR_OF_DAY,10);
ca.set(Calendar.MINUTE,10);
ca.set(Calendar.SECOND,-1);
//09:58:59
ca.set(Calendar.HOUR_OF_DAY,10);
ca.set(Calendar.MINUTE,-1);
ca.set(Calendar.SECOND,-1);
将Calendar日期对象指向当前周的某一天
//将日历对象指向当前周的周天
Calendar ca = Calendar.getInstance();
//第二个参数的取值范围是表示周一到周天的七个静态常量
ca.set(Calendar.DAY_OF_WEEK,Calendar.SUNDAY);
六、日历的计算加减
Calendar ca = Calendar.getInstance();
ca.set(Calendar.YEAR,2020);
//当前日历年份加一
ca.add(Calendar.YEAR,1);
System.out.println(ca.get(Calendar.YEAR)); //2021
//当前日历年份减一
ca.add(Calendar.YEAR,-1);
System.out.println(ca.get(Calendar.YEAR)); //2019
ca.set(Calendar.MONTH,10);
//当前日历月份加一
ca.add(Calendar.MONTH,1);
System.out.println(ca.get(Calendar.MONTH)); //11
//当前日历月份减一
ca.add(Calendar.MONTH,-1);
System.out.println(ca.get(Calendar.MONTH)); //10
Calendar ca = Calendar.getInstance();
ca.set(Calendar.DAY_OF_MONTH,10);
七、日历的比较
after方法
判断Calendar日期对象表示的时间是否在另一个日期对象表示的时间之后,返回true或false。例如2020年在。
Calendar cal = Calendar.getInstance();
Calendar future = Calendar.getInstance();
future.set(Calendar.YEAR, 2030);
System.out.println(future.after(cal)); //true
before方法
判断Calendar日期对象表示的时间是否在另一个日期对象表示的时间之前,返回true或false。例如2019年在2020年之前。
Calendar cal = Calendar.getInstance();
Calendar future = Calendar.getInstance();
future.set(Calendar.YEAR, 2020);
System.out.println(cal.before(future)); //true
clear方法
该方法可以将所有日历字段的值和时间值(从历元至现在的毫秒偏移量)设置为初始状态。一般使用set方法之前,必须先clear一下,否则很多信息会继承自系统当前时间。
Calendar cal = Calendar.getInstance();
System.out.println(cal.getTime()); //Mon Jun 28 19:25:46 CST 2021
cal.clear();
System.out.println(cal.getTime()); //Thu Jan 01 00:00:00 CST 1970
clone方法
创建并返回一个Calendar日期对象的副本,返回结果为Object类型。副本和原日期对象互不影响。
compareTo方法
比较当前Calendar日期对象与另一个Calendar日期对象表示的时间值大小(毫秒偏移量),返回结果为0、1或-1。其中0表示两个日期对象表示的时间值相等,-1表示当前Calendar日期对象在另一个Calendar日期对象表示的时间之前。1表示当前Calendar日期对象在另一个Calendar日期对象表示的时间之后。
Calendar cal1 = new GregorianCalendar(2015, 8, 15);
Calendar cal2 = new GregorianCalendar(2008, 1, 02);
int ret0 = cal1.compareTo(cal2);
int ret1 = cal2.compareTo(cal1);
System.out.println(ret0); // 1
System.out.println(ret1); //-1
equals****方法
将Calendar日期对象与另一个Calendar日期对象比较,返回true或false。
getActualMaximum****方法
返回指定日历字段可能拥有的实际最大值。
Calendar ca = Calendar.getInstance();
//返回当前月最大天数
System.out.println(ca.getActualMaximum(Calendar.DAY_OF_MONTH));
System.out.println(ca.getActualMaximum(Calendar.DATE));
//返回23
System.out.println(ca.getActualMaximum(Calendar.HOUR_OF_DAY));
//返回11
System.out.println(ca.getActualMaximum(Calendar.HOUR));
//返回当前月有多少周
System.out.println(ca.getActualMaximum(Calendar.WEEK_OF_MONTH));
//返回当前年度最大天数
System.out.println(ca.getActualMaximum(Calendar.DAY_OF_YEAR));
getActualMinimum方法
返回指定日历字段可能拥有的实际最小值。
Calendar ca = Calendar.getInstance();
//返回当前月最小天数:1
System.out.println(ca.getActualMinimum(Calendar.DAY_OF_MONTH));
System.out.println(ca.getActualMinimum(Calendar.DATE));
//返回0
System.out.println(ca.getActualMinimum(Calendar.HOUR_OF_DAY));
//返回0
System.out.println(ca.getActualMinimum(Calendar.HOUR));
//返回0
System.out.println(ca.getActualMinimum(Calendar.WEEK_OF_MONTH));
//返回当前年度最小天数:1
System.out.println(ca.getActualMinimum(Calendar.DAY_OF_YEAR));
getInstance****方法
使用默认时区和语言环境获得一个日历。实例化Calendar日期对象,默认为当前系统时间。返回一个默认用当前的语言环境和时区初始化的GregorianCalendar对象。
Calendar ca = Calendar.getInstance();
getMaximum****方法
返回指定日历字段的理论最大值。
//如果当前时间为2019-09-01
Calendar ca = Calendar.getInstance();
System.out.println(ca.getMaximum(Calendar.DAY_OF_MONTH)); //31, 理论最大值
System.out.println(ca.getActualMaximum(Calendar.DAY_OF_MONTH)); //30, 实际最大值
getMinimum****方法
返回指定日历字段的理论最小值。
getTime****方法
将Calendar日期对象转换为Date对象。
Calendar ca = Calendar.getInstance();
Date d = ca.getTime();
setTime****方法
将Date对象表示的时间值设置给Calendar日期对象。
Calendar ca = Calendar.getInstance();
ca.setTime(new Date());
getTimeInMillis方法
返回Calendar日期对象的时间戳。
Calendar ca = Calendar.getInstance();
System.out.println(ca.getTimeInMillis()); //1567334892295
setTimeInMillis****方法
用给定long值设置日历的当前时间。
Calendar ca = Calendar.getInstance();
ca.setTimeInMillis(500000);
System.out.println(ca.getTime());
roll****方法 ----> void roll(int field, boolean up)
在指定日历字段上添加或减去单个时间单元,不更改更大的字段。
//如果当前时间是2019-09-01
Calendar ca = Calendar.getInstance();
System.out.println("Month is " + ca.get(Calendar.MONTH));
ca.roll(Calendar.MONTH, false); //月份减一
System.out.println("Month is " + ca.get(Calendar.MONTH));
ca.roll(Calendar.MONTH, true); //月份加一
ca.roll(Calendar.MONTH, true); //月份加一
System.out.println("Month is " + ca.get(Calendar.MONTH));
//假如今天周三
Calendar ca = Calendar.getInstance();
System.out.println(ca.get(Calendar.DAY_OF_WEEK)); //4
ca.roll(Calendar.DAY_OF_WEEK, false);
System.out.println(ca.get(Calendar.DAY_OF_WEEK)); //3
roll****方法 ----> void roll(int field, int amount)
在指定日历字段上添加或减去指定的时间单元,不更改更大的字段。
//如果当前时间是2019-09-01
Calendar ca = Calendar.getInstance();
System.out.println("Month is " + ca.get(Calendar.MONTH));
ca.roll(Calendar.MONTH, -2); //月份减2
System.out.println("Month is " + ca.get(Calendar.MONTH));
//假如今天周三
Calendar ca = Calendar.getInstance();
System.out.println(ca.get(Calendar.DAY_OF_WEEK)); //4
ca.roll(Calendar.DAY_OF_WEEK, -2);
System.out.println(ca.get(Calendar.DAY_OF_WEEK)); //2
七天制星期
Calendar类规定一周的七天分别用静态常量1-7表示,其中1表示周天,7表示周六。Calendar类使用两个参数定义了特定于语言环境的七天制星期,其一星期的第一天,其二第一个星期的最少天数。
setMinimaldaysinfirstweek()
设置一年或一月中第一个星期所需的最少天数,取值范围为1-7,默认值为1,无返回值。
//如果当前日期为2019-08-02,周五
Calendar ca = Calendar.getInstance();
System.out.println(ca.get(Calendar.WEEK_OF_MONTH)); //1
ca.setMinimalDaysInFirstWeek(3);
System.out.println(ca.get(Calendar.WEEK_OF_MONTH)); //1
ca.setMinimalDaysInFirstWeek(4);
System.out.println(ca.get(Calendar.WEEK_OF_MONTH)); //0
getMinimalDaysInFirstWeek()
获取一年或一月中第一个星期的最少天数。
Calendar ca = Calendar.getInstance();
System.out.println(ca.getMinimalDaysInFirstWeek()); //1
setFirstDayOfWeek()
默认一周的第一天是星期日(用静态常量1表示),结束时间是星期六(用静态常量7表示)。该方法可以设置星期几为一周的第一天,不会影响表示周一到周天的七个静态常量。
Calendar ca = Calendar.getInstance();
//设置周一为一周的第一天
ca.setFirstDayOfWeek(Calendar.MONDAY);
修改一周的第一天会影响如下代码的执行结果。
ca.get(Calendar.WEEK_OF_MONTH); //当前时间是所在当前月的第几个星期(日历式的第几周)
ca.get(Calendar.WEEK_OF_YEAR)); //当前时间是所在当前年的第几个星期(日历式的第几周)
/**
* 如果当前日期为2019-08-02,周五
*/
Calendar ca = Calendar.getInstance();
//设置一年或一月中第一周最少4天
ca.setMinimalDaysInFirstWeek(4);
System.out.println(ca.get(Calendar.WEEK_OF_MONTH)); //0
//设置周一为一星期的第一天
ca.setFirstDayOfWeek(Calendar.MONDAY);
System.out.println(ca.get(Calendar.WEEK_OF_MONTH)); //1
getFirstDayOfWeek()
返回一周的第一天。
Calendar ca = Calendar.getInstance();
System.out.println(ca.getFirstDayOfWeek());
四、实例
将日历时间调整到0时0分0秒0毫秒
public static Calendar toZero(Calendar ca){
ca.set(Calendar.HOUR_OF_DAY, 0);
ca.set(Calendar.MINUTE, 0);
ca.set(Calendar.SECOND, 0);
ca.set(Calendar.MILLISECOND, 0);
return ca;
}
获取某月所有日期
public static List monthToDates(Date dt){
//创建list列表
List dts = new ArrayList();
//创建日历
Calendar ca = Calendar.getInstance();
//设置时间
ca.setTime(dt);
//将时间调整到当前日历月份最后一天
ca.set(ca.get(Calendar.YEAR),ca.get(Calendar.MONTH)+1, 0);
//获取当前日历月份的实际总天数
int dayNumOfMonth = ca.get(Calendar.DAY_OF_MONTH);
//将日历时间指向当前日历月份的一号
ca.set(Calendar.DAY_OF_MONTH, 1);
for (int i = 0; i < dayNumOfMonth; i++, ca.add(Calendar.DATE, 1)) {
//设置为0时0分0秒0毫秒
ca.set(Calendar.HOUR_OF_DAY, 0);
ca.set(Calendar.MINUTE, 0);
ca.set(Calendar.SECOND, 0);
ca.set(Calendar.MILLISECOND, 0);
//将Calendar日期对象转换为Date时间对象,保存到提前创建的列表中
Date d = ca.getTime();
dts.add(d);
}
return dts;
}
获取某月第一天
public static Date getFstDayOfMonth(Date dt) {
//创建日历
Calendar ca = Calendar.getInstance();
//设置时间
ca.setTime(dt);
//将日历时间调整到1号0时0分0秒
ca.set(Calendar.DAY_OF_MONTH, 1);
ca.set(Calendar.HOUR_OF_DAY, 0);
ca.set(Calendar.MINUTE, 0);
ca.set(Calendar.SECOND, 0);
ca.set(Calendar.MILLISECOND, 0);
//返回结果
return ca.getTime();
}
获取某月最后一天
public static Date getLstDayOfMonth(Date dt) {
//创建日历
Calendar ca = Calendar.getInstance();
//设置时间
ca.setTime(dt);
//将日历时间调整到上月最后一天
ca.set(Calendar.DAY_OF_MONTH, 0);
//将日历时间加一个月
ca.add(Calendar.MONTH, 1);
//将日历时间调整到0时0分0秒
ca.set(Calendar.HOUR_OF_DAY, 0);
ca.set(Calendar.MINUTE, 0);
ca.set(Calendar.SECOND, 0);
ca.set(Calendar.MILLISECOND, 0);
//返回结果
return ca.getTime();
}
判断是不是当前月
public static boolean isNowMonth(Date date) {
//获取当前月第一天
Date fst = getFstDayOfMonth(new Date());
//获取目标月第一天
Date fstOfDate = getFstDayOfMonth(date);
//判断是否相等
if(fst.equals(fstOfDate)) return true;
return false;
}
获取本周的第一天
public static Date getFstDayOfWeek(Date dt) {
//创建日历
Calendar ca = Calendar.getInstance();
//设置时间
ca.setTime(dt);
//设置周一为每周的第一天
ca.setFirstDayOfWeek(Calendar.MONDAY);
//设置一年或一月中第一周最少七天
ca.setMinimalDaysInFirstWeek(7);
//将Calendar日期对象指向本周的周一
ca.set(Calendar.DAY_OF_WEEK, Calendar.MONDAY);
//将日历时间调整为0时0分0秒
ca.set(Calendar.HOUR_OF_DAY, 0);
ca.set(Calendar.MINUTE, 0);
ca.set(Calendar.SECOND, 0);
ca.set(Calendar.MILLISECOND, 0);
//返回结果
return ca.getTime();
}
获取本周所有的日期,按时间先后排序
public static List mondayToDates(Date dt){
//创建列表
List dts = new ArrayList();
//创建日历
Calendar ca = Calendar.getInstance();
//设置时间
ca.setTime(dt);
//设置周一为每周的第一天
ca.setFirstDayOfWeek(Calendar.MONDAY);
//将Calendar日期对象指向本周的周一
ca.set(Calendar.DAY_OF_WEEK, Calendar.MONDAY);
for (int i = 0; i < 7; i++, ca.add(Calendar.DATE, 1)) {
//将日历时间调整为0时0分0秒
ca.set(Calendar.HOUR_OF_DAY, 0);
ca.set(Calendar.MINUTE, 0);
ca.set(Calendar.SECOND, 0);
ca.set(Calendar.MILLISECOND, 0);
//将时间添加到list列表
dts.add(ca.getTime());
}
return dts;
}
获取n天后,负数表示几天前
public static Date getDayAfterToday(Date date,int n) {
//创建日历
Calendar ca = Calendar.getInstance();
//设置时间
ca.setTime(date);
//日历时间加n天或者减n天
ca.add(Calendar.DAY_OF_YEAR, n);
//将日历时间调整为0时0分0秒
ca.set(Calendar.HOUR_OF_DAY, 0);
ca.set(Calendar.MINUTE, 0);
ca.set(Calendar.SECOND, 0);
ca.set(Calendar.MILLISECOND, 0);
//返回结果
return ca.getTime();
}
计算两个日期相差的天数
public int daysDiffer(String start, String end) throws Exception{
SimpleDateFormat sdf = new SimpleDateFormat(“yyyy-MM-dd”);
Date startDate = sdf.parse(start);
Date endDate = sdf.parse(end);
Calendar cal = Calendar.getInstance();
cal.setTime(startDate);
long timeStart = cal.getTimeInMillis();
cal.setTime(endDate);
long timeEnd = cal.getTimeInMillis();
long ret = (timeEnd-timeStart)/(1000360024);
return Integer.parseInt(String.valueOf(ret));
}
public int daysDiffer(Date dateStart,Date dateEnd){
Calendar cal = Calendar.getInstance();
cal.setTime(dateStart);
long timeStart = cal.getTimeInMillis();
cal.setTime(dateEnd);
long timeEnd = cal.getTimeInMillis();
long ret = (timeEnd-timeStart)/(1000360024);
return Integer.parseInt(String.valueOf(ret));
}
五、GregorianCalendar类
java中主要有两个日历类,其一抽象类java.util.Calendar,其二java.util.GregorianCalendar类(标准阳历)。Calendar类和GregorianCalendar类是父子关系。GregorianCalendar类继承自Calendar类,是Calendar类的一个实现类,提供了世界上大多数国家/地区的标准日历系统,是Calendar提供的一个实现标准阳历的具体工具。
实例对象
GregorianCalendar类用默认的地区和时区的当前日期和时间初始化对象,提供了如下构造函数。
//初始化默认当前时刻的实例对象
Calendar ca = new GregorianCalendar();
//初始化具有指定日期设置的实例对象
Calendar ca=new GregorianCanlendar(int year,int month,int date);
Calendar ca=new GregorianCanlendar(int year,int month,int date,int hour,int minute);
Calendar ca=new GregorianCanlendar(int year,int month,int date,int hour,int minute,int second);
GregorianCalendar实例对象的用法主要继承自父类Calendar。