Java8 LocalDate用法

1、 简介

伴随 lambda表达式、streams 以及一系列小优化，Java 8 推出了全新的日期时间API。

Java处理日期、日历和时间的不足之处：将 java.util.Date 设定为可变类型，以及 SimpleDateFormat 的非线程安全使其应用非常受限。然后就在 java8 上面增加新的特性。

全新API的众多好处之一就是，明确了日期时间概念，例如：瞬时（instant）、 长短（duration）、日期、时间、时区和周期。

同时继承了Joda 库按人类语言和计算机各自解析的时间处理方式。不同于老版本，新API基于ISO标准日历系统，java.time包下的所有类都是不可变类型而且线程安全。

2、关键类

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

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

3、实例

（1）获取当前的日期

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

public static void main(String[] args) {
    LocalDate today = LocalDate.now();
    System.out.println("Today's Local date : " + today);

    //这个是作为对比
    Date date = new Date();
    System.out.println(date);
}

结果：

Today's Local date : 2020-07-07
Tue Jul 07 16:37:38 CST 2020

上面的代码创建了当天的日期，不含时间信息。打印出的日期格式非常友好，不像 Date类 打印出一堆没有格式化的信息。

（2）获取年、月、日信息

public static void main(String[] args) {
    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);
}

结果：

Year : 2020  Month : 7  day : 7 t 

（3）处理特定日期

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

public static void main(String[] args) {
    LocalDate dateOfBirth = LocalDate.of(2018, 10, 18);
    System.out.println("The specil date is : " + dateOfBirth);
}

结果：

The specil date is : 2018-10-18

（4）判断两个日期是否相等

LocalDate 重载了equal方法。注意，如果比较的日期是字符型的，需要先解析成日期对象再作判断。

public static void main(String[] args) {
    LocalDate today = LocalDate.now();
     LocalDate date1 = LocalDate.of(2020, 07, 07);

    if(date1.equals(today)){
        System.out.printf("TODAY %s and DATE1 %s are same date %n", today, date1);
    }    
}

结果：

TODAY 2020-07-07 and DATE1 2020-07-07 are same date 

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

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

public static void main(String[] args) {
    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");
    }
}

结果：

Sorry, today is not your birthday

（6）获取当前时间

与 获取日期 例子很像，获取时间使用的是 LocalTime 类，一个只有时间没有日期的LocalDate近亲。可以调用静态工厂方法now()来获取当前时间。默认的格式是hh:mm:ss:nnn。

public static void main(String[] args) {
    LocalTime time = LocalTime.now();
    System.out.println("local time now : " + time);
}      

结果：

local time now : 17:28:32.772

（7）在现有的时间上增加或减少

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

public static void main(String[] args) {
    LocalTime time = LocalTime.now();
    LocalTime newTime = time.plusHours(2); // 增加两小时
    System.out.println("Time after 2 hours : " +  newTime);
    LocalTime newTime2 = time.plusMinutes(20); // 增加20分钟
    System.out.println("Time after 20 Minutes : " +  newTime2);
    LocalTime newTime3 = time.plusSeconds(30); // 增加30秒
    System.out.println("Time after 30 Seconds : " +  newTime3);     
    LocalTime newTime4 = time.minusHours(2); // 减少两小时
    System.out.println("Time before 2 hours : " +  newTime4);
}

结果：

Time after 2 hours : 20:47:51.994
Time after 20 Minutes : 19:07:51.994
Time after 30 Seconds : 18:48:21.994
Time after 30 Seconds : 16:47:51.994

（8）在现有的日期上增加或减少

和上个例子计算两小时以后的时间类似，这个例子会计算一周后的日期。

LocalDate日期不包含时间信息，它的plus()方法用来增加天、周、月，ChronoUnit类声明了这些时间单位。由于LocalDate也是不变类型，返回后一定要用变量赋值。

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

