Java 8 日期时间API实战

一、Date？Calendar？

• Java 1.0中，对日期和时间的支持只能依赖java.util.Date类。由于Date糟糕的易用性，Java 1.1中Date的很多方法被废弃了，取而代之的是Calendar类。

• 但是Calendar也并不好用，如月份从0开始，非线程安全，使得代码很容易出错。我们最常用的SimpleDateFormat中相信每个人项目中都有，很多人对这个SimpleDateFormat线程安全的问题没有很直观的认识，下面看这么一个场景

  //相信每个人项目中都有这么一个DateUtil、SimpleDateFormatpublic class DateUtil{   private static SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyyMMdd HH");}//调用方public class Test{  //20191228 14    System.out.println(DateUtil.simpleDateFormat.format(new Date()));    //某个线程按照自己的时区，影响了全局的simpleDateFormat，其他调用者就得出错误结果  //20191228 06    new Thread(() -> {				DateUtil.simpleDateFormat.setTimeZone(TimeZone.getTimeZone("+7"));	      System.out.println(DateUtil.simpleDateFormat.format(new Date()));    }).start();  //20191228 06    new Thread(() -> {      System.out.println(DateUtil.simpleDateFormat.format(new Date()));    }).start();}

• 不仅如此，代码中同时存在Date和Calendar，广大Java程序员更加困惑。因此涉及到日期时间大部分情况下都是借助于第三方库来实现日期时间功能，如joda-time。其实Java 8 的日期时间API能看到很多joda-time的特性。

• 顺应潮流，Java 8的大版本中提供了一系列日期和时间支持的API。本文主要介绍这些新增的API，让你不用从上到下new Date()一把梭。

二、Java 8中日期、时间

• 本文主要从Java 8中的日期、时间两大块来介绍这些新增的API。

LocalDate

• LocalDate类实例是一个不可变对象，只包含日期，不含有时间信息，也不带时区信息

//今天LocalDate now = LocalDate.now();System.out.println(now);//年、月、日构造LocalDate date = LocalDate.of(2018, 12, 12);System.out.println(date);

LocalTime

• LocalTime只包含时间信息，不包含日期信息。

LocalTime time = LocalTime.now();LocalTime time1 = LocalTime.parse("12:4:20");

LocalDateTime

• LocalDate和LocalTime的结合体，既有时间信息，又有日期信息。

//今天当前时间LocalDateTime ltime1 = LocalDateTime.now();//指定年、月、日、时、分、秒LocalDateTime time = LocalDateTime.of(2019, 12, 26, 12, 11, 34);//LocalDate + 时间信息LocalDateTime ltime2= LocalDate.now().atTime(12,11,23);//LocalTime + 日期信息LocalTime.now().atDate(LocalDate.now());

Duration、Period

• Duration/Period均不是一个时间点，而是时间间隔。Period类表示年、月、日时间间隔，Duration是一个表示秒/纳秒的时间间隔。即Period基于日期值，而Duration基于时间值。
• 这两个类是为了日期、时间的度量服务的。

//几天前的实现LocalDate date1 =LocalDate.now();LocalDate date2 = LocalDate.of(2019, 12, 11);Period period = Period.between(date1, date2);//-17System.out.println(period.getDays());

TemporalAdjuster

• Java 8 中内置的一个工具类，可以更加灵活处理日期。
• Java 8中提供了大量预定义的TemporalAdjuster，在一些复杂的时间操作下非常好用。

//可以看出这个类的作用是将一个Temporal转成另一个Temporal//LocalDate、LoclaTime、LocalDateTime等都实现了Temporal接口@FunctionInterfacepublic function TemporalAdjuster{  Temporal adjustInto(Temporal temporal);}

DateTimeFormatter

• 主要用于日期格式化操作，format()/parse()。

//formatLocalDateTime dateTime = LocalDateTime.now();String strDate1 = dateTime.format(DateTimeFormatter.BASIC_ISO_DATE);    // 20170105String strDate2 = dateTime.format(DateTimeFormatter.ISO_LOCAL_DATE);    // 2017-01-05String strDate3 = dateTime.format(DateTimeFormatter.ISO_LOCAL_TIME);    // 14:20:16.998String strDate4 = dateTime.format(DateTimeFormatter.ofPattern("yyyy-MM-dd"));// 2017-01-05//parseString strDate6 = "2017-01-05";String strDate7 = "2017-01-05 12:30:05";LocalDate date = LocalDate.parse(strDate6, DateTimeFormatter.ofPattern("yyyy-MM-dd"));LocalDateTime dateTime1 = LocalDateTime.parse(strDate7, DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));

三、常用功能

LocalDate、LocalTime

//今天12：00：00时间戳LocalDate.now().atTime(12,0,0).toInstant(ZoneOffset.of("+8")).getEpochSecond());//今天0：10：00时间戳LocalDate.now().atTime(0,10,0).toInstant(ZoneOffset.of("+8")).getEpochSecond());//几天/周/年前、后//5天前LocalDate.now().minusDays(5);//1天后LocalDate.now().plusDays(1);//2周后LocalDate.now().plusWeeks(2);//几小时/分钟前、后//2小时前LocalTime.now().minusHours(2);//5分钟后LocalTime.now().plusMinutes(5);

Date、LocalDate、LocalTime、LocalDateTime

//Date转LocalDateTimeDate date = new Date();LocalDateTime time1 = LocalDateTime.ofInstant(date.toInstant(),ZoneOffset.of("+8"))  								//Date转LocalDateLocalDate date1 = LocalDateTime.ofInstant(date.toInstant(),ZoneOffset.of("+8"))  								.toLocalate()//LocalDate无法直接转Date，因为LocalDate不含时间信息//LocalDateTime转DateLocalDateTime localDateTime3 = LocalDateTime.now();Instant instant3 = LocalDateTime3.atZone(ZoneId.systemDefault()).toInstant();Date date3 = Date.from(instant);

DateTimeFormatter的使用

//前端传递过来的字符串20191212，后端需要 2019-12-12//除了replace()，更优雅的方式DateTimeFormatter formatter = DateTimeFormatter.BASIC_ISO_DATE;LocalDate formatted = LocalDate.parse("20191212",formatter);//2019-12-12System.out.println(formatted);//前端传递过来的字符串2019-12-12，后端需要 20191212LocalDate.parse("2019-12-12").format(DateTimeFormatter.BASIC_ISO_DATE));//前端传递过来的字符串2019年12月12日，后端需要 2019-12-12System.out.println(LocalDate.parse("2019年12月12日",DateTimeFormatter.ofPattern("yyyy年MM月dd日")));

TemporalAdjuster

//场景中需要使用距当前最近的周一//返回上一个周一，如果今天是周一则返回今天LocalDate date1 =LocalDate.now().with(previousOrSame(DayOfWeek.MONDAY));//下一个周一/当天LocalDate date1 =LocalDate.now().with(nextOrSame(DayOfWeek.MONDAY));//本月最后一天System.out.println(LocalDate.now().with(TemporalAdjusters.lastDayOfMonth()));//明年第一天System.out.println(LocalDate.now().with(TemporalAdjusters.firstDayOfNextYear()));

四、小结

• 本文主要介绍了Java 8中的日期时间API中常用的LocalDate、LocalTime、LocalDateTime、DateTimeFormatter、TemporalAdjuster，以及与Date之间的互转。极大地丰富了我们在日期时间开发中的选择，而且解决了Date、SimpleDateFormat等线程安全的问题。
• 在复杂日期时间场景下善于使用TemporalAdjuster，真香。