简介

随同 lambda表达式、stream 以及一系列小优化,Java 8 推出了全新的日期工夫API。

Java解决日期、日历和工夫的不足之处:将 java.util.Date 设定为可变类型,以及 SimpleDateFormat 的非线程平安使其利用十分受限。而后就在 java8 下面减少新的个性。

全新API的泛滥益处之一就是,明确了日期工夫概念,例如:刹时(instant)、 长短(duration)、日期、工夫、时区和周期。

同时继承了Joda 库按人类语言和计算机各自解析的工夫解决形式。不同于老版本,新API基于ISO规范日历零碎,java.time包下的所有类都是不可变类型而且线程平安。

要害类

  • Instant:刹时实例。
  • LocalDate:本地日期,不蕴含具体工夫 例如:2014-01-14 能够用来记录生日、纪念日、加盟日等。
  • LocalTime:本地工夫,不蕴含日期。
  • LocalDateTime:组合了日期和工夫,但不蕴含时差和时区信息。
  • ZonedDateTime:最残缺的日期工夫,蕴含时区和绝对UTC或格林威治的时差。

新API还引入了 ZoneOffSet 和 ZoneId 类,使得解决时区问题更为简便。解析、格式化工夫的 DateTimeFormatter

类也全副从新设计。

实战

在教程中咱们将通过一些简略的实例来学习如何应用新API,因为只有在理论的我的项目中用到,才是学习新常识以及新技术最快的形式。

1. 获取以后的日期

Java 8 中的 LocalDate 用于示意当天日期。和 java.util.Date不同,它只有日期,不蕴含工夫。当你仅须要示意日期时就用这个类。

//获取明天的日期public void getCurrentDate(){    LocalDate today = LocalDate.now();    System.out.println("Today's Local date : " + today);    //这个是作为比照    Date date = new Date();    System.out.println(date);}

下面的代码创立了当天的日期,不含工夫信息。打印出的日期格局十分敌对,不像 Date类 打印出一堆没有格式化的信息。

2. 获取年、月、日信息

LocalDate 提供了获取年、月、日的快捷办法,其实例还蕴含很多其它的日期属性。通过调用这些办法就能够很不便的失去须要的日期信息,不必像以前一样须要依赖java.util.Calendar类了。

//获取年、月、日信息public void getDetailDate(){    LocalDate today = LocalDate.now();    int year = today.getYear();    int month = today.getMonthValue();    int day = today.getDayOfMonth();    System.out.printf("Year : %d  Month : %d  day : %d t %n", year, month, day);}

3.解决特定日期

在第一个例子里,咱们通过动态工厂办法now()非常容易地创立了当天日期。

咱们还能够调用另一个有用的工厂办法 LocalDate.of() 创立任意日期, 该办法须要传入年、月、日做参数,返回对应的LocalDate实例。这个办法的益处是没再犯老API的设计谬误,比方年度起始于1900,月份是从 0 开始等等。日期所见即所得,就像上面这个例子示意了1月21日,间接明了。

//解决特定日期public void handleSpecilDate(){    LocalDate dateOfBirth = LocalDate.of(2018, 01, 21);    System.out.println("The specil date is : " + dateOfBirth);}

4.判断两个日期是否相等

现实生活中有一类工夫解决就是判断两个日期是否相等。在我的项目开发的时候总会遇到这样子的问题。
上面这个例子会帮忙你用Java 8的形式去解决,LocalDate 重载了equal办法。

留神,如果比拟的日期是字符型的,须要先解析成日期对象再作判断。

请看上面的例子:

//判断两个日期是否相等public void compareDate(){    LocalDate today = LocalDate.now();    LocalDate date1 = LocalDate.of(2018, 01, 21);    if(date1.equals(today)){           System.out.printf("TODAY %s and DATE1 %s are same date %n", today, date1);    }}

5.查看像生日这种周期性事件

