关于java:干掉DateJava8-LocalDate-真香

简介

随同 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。