Java基础--常用API--日期相关API

回到顶部

一、java.util.Date

　　1、只用于显示系统时间，其大部分操作由Calendar代替。
　　　　格林威治时间（GMT）：指的是1970年1月1日0时，不同地区有时间差。
　　　　默认输出格式：星期、月、日、时、分、秒、时区、年

　　2、构造方法：
　　　　（1）public Date(); //无参构造创建的对象可以获取本机的当前日期与时间。

　　　　（2）public Date(long date) ; //根据自定义时间创建Date对象。date若为正数，则表示公元后，若为负数，则表示公元前。

　　3、常用方法：
　　　　（1）public long getTime(); //可以获取从1970年开始到现在时间的毫秒数。

　　　　（2）public void setTime(long time); //可以自定义date时间。

import java.util.Date;

public class Demo {
    public static void main(String[] args) {
        Date date = new Date();// 实例化一个Date类，用于获取当前系统时间
        System.out.println(date);// 输出时间，Thu May 23 14:10:49 JST 2019

        System.out.println(date.getTime());// 输出毫秒值，1558588249722

        date.setTime(date.getTime() + 1000);// 手动增加1000毫秒
        System.out.println(date.getTime());// 输出毫秒值，1558588250722
    }
}

回到顶部

二、java.text.SimpleDateFormat　

　　1、java1.5版本前，使用该类作用是将字符串（String）与时间（Date）相互转换。

　　2、构造方法：
　　　　（1）public SimpleDateFormat(); //按照系统默认格式将Date转换为String。

　　　　（2）public SimpleDateFormat(String pattern); //按照自定义格式pattern转换。

　　3、常用方法：
　　　　（1）public final String format(Date date); //可以将Date转为String。

　　　　（2）public Date parse(String source) throws ParseException; //可以将String转为Date，使用时需要抛出异常（ParseException）。

　　4、格式规则：

　　　　y--年　　 M--月　　 d--日 　　 E--星期　　h--12进制小时 　　 H--24进制小时 　　 m--分 　　 s--秒

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;

public class Demo {
    public static void main(String[] args) {
        Date date = new Date();// 实例化一个Date类，用于获取当前系统时间
        System.out.println(date);// 输出时间，Thu May 23 14:36:10 JST 2019

        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd E HH-mm-ss");
        String str = sdf.format(date);// 按照指定格式转为字符串
        System.out.println(str);// 输出转换后的时间，2019-05-23 星期四 14-36-10
        try {
            // 将字符串转为Date，Thu May 23 14:36:10 JST 2019
            System.out.println(sdf.parse(str));
        } catch (ParseException e) {
            System.out.println("格式转换异常。");
        }
    }
}

回到顶部

三、java.util.Formatter

　　1、java1.5版本前后，使用Formatter转换格式。

　　2、使用String类的format()方法时，默认调用Formatter的format()方法。

　　3、public Formatter format(String format, Object ... args) ; //对参数进行格式化。

　　4、使用 %tx 表示格式， 其中 x 表示日期转换符。若格式化同一日期，则需在格式化模式中增加<,例如%tY%<tm，此时只需写一个new Date()。否则需要对每个格式写一个new Date()或Calendar对象。

　　5、格式规则：
　　　　%tc 输出格式： 星期 月 日 时：分：秒 时区 年
　　　　%tF 输出格式：年-月-日
　　　　%tD 输出格式：月/日/年
　　　　%tr 输出格式：时：分：秒 （12小时制）
　　　　%tT 输出格式：时：分：秒（24小时制）
　　　　%tR 输出格式：时：分（24小时制）

import java.util.Date;
import java.util.Formatter;

public class Demo {
    public static void main(String[] args) {
        Date date = new Date();// 实例化一个Date类，用于获取当前系统时间
        System.out.println(date);// 输出时间，Thu May 23 15:10:46 JST 2019

        Formatter fomat = new Formatter();
        Formatter strDemo1 = fomat.format("%tY年%<tm月%<td日", date);
        System.out.println(strDemo1);// 输出，2019年05月23日，使用<时，只需写一个date。

        String strDemo2 = String.format("%tY年%tm月%td日", date, date, date);
        System.out.println(strDemo2);// 输出，2019年05月23日

        String strDemo3 = String.format("%tc", date);//默认调用Formatter的format方法
        System.out.println(strDemo3);// 输出，星期四 五月 23 15:10:46 JST 2019
    }
}

回到顶部