public static void main(String[] args) {
    LocalDate today = LocalDate.now();
    LocalDate nextWeek = today.plus(1, ChronoUnit.WEEKS);    //使用变量赋值
    LocalDate nextMonth = today.plus(1, ChronoUnit.MONTHS);
    LocalDate beforMonth = today.minus(1, ChronoUnit.MONTHS);
    System.out.println("Today is : " + today);
    System.out.println("Date after 1 week : " + nextWeek);
    System.out.println("Date after 1 month : " + nextMonth);
    System.out.println("Date before 1 month : " + beforMonth);
}

结果：

Today is : 2020-07-07
Date after 1 week : 2020-07-14
Date after 1 month : 2020-08-07
Date before 1 month : 2020-06-07

（9）判断日期是早于还是晚于另一个日期

LocalDate 类有两类方法 isBefore() 和 isAfter() 用于比较日期。调用 isBefore() 方法时，如果给定日期小于当前日期则返回 true。

public static void main(String[] args) {
    LocalDate today = LocalDate.now();
    LocalDate tomorrow = today.plus(1, ChronoUnit.DAYS);
    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");
    }    
}

结果：

Tomorrow comes after today
Yesterday is day before today

（10）如何体现出固定日期

与 MonthDay 检查重复事件的例子相似，YearMonth 是另一个组合类，用于表示信用卡到期日、FD到期日、期货期权到期日等。还可以用这个类得到 当月共有多少天，YearMonth 实例的 lengthOfMonth() 方法可以返回当月的天数，在判断2月有28天还是29天时非常有用。

public static void main(String[] args) {
    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);
}

结果：

Days in month year 2020-07: 31
Your credit card expires on 2028-02 

（11）检查闰年

LocalDate类有一个很实用的方法 isLeapYear() 判断该实例是否是一个闰年，如果你还是想重新发明轮子，这有一个代码示例，纯Java逻辑编写的判断闰年的程序。

public static void main(String[] args) {
    LocalDate today = LocalDate.now();
    if(today.isLeapYear()){
        System.out.println("This year is Leap year");
    }else {
        System.out.println("2020 is not a Leap year");
    }
}

结果：

This year is Leap year

（12）计算两个日期之间的天数与月数

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

public static void main(String[] args) {
    LocalDate today = LocalDate.now();
    LocalDate java8Release = LocalDate.of(2019, Month.AUGUST, 14);
    Period periodToNextJavaRelease = Period.between(today, java8Release);
    System.out.println("Months left between today and Java 8 release : "
                                               + periodToNextJavaRelease.getMonths() );
}

结果：

Months left between today and Java 8 release : -10

（13）包含时差信息的日期和时间

ZoneOffset类用来表示时区，举例来说印度与GMT或UTC标准时区相差+05:30，可以通过ZoneOffset.of()静态方法来 获取对应的时区。一旦得到了时差就可以通过传入LocalDateTime和ZoneOffset来创建一个OffSetDateTime对象。

public static void main(String[] args) {
    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);
}

结果：

Date and Time with timezone offset in Java : 2018-02-14T19:30+05:30

（14）获取当前时间戳

Instant类有一个静态工厂方法now()会返回当前的时间戳，如下所示：

public static void main(String[] args) {
    Instant timestamp = Instant.now();
    System.out.println("What is value of this instant " + timestamp);
}

结果：

What is value of this instant 2020-07-07T11:19:18.689Z

（15）使用预定义的格式化工具去解析或格式化日期

Java 8引入了全新的日期时间格式工具，线程安全而且使用方便。它自带了一些常用的内置格式化工具。详细请见DateTImeFormatter类。

public static void main(String[] args) {
    ZonedDateTime  zdt = ZonedDateTime .now();
    System.out.println("now:"+zdt);
    DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
    DateTimeFormatter formatter2 = DateTimeFormatter.ofPattern("yyyy-MM-dd");
    System.out.println(formatter.format(zdt));
    System.out.println(formatter2.format(zdt));
        
    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);
}

结果：

now:2020-07-07T19:23:57.908+08:00[Asia/Shanghai]
2020-07-07 19:23:57
2020-07-07
Date generated from String 20180210 is 2018-02-10