Java 8 Time API使用

Java 8 全新的日期时间API

• java.time.*

Java处理日期、日历和时间的方式一直为社区所诟病，将 java.util.Date 设定为可变类型，以及 SimpleDateFormat 的非线程安全使其应用非常受限。而新API基于ISO标准日历系统，java.time 包下的所有类都是不可变类型而且线程安全。

类的名称	描述
Clock	时钟，比如获取目前美国纽约的时间
Duration	持续时间，时间差
Instant	时间戳，表示时刻，不直接对应年月日信息，需要通过时区转换
LocalDate	表示当前(或指定)日期，格式为：yyyy-MM-dd
LocalDateTime	表示当前(或指定)日期时间，格式为：yyyy-MM-ddTHH:mm:ss.SSS
LocalTime	表示当前(或指定)时间，格式为：HH:mm:ss.SSS
Period	时间段
ZoneId/ZoneOffset	表示时区偏移量，比如：+8:00
ZonedDateTime	特定时区的日期和时间
java.time.format.DateTimeFormatter	时间格式化

通过以下实例来学习如何使用新API：

示例1：Java 8中获取当前的日期 yyyy-MM-dd

Java 8 中的 java.time.LocalDate 用于表示当天日期与java.util.Date 不同，它只有日期，不包含时间。当你仅需要表示日期时就用这个类。

    @Test
    public void Demo01() {
        LocalDate today = LocalDate.now();
        System.out.println("今天的日期:" + today);
    }

示例2：Java 8中获取年、月、日

    @Test
    public void Demo02() {
        LocalDate today = LocalDate.now();
        int year = today.getYear();
        int month = today.getMonthValue();
        int day = today.getDayOfMonth();

        System.out.println("年：" + year);
        System.out.println("月：" + month);
        System.out.println("日：" + day);
    }

示例3：Java 8中处理特定日期

我们通过静态工厂方法 now() 非常容易地创建了当天日期，你还可以调用另一个有用的工厂方法 LocalDate.of() 创建任意日期， 该方法需要传入年、月、日做参数，返回对应的 LocalDate 实例。这个方法的好处是没再犯老API的设计错误，比如年度起始于1900，月份是从0开始等等。

    @Test
    public void Demo03() {
        LocalDate date = LocalDate.of(2020, 5, 1);
        System.out.println("自定义日期:" + date);
    }

示例4：Java 8中判断两个日期是否相等

    @Test
    public void Demo04() {
        LocalDate date1 = LocalDate.now();
        LocalDate date2 = LocalDate.of(2020, 5, 1);

        if (date1.equals(date2)) {
            System.out.println("时间相等");
        } else {
            System.out.println("时间不等");
        }
    }

示例5：Java 8中检查像生日这种周期性事件

    @Test
    public void Demo05() {
        LocalDate date1 = LocalDate.now();
        //例如指定生日为
        LocalDate date2 = LocalDate.of(1996, 10, 01);
        //获取指定生日的 月、日
        MonthDay birthday = MonthDay.of(date2.getMonth(), date2.getDayOfMonth());
        //获取当前时间的 月、日
        MonthDay currentMonthDay = MonthDay.from(date1);
        if (currentMonthDay.equals(birthday)) {
            System.out.println("是你的生日");
        } else {
            System.out.println("你的生日还没有到");
        }
    }

示例6：Java 8中获取当前时间 HH:mm:ss.SSS

    @Test
    public void Demo06() {
        LocalTime time = LocalTime.now();
        System.out.println("获取当前的时间,不含有日期:" + time);
    }

示例7：Java 8中获取当前时间增加指定的小时数返回一个新的时间

    @Test
    public void Demo07() {
        LocalTime time = LocalTime.now();
        //增加指定的小时数，返回一个新的时间
        LocalTime newTime = time.plusHours(3);
        System.out.println("三个小时后的时间为:" + newTime);
    }

示例8：Java 8中计算一周后的日期

    @Test
    public void Demo08() {
        LocalDate today = LocalDate.now();
        System.out.println("今天的日期为:" + today);
        //方式一：
        LocalDate nextWeek1 = today.plusWeeks(1);
        System.out.println("一周后的日期为:" + nextWeek1);

        //方式二：
        LocalDate nextWeek2 = today.plus(1, ChronoUnit.WEEKS);
        System.out.println("一周后的日期为:" + nextWeek2);
    }

更多选项可查看Java 8 API中的 ChronoUnit 类，可以用同样的方法增加 年、月、小时、分钟甚至一个世纪等。

