java的日历类(Calendar)详解

老实说对于时间的处理我大部分都在用Calendar日历类解决,现在整理一下,方便以后开发查阅

java.util

类 Calendar

java.lang.Object
继承者 java.util.Calendar

所有已实现的接口:
Serializable, Cloneable, Comparable<Calendar>

直接已知子类:
GregorianCalendar

public abstract class Calendar
extends Object
implements Serializable, Cloneable, Comparable<Calendar>


1. Calendar类

首先先创建一个Calendar实例:Calendar instance Calendar.getInstance();,其中返回的具体类类型就是Calendar的子类GregorianCalendar的对象,所以使用时也可以直接new GregorianCalendar()
在下文的演示当中都会用instance作为Calendar的一个实例.

Calendar类的成员变量:

这里以下所说的get,set方法指的是instance的get,set方法

static int  ALL_STYLES
          指示所有风格名称的 getDisplayNames 的风格说明符,比如 "January" 和 "Jan"。
static int  AM 
          指示从午夜到中午之前这段时间的 AM_PM 字段值。
static int  AM_PM 
          get 和 set 的字段数字,指示 HOUR 是在中午之前还是在中午之后。
static int  APRIL 
          指示在格里高利历和罗马儒略历中一年中第四个月的 MONTH 字段值。
protected  boolean  areFieldsSet 
          如果 fields[] 与当前的设置时间同步,则返回 true。
static int  AUGUST 
          指示在格里高利历和罗马儒略历中一年中第八个月的 MONTH 字段值。
static int  DATE 
          get 和 set 的字段数字,指示一个月中的某天。
static int  DAY_OF_MONTH 
          get 和 set 的字段数字,指示一个月中的某天。
static int  DAY_OF_WEEK 
          get 和 set 的字段数字,指示一个星期中的某天。
static int  DAY_OF_WEEK_IN_MONTH 
          get 和 set 的字段数字,指示当前月中的第几个星期。
static int  DAY_OF_YEAR 
          get 和 set 的字段数字,指示当前年中的天数。
static int  DECEMBER 
          指示在格里高利历和罗马儒略历中一年中第十二个月的 MONTH 字段值。
static int  DST_OFFSET 
          get 和 set 的字段数字,以毫秒为单位指示夏令时的偏移量。
static int  ERA 
          指示年代的 get 和 set 的字段数字,比如罗马儒略历中的 AD 或 BC。
static int  FEBRUARY 
          指示在格里高利历和罗马儒略历中一年中第二个月的 MONTH 字段值。
static int  FIELD_COUNT 
          get 和 set 可识别的不同字段的数量。
protected  int[]    fields 
          此日历当前设置时间的日历字段值。
static int  FRIDAY 
          指示 Friday 的 DAY_OF_WEEK 字段值。
static int  HOUR 
          get 和 set 的字段数字,指示上午或下午的小时。
static int  HOUR_OF_DAY 
          get 和 set 的字段数字,指示一天中的小时。
protected  boolean[]    isSet 
          通知是否设置了该日历某一指定日历字段的标志。
protected  boolean  isTimeSet 
          如果 time 值是一个有效值,则返回 true。
static int  JANUARY 
          指示在格里高利历和罗马儒略历中一年中第一个月的 MONTH 字段值。
static int  JULY 
          指示在格里高利历和罗马儒略历中一年中第七个月的 MONTH 字段值。
static int  JUNE 
          指示在格里高利历和罗马儒略历中一年中第六个月的 MONTH 字段值。
static int  LONG 
          指示长名称的 getDisplayName 和 getDisplayNames 的风格说明符,比如 "January"。
static int  MARCH 
          指示在格里高利历和罗马儒略历中一年中第三个月的 MONTH 字段值。
static int  MAY 
          指示在格里高利历和罗马儒略历中一年中第五个月的 MONTH 字段值。
static int  MILLISECOND 
          get 和 set 的字段数字,指示一秒中的毫秒。
static int  MINUTE 
          get 和 set 的字段数字,指示一小时中的分钟。
static int  MONDAY 
          指示 Monday 的 DAY_OF_WEEK 字段值。
static int  MONTH 
          指示月份的 get 和 set 的字段数字。"这里有非常需要注意的一点,这里显示的月份是由0开始的"
static int  NOVEMBER 
          指示在格里高利历和罗马儒略历中一年中第十一个月的 MONTH 字段值。
static int  OCTOBER 
          指示在格里高利历和罗马儒略历中一年中第十个月的 MONTH 字段值。
static int  PM 
          指示从中午到午夜之前这段时间的 AM_PM 字段值。
static int  SATURDAY 
          指示 Saturday 的 DAY_OF_WEEK 字段值。
static int  SECOND 
          get 和 set 的字段数字,指示一分钟中的秒。