Java 中另一个日期工夫的解决就是查看相似生日、纪念日、法定假日(国庆以及春节)、或者每个月固定工夫发送邮件给客户 这些周期性事件。

Java中如何查看这些节日或其它周期性事件呢?答案就是MonthDay类。这个类组合了月份和日,去掉了年,这意味着你能够用它判断每年都会产生事件。Java知音公众号内回复“面试题聚合”,送你一份面试题宝典

和这个类类似的还有一个YearMonth类。这些类也都是不可变并且线程平安的值类型。上面咱们通过 MonthDay来查看周期性事件:

//解决周期性的日期public void cycleDate(){    LocalDate today = LocalDate.now();    LocalDate dateOfBirth = LocalDate.of(2018, 01, 21);    MonthDay birthday = MonthDay.of(dateOfBirth.getMonth(), dateOfBirth.getDayOfMonth());    MonthDay currentMonthDay = MonthDay.from(today);    if(currentMonthDay.equals(birthday)){       System.out.println("Many Many happy returns of the day !!");    }else{       System.out.println("Sorry, today is not your birthday");    }}

6.获取以后工夫

与 获取日期 例子很像,获取工夫应用的是 LocalTime 类,一个只有工夫没有日期的LocalDate远亲。能够调用动态工厂办法now()来获取以后工夫。默认的格局是hh:mm:ss:nnn。

//获取以后工夫public void getCurrentTime(){    LocalTime time = LocalTime.now();    System.out.println("local time now : " + time);}

7.在现有的工夫上减少小时

Java 8 提供了更好的 plusHours() 办法替换 add() ,并且是兼容的。留神,这些办法返回一个全新的LocalTime实例,因为其不可变性,返回后肯定要用变量赋值。

//减少小时public void plusHours(){    LocalTime time = LocalTime.now();    LocalTime newTime = time.plusHours(2); // 减少两小时    System.out.println("Time after 2 hours : " +  newTime);}

8.如何计算一个星期之后的日期

和上个例子计算两小时当前的工夫相似,这个例子会计算一周后的日期。LocalDate日期不蕴含工夫信息,它的plus()办法用来减少天、周、月,ChronoUnit类申明了这些工夫单位。因为LocalDate也是不变类型,返回后肯定要用变量赋值。

能够用同样的办法减少1个月、1年、1小时、1分钟甚至一个世纪,更多选项能够查看Java 8 API中的ChronoUnit类。

//如何计算一周后的日期public void nextWeek(){    LocalDate today = LocalDate.now();    LocalDate nextWeek = today.plus(1, ChronoUnit.WEEKS);    //应用变量赋值    System.out.println("Today is : " + today);    System.out.println("Date after 1 week : " + nextWeek);}

9.计算一年前或一年后的日期

接着下面的例子中咱们通过 LocalDate 的 plus() 办法减少天数、周数或月数,这个例子咱们利用 minus() 办法计算一年前的日期。

//计算一年前或一年后的日期public void minusDate(){    LocalDate today = LocalDate.now();    LocalDate previousYear = today.minus(1, ChronoUnit.YEARS);    System.out.println("Date before 1 year : " + previousYear);    LocalDate nextYear = today.plus(1, ChronoUnit.YEARS);    System.out.println("Date after 1 year : " + nextYear);}

10.应用Java 8的Clock时钟类

Java 8减少了一个 Clock 时钟类用于获取过后的工夫戳,或以后时区下的日期工夫信息。以前用到System.currentTimeInMillis() 和 TimeZone.getDefault() 的中央都可用Clock替换。