示例9：Java 8中计算一年前或一年后的日期

    @Test
    public void Demo09() {
        LocalDate today = LocalDate.now();
        System.out.println("今天的日期为:" + today);

        //方式一：
        LocalDate previousYear1 = today.minusYears(1);
        System.out.println("一年前的日期:" + previousYear1);
        //方式二：
        LocalDate previousYear2 = today.minus(1, ChronoUnit.YEARS);
        System.out.println("一年前的日期:" + previousYear2);

        //方式一：
        LocalDate nextYear1 = today.plusYears(1);
        System.out.println("一年后的日期:" + nextYear1);
        //方式二：
        LocalDate nextYear2 = today.plus(1, ChronoUnit.YEARS);
        System.out.println("一年后的日期:" + nextYear2);
    }

示例10：Java 8中的Clock时钟类 获取时间戳

Java 8增加了一个Clock时钟类用于获取当时的时间戳 或 当前时区下的日期时间信息，以前用到：

        //获取当前时间戳方法一
        System.currentTimeMillis();
        //获取当前时间戳方法二
        Calendar.getInstance().getTimeInMillis();
        //获取当前时间戳方法三
        new Date().getTime();

和

        TimeZone.getDefault();

都可用Clock替换：

    @Test
    public void Demo10() {
        Instant timestamp = Instant.now();
        //将此瞬间转换为1970-01-01T00：00：00Z的时期的毫秒数。
        System.out.println("时间戳：" + timestamp.toEpochMilli());

        //获取使用最佳可用系统时钟返回当前即时的时钟，使用UTC时区转换为日期和时间。
        Clock clock = Clock.systemUTC();
        System.out.println("Clock：" + clock.millis());

        //获取使用最佳可用系统时钟返回当前即时的时钟，使用默认时区转换为日期和时间。
        Clock defaultClock = Clock.systemDefaultZone();
        System.out.println("Clock：" + defaultClock.millis());
    }

注：时间戳信息里同时包含了日期和时间，实际上Instant类确实等同于Java 8之前的 java.util.Date 类，可以使用以下方法进行转换，例：Date.from(Instant instant) 将 Instant 转换成 java.util.Date ; Date.toInstant() 则是将 Date 类转换成 Instant 类。

示例11：Java 8中判断日期是早于还是晚于某个日期

工作中常见的操作就是如何判断给定的一个日期是大于某个日期还是小于某个日期。Java 8中，利用LocalDate类有两类方法isBefore()和isAfter()用于比较日期。调用isAfter()方法时，如果给定日期大于当前日期则返回true，同理，调用isBefore()方法时，如果给定日期小于当前日期则返回true。

    @Test
    public void Demo11() {
        LocalDate today = LocalDate.now();
        LocalDate tomorrow = LocalDate.of(2020, 10, 1);
        if (tomorrow.isAfter(today)) {
            System.out.println("之后的日期:" + tomorrow);
        }
        LocalDate yesterday = today.minus(1, ChronoUnit.DAYS);
        if (yesterday.isBefore(today)) {
            System.out.println("之前的日期:" + yesterday);
        }
    }

示例12：Java 8中处理时区

Java 8不仅分离了日期和时间，也把时区分离出来了。现在有一系列单独的类如ZoneId来处理特定时区，ZoneDateTime类来表示某时区下的时间。这在Java 8以前都是 GregorianCalendar 类来做的。下面这个例子展示了如何把本时区的时间转换成另一个时区的时间。

    @Test
    public void Demo12() {
        ZoneId america = ZoneId.of("America/New_York");
        LocalDateTime localtDateAndTime = LocalDateTime.now();
        ZonedDateTime dateAndTimeInNewYork = ZonedDateTime.of(localtDateAndTime, america);
        System.out.println("特定时区中的当前日期和时间：" + dateAndTimeInNewYork);
    }

示例13：Java 8中获取当前年月及自定义年月以及获取当月的天数

    @Test
    public void Demo13() {
        //从默认时区的系统时钟获取当前的一个月。
        YearMonth currentYearMonth = YearMonth.now();
        //返回月份的长度，考虑到年份。
        int days = currentYearMonth.lengthOfMonth();
        System.out.printf("当前年月：%s 有%d天%n", currentYearMonth, days);

        //从一年和一个月获得一个 YearMonth 的实例。
        YearMonth customYearMonth = YearMonth.of(2020, Month.MAY);
        System.out.printf("自定义年月：%s %n", customYearMonth);
    }