static int  SEPTEMBER 
          指示在格里高利历和罗马儒略历中一年中第九个月的 MONTH 字段值。
static int  SHORT 
          指示短名称的 getDisplayName 和 getDisplayNames 的风格说明符,比如 "Jan"。
static int  SUNDAY 
          指示 Sunday 的 DAY_OF_WEEK 字段值。
static int  THURSDAY 
          指示 Thursday 的 DAY_OF_WEEK 字段值。
protected  long time 
          日历的当前设置时间,以毫秒为单位,表示自格林威治标准时间 1970 年 1月 1 日 0:00:00 后经过的时间。
static int  TUESDAY 
          指示 Tuesday 的 DAY_OF_WEEK 字段值。
static int  UNDECIMBER 
          指示一年中第十三个月的 MONTH 字段值。
static int  WEDNESDAY 
          指示 Wednesday 的 DAY_OF_WEEK 字段值。
static int  WEEK_OF_MONTH 
          get 和 set 的字段数字,指示当前月中的星期数。
static int  WEEK_OF_YEAR 
          get 和 set 的字段数字,指示当前年中的星期数。
static int  YEAR 
          指示年的 get 和 set 的字段数字。
static int  ZONE_OFFSET 
          get 和 set 的字段数字,以毫秒为单位指示距 GMT 的大致偏移量。

** 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 对象表示的时间值(从历元至现在的毫秒偏移量)。"此函数返回值为三个,分别为-1,0,1;-1指的是当前Calendar比anotherCalendar的时间早,0指的是时间相同,1指的是比anotherCalendar时间晚"
 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() 
          返回该此日历的哈希码。
 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() 
          返回此日历的字符串表示形式。

1.1我们先来讲解一下Calendar成员变量当中,用与get,set的变量的具体含义,因为这些变量经常会被使用(暂时先介绍我经常会用到的吧,是按本人理解的解释):

1.1.1 YEAR
这个字段的含义是年份,假如说现在是2017-1-1,那么执行:
System.out.println(instance.get(Calendar.YEAR));
打印出来的值就为2017

1.1.2 MONTH
这个字段的含义是月份,假如说现在是2017-9-1,那么执行:
System.out.println(instance.get(Calendar.MONTH));
打印出来的值就为8,值得注意的是在Calendar当中MONTH的开始月份为0

1.1.3 WEEK_OF_YEAR
指的是当前年的总周数当中,当前日期属于第几周

System.out.println("WEEK_OF_YEAR:"+instance.get(Calendar.WEEK_OF_YEAR));
System.out.println("一年有"+instance.getActualMaximum(Calendar.WEEK_OF_YEAR)+"个周");

打印出的结果为:

WEEK_OF_YEAR:12
一年有52个周

1.1.4 DATE
当前时间为多少号,例如今天为2017-3-20,那么:
System.out.println(instance.get(Calendar.DATE));
打印的值为:
20

1.1.5 DAY_OF_MONTH
这个月的总天数当中当前过了多少天(其实它的值和上面的DATE的值是一样的)

System.out.println("DAY_OF_MONTH:"+instance.get(Calendar.DAY_OF_MONTH));
System.out.println("当前月有"+instance.getActualMaximum(Calendar.DAY_OF_MONTH)+"天");

打印的结果为:

DAY_OF_MONTH:20

当前月有31天

1.1.6 DAY_OF_YEAR
当年的所有天数当中,当天过了多少天

System.out.println("DAY_OF_YEAR:"+instance.get(Calendar.DAY_OF_YEAR));
System.out.println("当前年份有"+instance.getActualMaximum(Calendar.DAY_OF_YEAR)+"天");

打印的结果为:

DAY_OF_YEAR:79

当前年份有365天

1.1.7 DAY_OF_WEEK
一周7天当中,当前时间是星期几(1-7),值得注意的是一周的开始是星期日,结束是星期六,
如果今天是星期一,那么instance.get(Calendar.DAY_OF_WEEK)的值就应该是2

1.1.8 DAY_OF_WEEK_IN_MONTH
指的是当前时间是所在当前月的第几个星期,一个月的1号为第一周,8号为第二周

1.1.9 WEEK_OF_MONTH
同样是按当前时间在当前月的星期数,可是它的值不同于1.1.8的DAY_OF_WEEK_IN_MONTH,它计算当前星期的标准不同,例如说这个月的1号是星期3,那么是第一周,那么到了5号星期日就已经是第二周了,如果按8的DAY_OF_WEEK_IN_MONTH的计算5号才第一周


System.out.println("WEEK_OF_MONTH:"+instance.get(Calendar.WEEK_OF_MONTH));

System.out.println("当前月有"+instance.getActualMaximum(Calendar.WEEK_OF_MONTH)+"个周");

