java.util.calendar类详解

一、概述

二、静态常量

三、实例

四、静态方法

五、GregorianCalendar类
一、概述
java.util.Calendar类是一个抽象类,是java日期处理的核心类之一。Calendar类为操作日历字段,及其与特定瞬间之间的转换提供了方法。日历字段包含YEAR、MONTH、DAY_OF_MONTH、HOUR等,它们都是Calendar类的静态常量。

二、静态常量

//指示年
Calendar.YEAR            // 1
 
//指示月份
Calendar.MONTH           // 2
 
//指示当前时间为多少号(日历式的多少号)
Calendar.DATE            // 5
 
//指示小时(12小时制)
Calendar.HOUR            // 10
 
//指示小时(24小时制)
Calendar.HOUR_OF_DAY     // 11
 
//指示分钟数
Calendar.MINUTE          // 12
 
//指示秒数
Calendar.SECOND          // 13
 
//指示毫秒
Calendar.MILLISECOND     // 14
//当前时间是所在当前月的第几个星期(日历式的第几周)
Calendar.WEEK_OF_MONTH //4
 
//当前时间是所在当前年的第几个星期
Calendar.WEEK_OF_YEAR  //3
 
//当前时间是所在当前月的第几个星期,以月份天数为标准,一个月的1号为第一周,8号为第二周
Calendar.DAY_OF_WEEK_IN_MONTH //8
//一周7天当中,当前时间是星期几
Calendar.DAY_OF_WEEK          //7
 
//指示一年中的第几天
Calendar.DAY_OF_YEAR          //6
 
//指示一月中的第几天,结果等同于Calendar.DATE
Calendar.DAY_OF_MONTH         //5
//指示上午还是下午
Calendar.AM_PM    //9
//周天
Calendar.SUNDAY     //1
//周一
Calendar.MONDAY     //2
//周二
Calendar.TUESDAY    //3
//周三
Calendar.WEDNESDAY  //4
//周四
Calendar.THURSDAY   //5
//周五
Calendar.FRIDAY     //6
//周六
Calendar.SATURDAY   //7

三、实例方法

get方法

返回指定日历字段的值。
语法
get(int field)
实例

//获得年、月、日、时、分、秒、毫秒
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方法

设置日历字段的值。
语法



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-110表示一月,以此类推。日期的正常值范围为1-31,结尾数字视月份而定。

//2019-01-01 00:00:00
Calendar ca = Calendar.getInstance();
ca.set(Calendar.YEAR,2019);
ca.set(Calendar.MONTH,0); 
ca.set(Calendar.DATE,1);
ca.set(Calendar.HOUR_OF_DAY,0);
ca.set(Calendar.MINUTE,0);
ca.set(Calendar.SECOND,0);
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
System.out.println(sdf.format(ca.getTime()));
所有日历字段都有正常的值范围,但是它们也支持不正常的值范围,以正常值范围为基点,设置向前向后的值都可以。例如所有日历字段都可以设置负值(年份不考虑)。

设置:201900--> 实际:201901月
设置:2019-1--> 实际:201812, 以此类推
 
设置:200--> 实际:131日
设置:2-1--> 实际:130, 以此类推
 
设置:1小时-1分钟  --> 实际:0小时59分钟
 
设置:1分钟-1秒钟  --> 实际:0分钟59//2018-12-31
ca.set(Calendar.YEAR,2019);
ca.set(Calendar.MONTH,0); 
ca.set(Calendar.DATE,0); //设置为0天,指向上月的最后一天
//2018-12-30
ca.set(Calendar.YEAR,2019);
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);//第二个参数的取值范围是表示周一到周天的七个静态常量

add方法

基于日历的规则实现日期加减。
语法
add(int field, int amount);
为当前Calendar日期对象加上或减去指定的时间量。参数amount表示日期的增量,可以为负值。
实例方法


Calendar ca = Calendar.getInstance();
ca.set(Calendar.YEAR,2019);
 
//当前日历年份加一
ca.add(Calendar.YEAR,1);
System.out.println(ca.get(Calendar.YEAR)); //2020
 
//当前日历年份减一
ca.add(Calendar.YEAR,-1);
System.out.println(ca.get(Calendar.YEAR)); //2019
Calendar ca = Calendar.getInstance();
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);
 
//当前日历日期加一
ca.add(Calendar.DAY_OF_MONTH,1);
System.out.println(ca.get(Calendar.DAY_OF_MONTH)); //11
 
//当前日历日期减一
ca.add(Calendar.DAY_OF_MONTH,-1);
System.out.println(ca.get(Calendar.DAY_OF_MONTH)); //10
Calendar ca = Calendar.getInstance();
System.out.println(ca.get(Calendar.DAY_OF_WEEK)); //5
 
ca.add(Calendar.DAY_OF_WEEK,1);
System.out.println(ca.get(Calendar.DAY_OF_WEEK)); //6

after方法

 判断Calendar日期对象表示的时间是否在另一个日期对象表示的时间之后,返回truefalse。例如2020年在2019年之后。

Calendar cal = Calendar.getInstance();
Calendar future = Calendar.getInstance();
future.set(Calendar.YEAR, 2020);
System.out.println(future.after(cal)); //true

before方法

判断Calendar日期对象表示的时间是否在另一个日期对象表示的时间之前,返回truefalse。例如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 Aug 05 16:58:10 CST 2019
cal.clear();
System.out.println(cal.getTime()); //Thu Jan 01 00:00:00 CST 1970

clone方法


创建并返回一个Calendar日期对象的副本,返回结果为Object类型。副本和原日期对象互不影响。

Calendar cal = Calendar.getInstance();
cal.clear();
Calendar clone = (Calendar)cal.clone();
cal.set(2020,1,1);
System.out.println(cal.getTime());   //Sat Feb 01 00:00:00 CST 2020
System.out.println(clone.getTime()); //Thu Jan 01 00:00:00 CST 1970

compareTo方法


比较当前Calendar日期对象与另一个Calendar日期对象表示的时间值大小(毫秒偏移量),返回结果为01-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日期对象比较,返回truefalse。

Calendar cal = Calendar.getInstance();
Calendar cal2 = new GregorianCalendar(2011, 04, 29);
System.out.println(cal.equals(cal2)); //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());

四、静态方法

将日历时间调整到0000毫秒

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<Date> monthToDates(Date dt){
    //创建list列表
    List<Date> dts = new ArrayList<Date>();
    //创建日历
    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<Date> mondayToDates(Date dt){
    //创建列表
    List<Date> dts = new ArrayList<Date>();
    //创建日历
    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)/(1000*3600*24);
    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)/(1000*3600*24);
    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。

//默认当前时间
//Thu Sep 05 15:23:06 CST 2019
Calendar ca = new GregorianCalendar();
System.out.println(ca.getTime());
//Fri Feb 01 00:00:00 CST 2019
Calendar ca = new GregorianCalendar(2019,1,1);
System.out.println(ca.getTime()); 
//Fri Feb 01 01:01:00 CST 2019
Calendar ca = new GregorianCalendar(2019,1,1,1,1);
System.out.println(ca.getTime());

文章是转载此处学习描述

  • 2
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值