日期时间类

Date类

简介

在Java中，Date类用来封装当前的日期和时间。Date类提供两个构造函数来初始化对象，如下所示。

1. 通过Date() 使用当前日期和时间来初始化对象。

2. 通过Date(long millisec) 来初始化对象，其中的参数是从1970年1月1日起的毫秒数。

补充：Date对象内部参数，如下图所示。

注：Date(99, 10, 8)指的是1900+99年10+1月8日！！！

Date类中的部分方法

1. boolean after(Date date) 调用此方法的Date对象在指定日期之后返回true，否则返回false，代码如下式所示。

       public static void main(String[] args) {
           Date date = new Date();
           //date1为指定时间2024.1.10
           Date date1 = new Date(124, 0,10);
           System.out.println(date.after(date1));
       }

   运行结果如下图所示。

   

   注：指定日期也是一个Date类的一个实例对象。

2. boolean before(Date date) 调用此方法的Date对象在指定日期之前返回true,否则返回false，如下式所示。

   public static void main(String[] args) {
           Date date = new Date();
           //date1为指定时间2024.1.10
           Date date1 = new Date(124, 0,10);
           System.out.println(date.before(date1));
       }

   运行结果如下图所示。

   

3. int compareTo(Date date) 比较调用此方法的Date对象和指定日期。两者相等时候返回0。调用对象在指定日期之前则返回负数-1。调用对象在指定日期之后则返回正数1，如下式所示。

   public static void main(String[] args) {
           Date date = new Date();
           //date1为指定时间2024.1.10
           Date date1 = new Date(124, 0,10);
           //在Date()类中已经重写了clone方法。
           Date dateCopy = (Date) date.clone();
           System.out.println(date.toString());
           System.out.println(date1.toString());
           int i = date.compareTo(date1);
           int j = date.compareTo(dateCopy);
           switch (i){
               case 0:
                   System.out.println("两日期相等");
                   break;
               case -1:
                   System.out.println("调用对象在指定日期之前");
                   break;
               case 1:
                   System.out.println("调用对象在指定日期之后");
                   break;
           }

   运行结果如下图所示。

   

   注：int compareTo(Object obj) 方法类似于int compareTo(Date date) 方法，区别仅是传入参数类型不同，若传入obj为Date类型的实例对象，则两种方法完全等同，否则会抛出ClassCastException异常。

4. boolean equals(Object date) 当调用此方法的Date对象和指定日期相等时候返回true，否则返回false，如下式所示。

       public static void main(String[] args) {
           Date date = new Date();
           Date dateCopy = (Date) date.clone();
           System.out.println(date.equals(dateCopy));
       }

   运行结果，如下图所示。

   

5. long getTime( ) 返回自 1970 年 1 月 1 日 00:00:00 GMT 以来此 Date 对象表示的毫秒数，如下式所示。当然，long getTime() 方法也可以用来进行日期比较。

       public static void main(String[] args) {
           Date date = new Date(70,0,2);
           System.out.println(date.toString());
           long time = date.getTime();
           System.out.println(time);
       }

   运行结果，如下图所示。

   

   注：显示的毫秒数为57600000 = 16 * 60* 60 *1000，不是24 * 60 * 60 * 1000。原因为中国地处东八区，需要加上中国的时区 8 。

   补充：GMT指格林尼治时间，以本初子午线为基础。UTC指世界协调时间，以原子钟时长为基础，更准确。CST为时区概念的缩写，eg：China Standard Time 中国标准时区(UTC + 8)。

6. void setTime(long time) 自1970年1月1日00:00:00 GMT以后，使用time毫秒数来设置时间和日期，如下式所示。

       public static void main(String[] args) {
           Date date = new Date();
           date.setTime(57660000);
           System.out.println(date.toString());
       }

   运行效果，如下图所示。

   

7. String toString( ) 把此 Date 对象转换为String形式的字符串，内容包括星期、月份、日期、具体时间(时、分、秒)、所采用的时间概念、年份。如下式所示。

       public static void main(String[] args) {
           Date date = new Date(124, 0, 12);
           System.out.println(date.toString());
       }

   运行结果，如下图所示。

   

SimpleDateFormat

定义和使用

SimpleDateFormat类用来格式化和分析日期，允许用户可以自定义日期时间格式。

如下式所示。

    public static void main(String[] args) {
        //实例化一个Date类对象
        Date date = new Date();
        /*实例化一个SimpleDateFormat类对象
         *在传入参数中，可以设定自定义时间格式
         * 即时间模式字符串("yyyy-MM-dd HH:mm:ss")用于指定时间格式
        */
        SimpleDateFormat ft = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        //使用format(Data)方法来输出自定义时间
        System.out.println("当前时间为："+ft.format(date));
    }

运行结果，如下图所示。

注：格式的大小写代表截然不同的意思，eg：MM为月份，mm为分；HH为24小时制，hh为12小时制。

在使用SimpleDateFormat类时，通过时间模式字符串用来指定时间格式，在此模中，所有的ASCII字母都被保留为模式字母，具体字母定义，如下表所示。

字母	描述	举例描述
G	纪元标记	AD
yyyy	四位年份	2024
MM	两位月份	January or 01
dd	两位日期	12
hh	AM/PM(1~12)(12小时制)	12
HH	24小时制(0~23)	23
mm	分钟数	35
ss	秒数	55
SS	毫秒数	265
E	星期	Friday
D	一年中的第几天	12
F	一个月中第几周的某天第几次出现	2(second Friday.in January )
w	一年中的第几周	36
W	一个月中第几周	1
a	AM/PM标记	上午/下午
k	一天中的第几个小时(1~24)	17
K	AM/PM格式下，一天中的第几个小时(0~11)	5
z	时区	CST
''	单引号	''

注：字母不同的重复数代表不同的位数，eg：d指3，dd指03，ddd指003。

使用printf方法来格式化日期

printf方法可以很轻松的格式化时间和日期，具体使用方法：规格为两个字母的格式，以%t开头，并以一个字母作为结尾。eg：%tF、%tc、%tD等。

注：不同的字母结尾，有不同的转化效果，如下表所示。

格式	解释
%tB	月份全名
%tb	月份缩写
%tA	星期全名
%ta	星期缩写
%tY	四位数年份
%ty	两位数年份
%tm	两位数月份
%td	两位数日期
%te	一位或两位的日期
%tH	24小时制的小时数
%tl	12小时制的小时数
%tM	分钟数
%tS	秒数
%tp	上午或下午
%tZ	时区
%tF	年-月-日格式
%tc	全部日期和时间信息
%tD	月/日/年格式
%tr	时:分:秒(12时制)
%tT	时:分:秒(24时制)
%tR	时:分(24时制)

运行效果，如下图所示。

Calendar类

Calendar类的创建

Calendar类实现了设置和获取日期数据的特定部分，且能对日期进行加减运算。

Calendar类是一个抽象类，只需要使用getInstance方法创建即可。如下式所示。

    public static void main(String[] args) {
        //默认为当前日期
        //调用getInstance方法创建
        Calendar calendar = Calendar.getInstance();
        System.out.println(calendar);
    }

Calendar类中的部分方法

set方法

使用set方法来创建指定日期的Calendar对象：首先创建一个Calendar对象，后再设定该对象中的年月日参数，如下式所示。

    public static void main(String[] args) {
        //默认为当前日期
        Calendar calendar = Calendar.getInstance();
        calendar.set(2024,0,12);
        System.out.printf("%tF",calendar);
    }
使用set方法还可以用来设置某个字段，如下式所示。

    public static void main(String[] args) {
        Calendar calendar = Calendar.getInstance();
        //设置字段YEAR
        calendar.set(Calendar.YEAR,2023);
        int year = calendar.get(Calendar.YEAR);
        System.out.println(year);
    }

注：其他字段的更改以此类推。

常量和get方法

Calendar类中的常量，不同常量代表不同意义，如下表所示。

常量	描述
Calendar.YEAR	年份
Calendar.MONTH	月份
Calendar.DATE	日期
Calendar.DAY_OF_MONTH	日期
Calendar.HOUR	12小时制的小时
Calendar.HOUR_OF_DAY	24小时制的小时
Calendar.MINUTE	分钟
Calendar.SECOND	秒
Calendar.DAY_OF_WEEK	星期几

可以通过常量和get方法来获得年份、月份等日期数据的特定部分，如下式所示。

public static void main(String[] args) {
        //默认为当前日期
        Calendar calendar = Calendar.getInstance();
        int year = calendar.get(Calendar.YEAR);//获得年份
        int month = calendar.get(Calendar.MONTH);//获得月份
        int date = calendar.get(Calendar.DATE);//获得日
        int hour = calendar.get(Calendar.HOUR_OF_DAY);//获得小时(24进制)
        int minute = calendar.get(Calendar.MINUTE);//获得分钟
        int second = calendar.get(Calendar.SECOND);//获得秒
        //星期获取返回值为1代表星期日、2代表星期1，以此类推
        int day = calendar.get(Calendar.DAY_OF_WEEK);//获得星期

注：星期获取返回值为1代表星期日、2代表星期1，以此类推！！！

add方法

Calendar类中的add方法，通过add方法可以实现加上减去某个数，如下式所示。

    public static void main(String[] args) {
        Calendar calendar = Calendar.getInstance();
        Calendar calendar1 = Calendar.getInstance();
        System.out.printf("当前日期为："+"%tF%n",calendar);
        //把calendar对象的日期加上10，更改后表示为10天后的日期
        calendar.add(Calendar.DATE, 10);
        System.out.println("更改后的日期为："+calendar.get(Calendar.DATE)+"号");
        //把calendar1对象的日期减去10，更改后表示为10天前的日期
        calendar1.add(Calendar.DATE, -10);
        System.out.println("更改后的日期为："+calendar1.get(Calendar.DATE)+"号");
    }

运行效果，如下图所示。

注：加减日期数，其它所有的数值会被重新计算！！！

GregorianCalendar类

GregorianCalendar类即阳历(公历)类，继承了Calendar类，为Calendar类的一个子类，具有父类的方法。

创建方法如下：

GregorianCalendar gcalendar = new GregorianCalendar();

使用GregorianCalendar类输出当前日期，代码如下所示。

 public static void main(String[] args) {
        // 初始化 Gregorian 日历
        // 使用当前时间和日期
        // 默认为本地时间和时区
        GregorianCalendar gregorianCalendar = new GregorianCalendar();
        String months[] = {
                "Jan", "Feb", "Mar", "Apr",
                "May", "Jun", "Jul", "Aug",
                "Sep", "Oct", "Nov", "Dec"};
​
            // 显示当前时间和日期的信息
            System.out.print("日期: ");
            System.out.print(gregorianCalendar.get(Calendar.YEAR) + "年");
            System.out.print(months[gregorianCalendar.get(Calendar.MONTH)] + "月");
            System.out.println(gregorianCalendar.get(Calendar.DATE) + "日");
            System.out.print("时间: ");
            System.out.print(gregorianCalendar.get(Calendar.HOUR) + ":");
            System.out.print(gregorianCalendar.get(Calendar.MINUTE) + ":");
            System.out.println(gregorianCalendar.get(Calendar.SECOND));
            // 测试当前年份是否为闰年
            int year = gregorianCalendar.get(Calendar.YEAR);
            if(gregorianCalendar.isLeapYear(year)) {
                System.out.println("当前年份是闰年");
            }
            else {
                System.out.println("当前年份不是闰年");
            }
        }

运行结果，如下图所示。

注：Calendar的月份是从0开始的，而日期和年份是从1开始的！！！