四、java.util.Calendar

　　1、Calendar类是一个抽象类，不能被实例化，可以通过静态方法getInstance()初始化一个日历对象。默认为当前系统时间。该类用于封装日历信息，并对时间分量（年、月、日、时、分、秒）进行计算。

　　2、常用方法：
　　　　（1）public final Date getTime(); //将Calendar转为Date型。

　　　　（2）public final void setTime(Date date); //将Date型转为Calendar。

　　　　（3）public int get(int field); //用于获取时间分量。其中field使用Calendar类的静态变量表示。
　　　　　　注意：
　　　　　　　　Calendar.Month 从0开始计数，即0表示1月，11表示12月。
　　　　　　　　Calendar.DAY_OF_WEEK 从1开始计数，即1表示星期天，7表示星期六。

 　　　　（4）public void set(int field, int value); //设置时间分量，value指要设置的值。

　　　　（5）public final void set(int year, int month, int date); //设置年月日。

　　　　（6）public int getActualMaximum(int field); //获取时间分量field的最大值。

　　　　（7）abstract public void add(int field, int amount); //加时间分量，若加天数时，field需使用Calendar.DAY_OF_YEAR

import java.util.Calendar;
import java.util.Date;

public class Demo {
    public static void main(String[] args) {
        Date date = new Date();// 获取系统时间
        System.out.println(date);// 输出系统时间，Thu May 23 15:46:00 JST 2019

        date.setTime(date.getTime() + 1000 * 60);// 设置时间

        Calendar calendar = Calendar.getInstance();// 获取日历类
        calendar.setTime(date);// 将Date转为Calendar
        System.out.println(calendar.getTime()); // 将Calendar转为Date，Thu May 23 15:47:00 JST 2019

       System.out.println(calendar.get(Calendar.MONTH)); // 获取月份，输出4，4表示5月
        System.out.println(calendar.get(Calendar.DAY_OF_WEEK));// 获取星期几，输出5，5表示星期四

        calendar.set(Calendar.DAY_OF_WEEK, 6);// 设置星期为星期5
        System.out.println(calendar.get(Calendar.DAY_OF_WEEK));// 输出星期几，输出6，表示星期五。

        System.out.println(calendar.getActualMaximum(Calendar.DAY_OF_MONTH));// 获取这个月最大的天数，输出31

        calendar.add(Calendar.DAY_OF_WEEK, 2);// 给星期加2天
        System.out.println(calendar.get(Calendar.DAY_OF_WEEK));// 输出1，表示星期天。
     }
}

回到顶部

五、获取时间戳的方法、快慢

　　1、public static native long currentTimeMillis(); //java.lang.System类，获取时间戳

　　2、public long getTime(); //java.util.Date类，可以获取从1970年开始到现在时间的毫秒数。

　　3、public long getTimeInMillis(); //java.util.Calendar类，获取时间戳。

　　4、currentTimeMillis获取时间戳的速度最快。 

回到顶部

六、Java 8新特性

　　1、上述讲解了几个相关日期类，处理日期比较麻烦，且线程不安全。

　　　　举个例子：（使用上述几个类操作日期）

输入一个日期（String），输出3年、3月、3星期后的星期三的日期（String） 。
分析：
1、先将String转为Date；
2、再将Date转为Calendar；
3、通过Calendar的方法计算时间分量；
4、计算完后将Calendar转为Date；
5、最后再将Date转为String。

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Calendar;
import java.util.Date;
import java.util.Scanner;

public class Demo {
    public static void main(String[] args) {
        Scanner scanner = new Scanner(System.in);
        System.out.println("请输入日期：格式为yyyy-MM-dd :");
        String str = scanner.nextLine(); // 获取输入的字符串

        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
        try {
            Date date = sdf.parse(str);// 将字符串转为Date
            System.out.println(date);

            Calendar calendar = Calendar.getInstance();
            calendar.setTime(date);// 将Date转为Calendar

            calendar.add(Calendar.YEAR, 3);// 给日期加三年
            calendar.add(Calendar.MONTH, 3);// 给日期加三月
            calendar.add(Calendar.WEEK_OF_YEAR, 3);// 给日期加三个星期
            calendar.set(Calendar.DAY_OF_WEEK, 4);// 设置日期为星期三

            date = calendar.getTime();// 将Calendar转为Date
            System.out.println(date);

            str = sdf.format(date);// 将Date转为String
            System.out.println(str);
        } catch (ParseException e) {
            System.out.println("输入格式错误！");
        }
    }
}

