干掉 Date，Java8 LocalDate 真香

干掉 Date，Java8 LocalDate 真香

简介

伴随 lambda表达式、streams 以及一系列小优化，Java 8 推出了全新的日期时间API。
Java处理日期、日历和时间的不足之处：将 java.util.Date 设定为可变类型，
以及 SimpleDateFormat 的非线程安全使其应用非常受限。
全新API的众多好处之一就是，明确了日期时间概念，例如：瞬时（instant）、 长短（duration）、日期、时间、时区和周期。
同时继承了Joda 库按人类语言和计算机各自解析的时间处理方式。不同于老版本，
新API基于ISO标准日历系统，java.time包下的所有类都是不可变类型而且线程安全。

关键类

• Instant：瞬时实例。
• LocalDate：本地日期，不包含具体时间 例如：2014-01-14 可以用来记录生日、纪念日、加盟日等。
• LocalTime：本地时间，不包含日期。
• LocalDateTime：组合了日期和时间，但不包含时差和时区信息。
• ZonedDateTime：最完整的日期时间，包含时区和相对UTC或格林威治的时差。

新API还引入了 ZoneOffSet 和 ZoneId 类，使得解决时区问题更为简便。解析、格式化时间的 DateTimeFormatter类也全部重新设计。

实战

1、获取当前日期、时间、时间戳

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

LocalDate today = LocalDate.now();
System.out.println("localDate: "+today); // localDate: 2020-06-15

Date date = new Date();
System.out.println("date: "+date); // date: Mon Jun 15 10:45:34 CST 2020

LocalTime time = LocalTime.now();
System.out.println("time: "+time);// time: 10:57:06.260

Instant timestamp = Instant.now();
//timestamp: 2020-06-15T02:57:06.261Z
System.out.println("timestamp: "+ timestamp); 

2、获取年、月、日、小时、分钟、秒信息

LocalDate 提供了获取年、月、日的快捷方法，其实例还包含很多其它的日期属性。
通过调用这些方法就可以很方便的得到需要的日期信息，不用像以前一样需要依赖java.util.Calendar类了。

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 ", year, month, day);//Year : 2020  Month : 6  day : 15

LocalTime time = LocalTime.now();
int hour = time.getHour();
int minute = time.getMinute();
int second = time.getSecond();
//Hour : 11  Minute : 3  Second : 50
System.out.printf("Hour: %d Minute: %d Second: %d", hour, minute, second);

3、处理特定日期、日期比较

在第一个例子里，我们通过静态工厂方法now()非常容易地创建了当天日期。
我们还可以调用另一个有用的工厂方法 LocalDate.of() 创建任意日期，
该方法需要传入年、月、日做参数，返回对应的LocalDate实例。
这个方法的好处是没再犯老API的设计错误，比如年度起始于1900，
月份是从 0 开始等等。日期所见即所得，就像下面这个例子表示了1月21日，直接明了。
LocalDate 重载了equal方法。注意，如果比较的日期是字符型的，
需要先解析成日期对象再作判断。

LocalDate today = LocalDate.now();
LocalDate date1 = LocalDate.of(2020, 06, 15);
if(date1.equals(today)) {
     
   //TODAY 2020-06-15 and DATE1 2020-06-15 are same date 
   System.out.printf("TODAY %s and DATE1 %s are same date %n", today, date1);
}

4、Date 和 LocalDate 相互转换

Date 转 LocalDate
    1）将java.util.Date转换为ZonedDateTime。
    2）使用它的toLocalDate()方法从ZonedDateTime获取LocalDate。
LocalDate 转 Date
    1）使用ZonedDateTime将LocalDate转换为Instant。
    2）使用from()方法从Instant对象获取Date的实例

/**
         * Date 转 LocalDate
         * 1）将java.util.Date转换为ZonedDateTime。
         * 2）使用它的toLocalDate()方法从ZonedDateTime获取LocalDate。
         */
Date date = new Date();
Instant instant = date.toInstant();
ZoneId zoneId = ZoneId.systemDefault();

LocalDate localDate = instant.atZone(zoneId).toLocalDate();
LocalTime localTime = instant.atZone(zoneId).toLocalTime();
LocalDateTime localDateTime = instant.atZone(zoneId).toLocalDateTime();
System.out.println("Date: " + date);// Date: Mon Jun 15 11:18:16 CST 2020
System.out.println("LocalDate: " + localDate);// LocalDate: 2020-06-15
System.out.println("LocalTime: "+localTime);// LocalTime: 11:20:44.668
System.out.println("LocalDateTime: "+localDateTime);// LocalDateTime: 2020-06-15T11:21:41.320
/**
 * LocalDate 转 Date
 * 1）使用ZonedDateTime将LocalDate转换为Instant。
 * 2）使用from()方法从Instant对象获取Date的实例
 */