打印出来的结果为:

WEEK_OF_MONTH:4

当前月有5个周

计算出来是4.4个周,它显示的为5个周

1.2.0 AM_PM
用于判断当前时间是AM,还是PM,若是AM值为0,若是PM为1.

1.2.1 HOUR
显示当前时间的12小时制

1.2.2 HOUR_OF_DAY
显示当前时间的24小时制

1.2.3 MINUTE
显示当前时间的分钟数
1.2.4 SECOND
显示当前时间的秒数
1.2.5 MILLISECOND
显示当前时间的毫秒数


1.2 还有几个不用与get,set方法得值的成员变量(直接使用):

1.2.0 星期数成员变量SUNDAY-SATURDAY的值为1-7
1.2.1 月份成员变量JANUARY-DECEMBER(0-12)

2. GregorianCalendar类

GregorianCalendar类除了有其父类的各种丰富的属性和方法之外,还有一些很好用的方法

其构造方法:

GregorianCalendar() 
          Constructs a new GregorianCalendar initialized to the current date and time with the default Locale and TimeZone.
GregorianCalendar(int year, int month, int day) 
          Constructs a new GregorianCalendar initialized to midnight in the default TimeZone and Locale on the specified date.
GregorianCalendar(int year, int month, int day, int hour, int minute) 
          Constructs a new GregorianCalendar initialized to the specified date and time in the default TimeZone and Locale.
GregorianCalendar(int year, int month, int day, int hour, int minute, int second) 
          Constructs a new GregorianCalendar initialized to the specified date and time in the default TimeZone and Locale.
GregorianCalendar(Locale locale) 
          Constructs a new GregorianCalendar initialized to the current date and time and using the specified Locale and the default TimeZone.
GregorianCalendar(TimeZone timezone) 
          Constructs a new GregorianCalendar initialized to the current date and time and using the specified TimeZone and the default Locale.
GregorianCalendar(TimeZone timezone, Locale locale) 
          Constructs a new GregorianCalendar initialized to the current date and time and using the specified TimeZone and Locale.

其实在其父类Calendar都有这样的功能

其中方法很有用:
boolean isLeapYear(int year)
判断年份是否闰年


3. 时间处理的简单使用

分别获取日期的各个属性

        Calendar instance = Calendar.getInstance();
        System.out.println(instance.get(Calendar.YEAR)+"年");
        System.out.println((instance.get(Calendar.MONTH)+1)+"月");
        System.out.println(instance.get(Calendar.DATE)+"日");
        System.out.println(instance.get(Calendar.HOUR_OF_DAY)+"时"); //24小时制
        
        switch (instance.get(Calendar.AM_PM)) {
        case Calendar.AM:
            System.out.println("上午");
            break;
        case Calendar.PM:
            System.out.println("下午");
            break;
        }
        
        System.out.println(instance.get(Calendar.MINUTE)+"分");
        System.out.println(instance.get(Calendar.SECOND)+"秒");
        System.out.println(instance.get(Calendar.MILLISECOND)+"毫秒");

打印出:

2017年

3月

21日

10时

上午

7分

35秒

951毫秒

再演示:

        Calendar instance = Calendar.getInstance();
        long currentTime = instance.getTimeInMillis();//获取当前时间戳
        
        instance.add(Calendar.DAY_OF_YEAR, 1); //把当前时间改为明天的同一时刻
        long tomorrowTime = instance.getTimeInMillis();
        
        System.out.println("今天和明天相隔"+(tomorrowTime-currentTime)/(1000*60*60*24)+"天");
今天和明天相隔1天

有时候要注意把时间的时分秒毫秒都设为0,就例如从mysql数据库中取出一个date类型的日期(yyyy-MM-dd)其日期时分秒毫秒都为0,如运算时要一致:

当我们要用当前的系统时间和数据库中的date比较日期的时候,如果比较的是某日期比当前日期前或者后的话,可以用after或者before方法,返回的为boolean类型,但是如果要比较这两个日期是否相等的话,就需要注意要把当前系统时间的小时,分钟,秒,毫秒,都设置为0,才可以比较成功,或者用compareTo方法,此方法返回int类型,返回值分别为-1,1,0,分别为比某日期前,后,相等.

instance.set(Calendar.HOUR_OF_DAY, 0);
instance.set(Calendar.MINUTE, 0);
instance.set(Calendar.SECOND, 0);
instance.set(Calendar.MILLISECOND, 0);
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,117评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,328评论 1 293
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,839评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,007评论 0 206
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,384评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,629评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,880评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,593评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,313评论 1 243
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,575评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,066评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,392评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,052评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,082评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,844评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,662评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,575评论 2 270

推荐阅读更多精彩内容