/*
测试结果：
请输入日期：格式为yyyy-MM-dd :
2019-5-23
Thu May 23 00:00:00 JST 2019
Wed Sep 14 00:00:00 JST 2022
2022-09-14
*/

　　2、java.time包是在JDK 8 之后引入的，提供了用于日期、时间、周期等的API。其所有类均为不可变的，线程安全的。

　　3、常用类：

　　　　（1）java.time.LocalDateTime：存储了时间与日期，格式为：年-月-日T时：分：秒.毫秒。比如：2019-05-23T12:51:36.494，可以使用withNano(0)将毫秒值设为0。　

　　　　（2）java.time.LocalDate：存储了日期，格式为：年-月-日。比如：2019-05-23。

　　　　（3）java.time.LocalTime：存储了时间，格式为：时：分：秒.毫秒。比如：12:53:44.954。可以使用withNano(0)将毫秒值设为0。

　　　　（4）java.time.format.DateTimeFormatter；类似于java.text.SimpleDateFormat。但其只用来创建日期的显示模板，parse()（是一种静态方法）与format()方法需要使用LocalDateTime类来调用。

　　　　（5）java.time.Duration; 此类用来计算两同类型日期的时间差。

import java.sql.Time;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.util.Date;

public class Test {
    public static void main(String args[]) {
        // java.time.LocalDateTime,格式为：年-月-日T时：分：秒.毫秒
        LocalDateTime ldt = LocalDateTime.now();
        System.out.println(ldt);// 输出2019-05-23T12:51:36.494
        System.out.println(ldt.withNano(0));// 将毫秒设为0，输出为2019-05-23T12:55:13

        // java.time.LocalDate，格式为：年-月-日
        LocalDate ld = LocalDate.now();
        System.out.println(ld);// 输出2019-05-23

        // java.time.LocalTime，格式为：时：分：秒.毫秒
        LocalTime lt = LocalTime.now();
        System.out.println(lt);// 输出为12:53:44.954
    }
}

　　4、注意：
　　　　（1）java.time中，星期一的值为1，星期天的值为7.且月份从 1~12。

　　　　（2）java.util.Calendar中，星期天为1，星期六为7，且月份从 0~11。

　　　　（3）对于time相关类，属于不可变类，原理类似String（参考String值变化的情况）。若其值改变，会重新创建一个实例。

回到顶部

七、java.time.LocalDateTime　　　　

　　1、常用方法：
　　　　（1）public static LocalDateTime now(); //静态方法，获取当前系统时间。

　　　　（2）public static LocalDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second) ; //静态方法，自定义时间

　　　　（3）public int getYear(); //获取年

　　　　（4）public LocalDateTime plusYears(long years); //增加年，会返回一个新的实例，若参数为负，也会出现减的效果。，

　　　　（5）public LocalDateTime minusMonths(long months); //减月，会返回一个新的实例，若参数为负，会出现加的效果。

　　　　（6）public LocalDateTime withDayOfMonth(int dayOfMonth); //修改日，会返回一个新的实例。

import java.time.LocalDate;
import java.time.LocalDateTime;

public class Demo {
    public static void main(String[] args) {
        LocalDateTime ldt = LocalDateTime.now(); // 获取当前系统时间
        System.out.println("当前时间为： " + ldt);
        System.out.println("当前年： " + ldt.getYear());
        System.out.println("当前月： " + ldt.getMonthValue());
        System.out.println("当前月中的日：  " + ldt.getDayOfMonth());
        System.out.println("当前星期： " + ldt.getDayOfWeek());
        System.out.println("当前年中的日： " + ldt.getDayOfYear());
        System.out.println("当前时：（24小时制） " + ldt.getHour());
        System.out.println("当前分： " + ldt.getMinute());
        System.out.println("当前秒： " + ldt.getSecond());
        System.out.println("当前毫秒： （末尾加6个0）" + ldt.getNano());
        System.out.println();

        LocalDateTime time = LocalDateTime.of(2019, 05, 23, 11, 24, 21);
        System.out.println("自定义时间为： " + time);

        LocalDateTime newTime = time.plusYears(1);
        System.out.println("给时间增加一年： " + newTime);

        LocalDateTime lastTime = time.minusMonths(2);
        System.out.println("给月份减二月： " + lastTime);

        LocalDateTime changeTime = time.withDayOfMonth(13);
        System.out.println("只修改日： " + changeTime);

        LocalDate ld = LocalDate.now();//此处不是LocalDateTime
        String flag = (ld.isLeapYear() == true) ? "是" : "不是";
        System.out.println("判断是否为闰年： " + ld.getYear() + flag + "闰年");
    }
}
/*
测试结果：
当前时间为： 2019-05-23T18:17:01.454
当前年： 2019
当前月： 5
当前月中的日：  23
当前星期： THURSDAY
当前年中的日： 143
当前时：（24小时制） 18
当前分： 17
当前秒： 1
当前毫秒： （末尾加6个0）454000000

自定义时间为： 2019-05-23T11:24:21
给时间增加一年： 2020-05-23T11:24:21
给月份减二月： 2019-03-23T11:24:21
只修改日： 2019-05-13T11:24:21
判断是否为闰年： 2019不是闰年
*/