public void clock(){    // 依据零碎工夫返回以后工夫并设置为UTC。    Clock clock = Clock.systemUTC();    System.out.println("Clock : " + clock);    // 依据零碎时钟区域返回工夫    Clock defaultClock = Clock.systemDefaultZone();    System.out.println("Clock : " + clock);}

11.判断日期是早于还是晚于另一个日期

LocalDate 类有两类办法 isBefore() 和 isAfter() 用于比拟日期。调用 isBefore() 办法时,如果给定日期小于以后日期则返回 true。

//如何用Java判断日期是早于还是晚于另一个日期public void isBeforeOrIsAfter(){    LocalDate today = LocalDate.now();     LocalDate tomorrow = LocalDate.of(2018, 1, 29);    if(tomorrow.isAfter(today)){        System.out.println("Tomorrow comes after today");    }    //减去一天    LocalDate yesterday = today.minus(1, ChronoUnit.DAYS);    if(yesterday.isBefore(today)){        System.out.println("Yesterday is day before today");    }}

12.解决时区

Java 8不仅拆散了日期和工夫,也把时区分离出来了。当初有一系列独自的类如 ZoneId 来解决特定时区,ZoneDateTime 类来示意某时区下的工夫。

//获取特定时区上面的工夫public void getZoneTime(){    //设置时区    ZoneId america = ZoneId.of("America/New_York");    LocalDateTime localtDateAndTime = LocalDateTime.now();    ZonedDateTime dateAndTimeInNewYork  = ZonedDateTime.of(localtDateAndTime, america );    System.out.println("当初的日期和工夫在特定的时区 : " + dateAndTimeInNewYork);}

13.如何体现出固定日期

例如:示意信用卡到期这类固定日期。与 MonthDay 查看反复事件的例子类似,YearMonth 是另一个组合类,用于示意信用卡到期日、FD到期日、期货期权到期日等。

还能够用这个类失去 当月共有多少天,YearMonth 实例的 lengthOfMonth() 办法能够返回当月的天数,在判断2月有28天还是29地利十分有用。

//应用 YearMonth类解决特定的日期public void checkCardExpiry(){    YearMonth currentYearMonth = YearMonth.now();    System.out.printf("Days in month year %s: %d%n", currentYearMonth, currentYearMonth.lengthOfMonth());    YearMonth creditCardExpiry = YearMonth.of(2028, Month.FEBRUARY);    System.out.printf("Your credit card expires on %s %n", creditCardExpiry);}

14.查看平年

LocalDate类有一个很实用的办法 isLeapYear() 判断该实例是否是一个平年,如果你还是想从新创造轮子,这有一个代码示例,纯Java逻辑编写的判断平年的程序。

//查看平年public void isLeapYear(){    LocalDate today = LocalDate.now();    if(today.isLeapYear()){        System.out.println("This year is Leap year");    }else {        System.out.println("2018 is not a Leap year");    }}

15.计算两个日期之间的天数和月数

有一个常见日期操作是计算两个日期之间的天数、周数或月数。在Java 8中能够用java.time.Period类来做计算。上面这个例子中,咱们计算了当天和未来某一天之间的月数。

上面的例子:当初是一月份,间隔到五月份,两头相隔3月

//计算两个日期之间的天数和月数public void calcDateDays(){    LocalDate today = LocalDate.now();    LocalDate java8Release = LocalDate.of(2018, Month.MAY, 14);    Period periodToNextJavaRelease = Period.between(today, java8Release);    System.out.println("Months left between today and Java 8 release : "                                           + periodToNextJavaRelease.getMonths() );}

16.蕴含时差信息的日期和工夫

ZoneOffset类用来示意时区,举例来说印度与GMT或UTC标准时区相差+05:30,能够通过ZoneOffset.of()静态方法来 获取对应的时区。一旦失去了时差就能够通过传入LocalDateTime和ZoneOffset来创立一个OffSetDateTime对象。

public void ZoneOffset(){    LocalDateTime datetime = LocalDateTime.of(2018, Month.FEBRUARY, 14, 19, 30);    ZoneOffset offset = ZoneOffset.of("+05:30");    OffsetDateTime date = OffsetDateTime.of(datetime, offset);      System.out.println("Date and Time with timezone offset in Java : " + date);}

17.获取以后的工夫戳

Instant类有一个动态工厂办法now()会返回以后的工夫戳,如下所示:

public void getTimestamp(){    Instant timestamp = Instant.now();    System.out.println("What is value of this instant " + timestamp);}

18.应用预约义的格式化工具去解析或格式化日期

Java 8引入了全新的日期工夫格局工具,线程平安而且使用方便。它自带了一些罕用的内置格式化工具。

上面这个例子应用了BASIC\_ISO\_DATE格式化工具将2018年2月10日格式化成20180210。

// 应用预约义的格式化工具去解析或格式化日期public void formateDate(){    String dayAfterTommorrow = "20180210";    LocalDate formatted = LocalDate.parse(dayAfterTommorrow, DateTimeFormatter.BASIC_ISO_DATE);    System.out.printf("Date generated from String %s is %s %n", dayAfterTommorrow, formatted);}

最初

最初附上全副代码

package com.wq.study.java8.date;import java.time.Clock;import java.time.Instant;import java.time.LocalDate;import java.time.LocalDateTime;import java.time.LocalTime;import java.time.Month;import java.time.MonthDay;import java.time.OffsetDateTime;import java.time.ZoneOffset;import java.time.Period;import java.time.YearMonth;import java.time.ZoneId;import java.time.ZonedDateTime;import java.time.format.DateTimeFormatter;import java.time.temporal.ChronoUnit;import java.util.Date;public class DateTest {    //获取明天的日期    public void getCurrentDate(){        LocalDate today = LocalDate.now();        System.out.println("Today's Local date : " + today);        //这个是作为比照        Date date = new Date();        System.out.println(date);    }    //获取年、月、日信息    public void getDetailDate(){        LocalDate today = LocalDate.now();        int year = today.getYear();        int month = today.getMonthValue();        int day = today.getDayOfMonth();        System.out.printf("Year : %d  Month : %d  day : %d t %n", year, month, day);    }    //解决特定日期    public void handleSpecilDate(){        LocalDate dateOfBirth = LocalDate.of(2018, 01, 21);        System.out.println("The specil date is : " + dateOfBirth);    }    //判断两个日期是否相等    public void compareDate(){        LocalDate today = LocalDate.now();        LocalDate date1 = LocalDate.of(2018, 01, 21);        if(date1.equals(today)){            System.out.printf("TODAY %s and DATE1 %s are same date %n", today, date1);        }    }    //解决周期性的日期    public void cycleDate(){        LocalDate today = LocalDate.now();        LocalDate dateOfBirth = LocalDate.of(2018, 01, 21);        MonthDay birthday = MonthDay.of(dateOfBirth.getMonth(), dateOfBirth.getDayOfMonth());        MonthDay currentMonthDay = MonthDay.from(today);        if(currentMonthDay.equals(birthday)){           System.out.println("Many Many happy returns of the day !!");        }else{           System.out.println("Sorry, today is not your birthday");        }    }    //获取以后工夫    public void getCurrentTime(){        LocalTime time = LocalTime.now();        System.out.println("local time now : " + time);    }    //减少小时    public void plusHours(){        LocalTime time = LocalTime.now();        LocalTime newTime = time.plusHours(2); // 减少两小时        System.out.println("Time after 2 hours : " +  newTime);    }    //如何计算一周后的日期    public void nextWeek(){        LocalDate today = LocalDate.now();        LocalDate nextWeek = today.plus(1, ChronoUnit.WEEKS);        System.out.println("Today is : " + today);        System.out.println("Date after 1 week : " + nextWeek);    }    //计算一年前或一年后的日期    public void minusDate(){        LocalDate today = LocalDate.now();        LocalDate previousYear = today.minus(1, ChronoUnit.YEARS);        System.out.println("Date before 1 year : " + previousYear);        LocalDate nextYear = today.plus(1, ChronoUnit.YEARS);        System.out.println("Date after 1 year : " + nextYear);    }    public void clock(){        // 依据零碎工夫返回以后工夫并设置为UTC。        Clock clock = Clock.systemUTC();        System.out.println("Clock : " + clock);        // 依据零碎时钟区域返回工夫        Clock defaultClock = Clock.systemDefaultZone();        System.out.println("Clock : " + clock);    }    //如何用Java判断日期是早于还是晚于另一个日期    public void isBeforeOrIsAfter(){        LocalDate today = LocalDate.now();         LocalDate tomorrow = LocalDate.of(2018, 1, 29);        if(tomorrow.isAfter(today)){            System.out.println("Tomorrow comes after today");        }        LocalDate yesterday = today.minus(1, ChronoUnit.DAYS);        if(yesterday.isBefore(today)){            System.out.println("Yesterday is day before today");        }    }    //时区解决    public void getZoneTime(){        //设置时区        ZoneId america = ZoneId.of("America/New_York");        LocalDateTime localtDateAndTime = LocalDateTime.now();        ZonedDateTime dateAndTimeInNewYork  = ZonedDateTime.of(localtDateAndTime, america );        System.out.println("当初的日期和工夫在特定的时区 : " + dateAndTimeInNewYork);    }    //应用 YearMonth类解决特定的日期    public void checkCardExpiry(){        YearMonth currentYearMonth = YearMonth.now();        System.out.printf("Days in month year %s: %d%n", currentYearMonth, currentYearMonth.lengthOfMonth());        YearMonth creditCardExpiry = YearMonth.of(2028, Month.FEBRUARY);        System.out.printf("Your credit card expires on %s %n", creditCardExpiry);    }    //查看平年    public void isLeapYear(){        LocalDate today = LocalDate.now();        if(today.isLeapYear()){           System.out.println("This year is Leap year");        }else {            System.out.println("2018 is not a Leap year");        }    }    //计算两个日期之间的天数和月数    public void calcDateDays(){        LocalDate today = LocalDate.now();        LocalDate java8Release = LocalDate.of(2018, Month.MAY, 14);        Period periodToNextJavaRelease = Period.between(today, java8Release);        System.out.println("Months left between today and Java 8 release : "                                           + periodToNextJavaRelease.getMonths() );    }    // 蕴含时差信息的日期和工夫    public void ZoneOffset(){        LocalDateTime datetime = LocalDateTime.of(2018, Month.FEBRUARY, 14, 19, 30);        ZoneOffset offset = ZoneOffset.of("+05:30");        OffsetDateTime date = OffsetDateTime.of(datetime, offset);          System.out.println("Date and Time with timezone offset in Java : " + date);    }    // 获取工夫戳    public void getTimestamp(){        Instant timestamp = Instant.now();        System.out.println("What is value of this instant " + timestamp);    }    // 应用预约义的格式化工具去解析或格式化日期    public void formateDate(){        String dayAfterTommorrow = "20180210";        LocalDate formatted = LocalDate.parse(dayAfterTommorrow, DateTimeFormatter.BASIC_ISO_DATE);        System.out.printf("Date generated from String %s is %s %n", dayAfterTommorrow, formatted);    }    public static void main(String[] args) {        DateTest dt = new DateTest();        dt.formateDate();    }}

总结

Java 8日期工夫API的重点

  • 提供了javax.time.ZoneId 获取时区。
  • 提供了LocalDate和LocalTime类。
  • Java 8 的所有日期和工夫API都是不可变类并且线程平安,而现有的Date和Calendar API中的java.util.Date和SimpleDateFormat是非线程平安的。
  • 主包是 java.time,蕴含了示意日期、工夫、工夫距离的一些类。外面有两个子包java.time.format用于格式化, java.time.temporal用于更底层的操作。
  • 时区代表了地球上某个区域内广泛应用的规范工夫。每个时区都有一个代号,格局通常由区域/城市形成(Asia/Tokyo),在加上与格林威治或 UTC的时差。例如:东京的时差是+09:00。