ZoneId zoneId1 = ZoneId.systemDefault();
LocalDate localDate1 = LocalDate.now();
ZonedDateTime zdt = localDate.atStartOfDay(zoneId1);
Date date1 = Date.from(zdt.toInstant());
System.out.println("LocalDate: " + localDate1); //LocalDate: 2020-06-15
System.out.println("Date: " + date);//Date: Mon Jun 15 11:18:16 CST 2020

5、检查像生日这种周期性事件

Java 中另一个日期时间的处理就是检查类似生日、纪念日、法定假日（国庆以及春节）、
或者每个月固定时间发送邮件给客户 这些周期性事件。
Java中如何检查这些节日或其它周期性事件呢？答案就是MonthDay类。
这个类组合了月份和日，去掉了年，这意味着你可以用它判断每年都会发生事件。
和这个类相似的还有一个YearMonth类。这些类也都是不可变并且线程安全的值类型。

LocalDate today = LocalDate.now();
System.out.printf("today: %s ,",today);// today: 2020-06-15
LocalDate dateOfBirth = LocalDate.of(2000, 06, 15);
MonthDay birthday = MonthDay.of(dateOfBirth.getMonth(), dateOfBirth.getDayOfMonth());
MonthDay currentMonthDay = MonthDay.from(today);
if(currentMonthDay.equals(birthday)){
     
   System.out.println("today is your birthday"); //print
}else{
     
   System.out.println("Sorry, today is not your birthday");
}
//获取当前月共有几天
YearMonth yearExpire = YearMonth.of(2028, Month.FEBRUARY);
// month days:29
System.out.println("month days:"+yearExpire.lengthOfMonth());

6、日期、时间增加或减少

Java 8 提供了更好的 plusHours() 方法替换 add() ，并且是兼容的。
注意，这些方法返回一个全新的LocalTime实例，由于其不可变性，返回后一定要用变量赋值。

LocalTime time = LocalTime.now();
System.out.println("now time:"+ time);// now time:11:42:12.714
LocalTime newTime = time.plusHours(2).plusMinutes(10).plusSeconds(30);
System.out.println("new time: " +  newTime); // new time: 13:52:42.714
LocalTime newTime1= time.plus(1, ChronoUnit.HOURS);
System.out.println("plus new time1: " +  newTime1); //增加一个小时 plus new time1: 12:42:12.714
LocalTime newTime2 = time.minus(1,ChronoUnit.HOURS);
System.out.println("minus new time2: " +  newTime2);//减少一小时 minus new time2: 10:42:12.714

LocalDate date = LocalDate.now();
System.out.println("now date:"+ date); // now date:2020-06-15
LocalDate newDate = date.plusYears(1).plusMonths(2).plusDays(20);
System.out.println("new date: " +  newDate); // new date: 2021-09-04
LocalDate newDate1 = date.plus(1,ChronoUnit.YEARS);
System.out.println("new date1: " +  newDate1); // new date1: 2021-06-15
LocalDate newDate2 = date.minusWeeks(1);
System.out.println("minus week new date2: " +  newDate2);//minus week new date2: 2020-06-08

7、时区相关操作

Java 8不仅分离了日期和时间，也把时区分离出来了。
现在有一系列单独的类如 ZoneId 来处理特定时区，ZoneDateTime 类来表示某时区下的时间。

LocalDateTime datetime = LocalDateTime.of(2020, Month.FEBRUARY, 16, 19, 30);
ZoneOffset offset = ZoneOffset.of("+08:00");
OffsetDateTime date = OffsetDateTime.of(datetime, offset);
//Date+zone: 2020-02-16T19:30+08:00 ,date: 2020-02-16T11:30:00Z
System.out.printf("Date+zone: %s ,date: %s %n" ,date,date.toInstant());

ZoneId america = ZoneId.of("America/New_York");
ZonedDateTime dateAndTimeInNewYork  = ZonedDateTime.of(datetime, america);
System.out.println("修改时区后的时间 : " + dateAndTimeInNewYork.toInstant());//2020-02-17T00:30:00Z

8、计算时间差值

有一个常见日期操作是计算两个日期之间的天数、周数或月数。在Java 8中可以用java.time.Period类来做计算。
下面这个例子中，我们计算了当天和将来某一天之间的月数，现在是一月份，距离到五月份，中间相隔3月

LocalDate today = LocalDate.now();
String dayAfterTomorrow = "20211111";
LocalDate formatted = LocalDate.parse(dayAfterTomorrow, DateTimeFormatter.BASIC_ISO_DATE);
System.out.printf("Date is %s %n",formatted);// Date is 2021-11-11
Period period = Period.between(today, formatted);
System.out.println("between: "+ period );// between: P1Y4M27D
//between: 1 year 4 month 27 day
System.out.printf("between: %d year %d month %d day %n",
	period.getYears(),period.getMonths(),period.getDays());