回到顶部

八、java.time.Duration

　　1、此类用来计算两同类型日期的时间差。

import java.time.Duration;
import java.time.LocalDateTime;

public class Demo {
    public static void main(String[] args) {
        LocalDateTime start = LocalDateTime.of(2019, 5, 2, 12, 1);// 获取开始日期
        LocalDateTime end = LocalDateTime.of(2019, 6, 1, 13, 1);// 获取结束日期

        Duration result = Duration.between(start, end);// 用于计算相差的日期
        System.out.println(result.toDays());// 相差的天
        System.out.println(result.toHours());// 相差的时间
        System.out.println(result.toMinutes());// 相差的分钟
        System.out.println(result.toMillis());// 相差的秒数
        System.out.println(result.toNanos());// 相差的毫秒数
    }
}
/*
测试结果：
30
721
43260
2595600000
2595600000000000
*/

回到顶部

九、java.time.Instant

　　1、用法类似于java.util.Date。

import java.time.Instant;

public class Demo {
    public static void main(String[] args) {
        Instant instant = Instant.now();
        System.out.println(instant);// 输出当前系统时间
        System.out.println(instant.toEpochMilli());// 获取当前的毫秒值
        // 当前时间与参数中的时间进行对比,在参数的时间之前,相同,之后的值分别是(-1,0,1)
        System.out.println(instant.compareTo(instant));
    }
}
/*
测试结果：
2019-05-23T09:41:29.213Z
1558604489213
0
*/

回到顶部

十、java.time.format.DateTimeFormatter　　

　　1、类似于java.text.SimpleDateFormat。但其只用来创建日期的显示模板。

　　2、parse()方法是一种静态方法，使用LocalDateTime.parse()来调用。

　　3、format()方法需要使用LocalDateTime等类来调用。

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.util.Date;

public class Test {
    public static void main(String args[]) {
        // JDK 8之前，String转Date， Date转String如下：
        Date date = new Date();// 实例化一个Date，用于获取当前系统时间。
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");// 定义一个格式
        System.out.println(date);// 输出当前系统时间
        System.out.println(sdf.format(date)); // 将Date转为String
        try {
            // 将String转为Date，此处需要抛出异常
            System.out.println(sdf.parse("2019-5-24"));
        } catch (ParseException e) {
            System.out.println("格式转换失败！");
        }

        // JDK 8后，引入新的日期类，String与Date互转如下：
        LocalDateTime ldt = LocalDateTime.now();// 获取当前系统时间
        // 定义格式
        DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
        System.out.println(ldt);// 输出当前系统时间
        System.out.println(ldt.format(dtf));// 将Date转为String
        try {
            // 将String转为Date，注意，此处必须严格按照格式匹配，例如：MM不能写成5，只能写成05
            // 此处会抛异常
            System.out.println(LocalDateTime.parse("2019-5-24 12:22:33", dtf));
        } catch (DateTimeParseException e) {
            System.out.println("格式转换失败！");
        }
        // 这是正确的写法。注意LocalDateTime的格式为：yyyy-MM-dd HH:mm:ss
        // 而LlocalDate的格式为：yyyy-MM-dd，此处需要注意一下格式的写法。
        System.out.println(LocalDateTime.parse("2019-05-24 12:22:33", dtf));
    }
}
/*
测试结果：
Fri May 24 10:58:09 JST 2019
2019-05-24
Fri May 24 00:00:00 JST 2019
2019-05-24T10:58:09.681
2019-05-24 10:58:09
格式转换失败！
2019-05-24T12:22:33
*/