注：利用YearMonth实例的lengthOfMonth()方法可以返回当月的天数，在判断2月有28天还是29天时非常有用。

示例14：Java 8中检查闰年

    @Test
    public void Demo14() {
        LocalDate today = LocalDate.now();
        int year = today.getYear();
        if (today.isLeapYear()) {
            System.out.println(year + "是闰年");
        } else {
            System.out.println(year + "是平年");
        }
    }

示例15：Java 8中计算两个日期之间的 年、月、日 之差

    @Test
    public void Demo15() {
        LocalDate today = LocalDate.now();
        LocalDate endDate = LocalDate.of(2022, 2, 4);
        Period periodToWinterOlympics = Period.between(today, endDate);
        System.out.println("从今天到冬奥会还有："
                + periodToWinterOlympics.getYears() + "年"
                + periodToWinterOlympics.getMonths() + "月"
                + periodToWinterOlympics.getDays() + "天");
    }

示例16：Java 8中字符串转日期时间类型 

    @Test
    public void Demo16() {
        //1.String --> LocalDate
        String date1 = "20200501";
        String date2 = "2020-05-01";
        String date3 = "2020年05月01日";
        String date4 = "1-May-2020";
        String date5 = "Jun 1 2020";
        LocalDate localDate1 = LocalDate.parse(date1, DateTimeFormatter.BASIC_ISO_DATE);//yyyyMMdd
        LocalDate localDate2 = LocalDate.parse(date2, DateTimeFormatter.ISO_DATE);//yyyy-MM-dd
        DateTimeFormatter dtf1 = DateTimeFormatter.ofPattern("yyyy年MM月dd日");
        LocalDate localDate3 = LocalDate.parse(date3, dtf1);
        DateTimeFormatter dtf2 = DateTimeFormatter.ofPattern("d-MMM-yyyy", Locale.ENGLISH);
        LocalDate localDate4 = LocalDate.parse(date4, dtf2);
        DateTimeFormatter dtf3 = DateTimeFormatter.ofPattern("MMM d yyyy").withLocale(Locale.ENGLISH);
        LocalDate localDate5 = LocalDate.parse(date5, dtf3);
        System.out.println("字符串 转为 日期类型1：" + localDate1);
        System.out.println("字符串 转为 日期类型2：" + localDate2);
        System.out.println("字符串 转为 日期类型3：" + localDate3);
        System.out.println("字符串 转为 日期类型4：" + localDate4);
        System.out.println("字符串 转为 日期类型5：" + localDate5);

        //2.String --> LocalTime
        String time = "10:36:25";
        LocalTime localTime = LocalTime.parse(time);
        System.out.println("字符串 转为 时间类型：" + localTime);

        //3.String --> LocalDateTime
        String date6 = "2020-05-01 10:36:25";
        DateTimeFormatter dtf4 = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
        LocalDateTime localDateTime = LocalDateTime.parse(date6, dtf4);
        System.out.println("字符串 转为 日期时间类型：" + localDateTime.toString());
    }

示例17：Java 8中日期时间类型转字符串

    @Test
    public void Demo17() {
        //1.localDate --> String
        LocalDate localDate = LocalDate.now();
        String format1 = localDate.format(DateTimeFormatter.BASIC_ISO_DATE);//yyyyMMdd
        String format2 = localDate.format(DateTimeFormatter.ISO_DATE);//yyyy-MM-dd
        DateTimeFormatter dtf1 = DateTimeFormatter.ofPattern("yyyy/MM/dd");
        String format3 = localDate.format(dtf1);
        System.out.println("日期类型 转为 字符串1：" + format1);
        System.out.println("日期类型 转为 字符串2：" + format2);
        System.out.println("日期类型 转为 字符串3：" + format3);

        //2.LocalTime --> String
        LocalTime localTime = LocalTime.now();
        String format4 = localTime.format(DateTimeFormatter.ISO_TIME);//HH:mm:ss.SSS
        DateTimeFormatter dtf2 = DateTimeFormatter.ofPattern("HH:mm:ss");//HH:mm:ss
        String format5 = localTime.format(dtf2);
        System.out.println("时间类型 转为 字符串1：" + format4);
        System.out.println("时间类型 转为 字符串2：" + format5);

        //3.LocalDateTime --> String
        LocalDateTime localDateTime = LocalDateTime.now();
        DateTimeFormatter dtf3 = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
        String format6 = localDateTime.format(dtf3);
        System.out.println("日期时间类型 转为 字符串：" + format6);
    }

 

转载请注明出处：BestEternity亲笔。