当你开始使用Java操作日期和时间的时候，会有一些棘手。你也许会通过System.currentTimeMillis() 来返回1970年1月1日到今天的毫秒数。或者使用Date类来操作日期；当遇到加减月份、天数的时候 你又需要用到Calendar类；当需要格式化日期的时候需要使用java.text.DateFormat类。 总而言之在Java中操作日期不是很方便，以至于很多开发者不得不使用第三方库，比如: joda-time。

现有API存在的问题

• 线程安全: Date和Calendar不是线程安全的，你需要编写额外的代码处理线程安全问题
• API设计和易用性: 由于Date和Calendar的设计不当你无法完成日常的日期操作
• ZonedDate和Time: 你必须编写额外的逻辑处理时区和那些旧的逻辑
  

好在JSR 310规范中为Java8添加了新的API， 在java.time包中，新的API纠正了过去的缺陷，

新的日期API

• ZoneId: 时区ID，用来确定Instant和LocalDateTime互相转换的规则
• Instant: 用来表示时间线上的一个点
• LocalDate: 表示没有时区的日期, LocalDate是不可变并且线程安全的
• LocalTime: 表示没有时区的时间, LocalTime是不可变并且线程安全的
• LocalDateTime: 表示没有时区的日期时间, LocalDateTime是不可变并且线程安全的
• Clock: 用于访问当前时刻、日期、时间，用到时区
• Duration: 用秒和纳秒表示时间的数量
  

最常用的就是LocalDate、LocalTime、LocalDateTime了，从它们的名字就可以看出是操作日期 和时间的。这些类是主要用于当时区不需要显式地指定的上下文。在本章节中我们将讨论最常用的api。

LocalDate

LocalDate代表一个IOS格式(yyyy-MM-dd)的日期，可以存储 生日、纪念日等日期。 获取当前的日期：

[Java] 纯文本查看 复制代码

LocalDate localDate = LocalDate.now();
System.out.println("localDate: " + localDate);
localDate: 2017-07-20

LocalDate可以指定特定的日期，调用of或parse方法返回该实例：

[Java] 纯文本查看 复制代码

LocalDate.of(2017, 07, 20);
LocalDate.parse("2017-07-20");[/mw_[/align][align=left][color=rgb(0, 0, 0)][font="]当然它还有一些其他方法，我们一起来看看：[/font][/color][/align][align=left][color=rgb(0, 0, 0)][font="]为今天添加一天，也就是获取明天[/font][/color][/align][align=left][color=rgb(0, 0, 0)][font="][mw_shl_code=java,true]LocalDate tomorrow = LocalDate.now().plusDays(1);

从今天减去一个月

[Java] 纯文本查看 复制代码

LocalDate prevMonth = LocalDate.now().minus(1, ChronoUnit.MONTHS);

下面写两个例子，分别解析日期 2017-07-20，获取每周中的星期和每月中的日：

[Java] 纯文本查看 复制代码

DayOfWeek thursday = LocalDate.parse("2017-07-20").getDayOfWeek();
System.out.println("周四: " + thursday);
int twenty = LocalDate.parse("2017-07-20").getDayOfMonth();
System.out.println("twenty: " + twenty);

试试今年是不是闰年:

[Java] 纯文本查看 复制代码

boolean leapYear = LocalDate.now().isLeapYear();
System.out.println("是否闰年: " + leapYear);

判断是否在日期之前或之后:

[Java] 纯文本查看 复制代码

boolean notBefore = LocalDate.parse("2017-07-20")
                .isBefore(LocalDate.parse("2017-07-22"));
System.out.println("notBefore: " + notBefore);
boolean isAfter = LocalDate.parse("2017-07-20").isAfter(LocalDate.parse("2017-07-22"));
System.out.println("isAfter: " + isAfter);

获取这个月的第一天:

[Java] 纯文本查看 复制代码

LocalDate firstDayOfMonth = LocalDate.parse("2017-07-20")
                .with(TemporalAdjusters.firstDayOfMonth());
System.out.println("这个月的第一天: " + firstDayOfMonth);
firstDayOfMonth = firstDayOfMonth.withDayOfMonth(1);
System.out.println("这个月的第一天: " + firstDayOfMonth);

判断今天是否是我的生日，例如我的生日是 2009-07-20

[Java] 纯文本查看 复制代码

LocalDate birthday = LocalDate.of(2009, 07, 20);
MonthDay birthdayMd = MonthDay.of(birthday.getMonth(), birthday.getDayOfMonth());
MonthDay today = MonthDay.from(LocalDate.now());
System.out.println("今天是否是我的生日: " + today.equals(birthdayMd));

LocalTime

LocalTime表示一个时间，而不是日期，下面介绍一下它的使用方法。

获取现在的时间，输出15:01:22.144

[Java] 纯文本查看 复制代码

LocalTime now = LocalTime.now();
System.out.println("现在的时间: " + now);

将一个字符串时间解析为LocalTime，输出15:02

[Java] 纯文本查看 复制代码

LocalTime nowTime = LocalTime.parse("15:02");
System.out.println("时间是: " + nowTime);

使用静态方法of创建一个时间

[Java] 纯文本查看 复制代码

LocalTime nowTime = LocalTime.of(15, 02);
System.out.println("时间是: " + nowTime);

使用解析字符串的方式并添加一小时，输出16:02

[Java] 纯文本查看 复制代码

LocalTime nextHour = LocalTime.parse("15:02").plus(1, ChronoUnit.HOURS);
System.out.println("下一个小时: " + nextHour);

获取时间的小时、分钟

[Java] 纯文本查看 复制代码

int hour = LocalTime.parse("15:02").getHour();
System.out.println("小时: " + hour);
int minute = LocalTime.parse("15:02").getMinute();
System.out.println("分钟: " + minute);

我们也可以通过之前类似的API检查一个时间是否在另一个时间之前、之后

[Java] 纯文本查看 复制代码

boolean isBefore = LocalTime.parse("15:02").isBefore(LocalTime.parse("16:02"));
boolean isAfter = LocalTime.parse("15:02").isAfter(LocalTime.parse("16:02"));
System.out.println("isBefore: " + isBefore);
System.out.println("isAfter: " + isAfter);

输出 isBefore: true, isAfter: false。

在LocalTime类中也将每天的开始和结束作为常量供我们使用:

[AppleScript] 纯文本查看 复制代码

System.out.println(LocalTime.MAX);
System.out.println(LocalTime.MIN);

输出:

[Java] 纯文本查看 复制代码

23:59:59.999999999
00:00

LocalTime就这些了，下面我们来了解一下LocalDateTime

LocalDateTime

LocalDateTime是用来表示日期和时间的，这是一个最常用的类之一。

获取当前的日期和时间:

[Java] 纯文本查看 复制代码

LocalDateTime now = LocalDateTime.now();
System.out.println("现在: " + now);

输出

[Java] 纯文本查看 复制代码

现在: 2017-07-20T15:17:19.926

下面使用静态方法和字符串的方式分别创建LocalDateTime对象

[Java] 纯文本查看 复制代码

LocalDateTime.of(2017, Month.JULY, 20, 15, 18);
LocalDateTime.parse("2017-07-20T15:18:00");
``
同时`LocalDateTime`也提供了相关API来对日期和时间进行增减操作:
```java
LocalDateTime tomorrow = now.plusDays(1);
System.out.println("明天的这个时间: " + tomorrow);
LocalDateTime minusTowHour = now.minusHours(2);
System.out.println("两小时前: " + minusTowHour);

[Java] 纯文本查看 复制代码

这个类也提供一系列的get方法来获取特定单位:

[Java] 纯文本查看 复制代码

Month month = now.getMonth();
System.out.println("当前月份: " + month);

日期格式化

在日常开发中我们用到最多的也许就是日期、时间的格式化了，那在Java8种该如何操作呢？

[Java] 纯文本查看 复制代码

LocalDateTime now = LocalDateTime.now();
DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
System.out.println("默认格式化: " + now);
System.out.println("自定义格式化: " + now.format(dateTimeFormatter));
LocalDateTime localDateTime = LocalDateTime.parse("2017-07-20 15:27:44", dateTimeFormatter);
System.out.println("字符串转LocalDateTime: " + localDateTime);

也可以使用DateTimeFormatter的format方法将日期、时间格式化为字符串

[Java] 纯文本查看 复制代码

DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd");
String dateString = dateTimeFormatter.format(LocalDate.now());
System.out.println("日期转字符串: " + dateString);

日期周期

Period类用于修改给定日期或获得的两个日期之间的区别。

给初始化的日期添加5天:

[Java] 纯文本查看 复制代码

LocalDate initialDate = LocalDate.parse("2017-07-20");
LocalDate finalDate = initialDate.plus(Period.ofDays(5));
System.out.println("初始化日期: " + initialDate);
System.out.println("加日期之后: " + finalDate);

周期API中提供给我们可以比较两个日期的差别，像下面这样获取差距天数:

[Java] 纯文本查看 复制代码

long between = ChronoUnit.DAYS.between(initialDate, finalDate);
System.out.println("差距天数: " + between);

上面的代码会返回5，当然你想获取两个日期相差多少小时也是简单的。

与遗留代码转换

在之前的代码中你可能出现了大量的Date类，如何将它转换为Java8种的时间类呢？

Date和Instant互相转换

[Java] 纯文本查看 复制代码

Date date = Date.from(Instant.now());
Instant instant = date.toInstant();

Date转换为LocalDateTime

[Java] 纯文本查看 复制代码

LocalDateTime localDateTime = LocalDateTime.from(new Date());
System.out.println(localDateTime);

LocalDateTime转Date

[Java] 纯文本查看 复制代码

Date date =
Date.from(localDateTime.atZone(ZoneId.systemDefault()).toInstant());

LocalDate转Date

[Java] 纯文本查看 复制代码

Date date =
Date.from(LocalDate.now().atStartOfDay().atZone(ZoneId.systemDefault()).toInstant()

节选自ImportNew

当你开始使用Java操作日期和时间的时候，会有一些棘手。你也许会通过System.currentTimeMillis() 来返回1970年1月1日到今天的毫秒数。或者使用Date类来操作日期；当遇到加减月份、天数的时候 你又需要用到Calendar类；当需要格式化日期的时候需要使用java.text.DateFormat类。 总而言之在Java中操作日期不是很方便，以至于很多开发者不得不使用第三方库，比如: joda-time。

现有API存在的问题

• 线程安全: Date和Calendar不是线程安全的，你需要编写额外的代码处理线程安全问题
• API设计和易用性: 由于Date和Calendar的设计不当你无法完成日常的日期操作
• ZonedDate和Time: 你必须编写额外的逻辑处理时区和那些旧的逻辑
  

好在JSR 310规范中为Java8添加了新的API， 在java.time包中，新的API纠正了过去的缺陷，

新的日期API

• ZoneId: 时区ID，用来确定Instant和LocalDateTime互相转换的规则
• Instant: 用来表示时间线上的一个点
• LocalDate: 表示没有时区的日期, LocalDate是不可变并且线程安全的
• LocalTime: 表示没有时区的时间, LocalTime是不可变并且线程安全的
• LocalDateTime: 表示没有时区的日期时间, LocalDateTime是不可变并且线程安全的
• Clock: 用于访问当前时刻、日期、时间，用到时区
• Duration: 用秒和纳秒表示时间的数量
  

最常用的就是LocalDate、LocalTime、LocalDateTime了，从它们的名字就可以看出是操作日期 和时间的。这些类是主要用于当时区不需要显式地指定的上下文。在本章节中我们将讨论最常用的api。

LocalDate

LocalDate代表一个IOS格式(yyyy-MM-dd)的日期，可以存储 生日、纪念日等日期。 获取当前的日期：

[Java] 纯文本查看 复制代码

LocalDate localDate = LocalDate.now();
System.out.println("localDate: " + localDate);
localDate: 2017-07-20

LocalDate可以指定特定的日期，调用of或parse方法返回该实例：

[Java] 纯文本查看 复制代码

LocalDate.of(2017, 07, 20);
LocalDate.parse("2017-07-20");[/mw_[/align][align=left][color=rgb(0, 0, 0)][font="]当然它还有一些其他方法，我们一起来看看：[/font][/color][/align][align=left][color=rgb(0, 0, 0)][font="]为今天添加一天，也就是获取明天[/font][/color][/align][align=left][color=rgb(0, 0, 0)][font="][mw_shl_code=java,true]LocalDate tomorrow = LocalDate.now().plusDays(1);

从今天减去一个月

[Java] 纯文本查看 复制代码

LocalDate prevMonth = LocalDate.now().minus(1, ChronoUnit.MONTHS);

下面写两个例子，分别解析日期 2017-07-20，获取每周中的星期和每月中的日：

[Java] 纯文本查看 复制代码

DayOfWeek thursday = LocalDate.parse("2017-07-20").getDayOfWeek();
System.out.println("周四: " + thursday);
int twenty = LocalDate.parse("2017-07-20").getDayOfMonth();
System.out.println("twenty: " + twenty);

试试今年是不是闰年:

[Java] 纯文本查看 复制代码

boolean leapYear = LocalDate.now().isLeapYear();
System.out.println("是否闰年: " + leapYear);

判断是否在日期之前或之后:

[Java] 纯文本查看 复制代码

boolean notBefore = LocalDate.parse("2017-07-20")
                .isBefore(LocalDate.parse("2017-07-22"));
System.out.println("notBefore: " + notBefore);
boolean isAfter = LocalDate.parse("2017-07-20").isAfter(LocalDate.parse("2017-07-22"));
System.out.println("isAfter: " + isAfter);

获取这个月的第一天:

[Java] 纯文本查看 复制代码

LocalDate firstDayOfMonth = LocalDate.parse("2017-07-20")
                .with(TemporalAdjusters.firstDayOfMonth());
System.out.println("这个月的第一天: " + firstDayOfMonth);
firstDayOfMonth = firstDayOfMonth.withDayOfMonth(1);
System.out.println("这个月的第一天: " + firstDayOfMonth);

判断今天是否是我的生日，例如我的生日是 2009-07-20

[Java] 纯文本查看 复制代码

LocalDate birthday = LocalDate.of(2009, 07, 20);
MonthDay birthdayMd = MonthDay.of(birthday.getMonth(), birthday.getDayOfMonth());
MonthDay today = MonthDay.from(LocalDate.now());
System.out.println("今天是否是我的生日: " + today.equals(birthdayMd));

LocalTime

LocalTime表示一个时间，而不是日期，下面介绍一下它的使用方法。

获取现在的时间，输出15:01:22.144

[Java] 纯文本查看 复制代码

LocalTime now = LocalTime.now();
System.out.println("现在的时间: " + now);

将一个字符串时间解析为LocalTime，输出15:02

[Java] 纯文本查看 复制代码

LocalTime nowTime = LocalTime.parse("15:02");
System.out.println("时间是: " + nowTime);

使用静态方法of创建一个时间

[Java] 纯文本查看 复制代码

LocalTime nowTime = LocalTime.of(15, 02);
System.out.println("时间是: " + nowTime);

使用解析字符串的方式并添加一小时，输出16:02

[Java] 纯文本查看 复制代码

LocalTime nextHour = LocalTime.parse("15:02").plus(1, ChronoUnit.HOURS);
System.out.println("下一个小时: " + nextHour);

获取时间的小时、分钟

[Java] 纯文本查看 复制代码

int hour = LocalTime.parse("15:02").getHour();
System.out.println("小时: " + hour);
int minute = LocalTime.parse("15:02").getMinute();
System.out.println("分钟: " + minute);

我们也可以通过之前类似的API检查一个时间是否在另一个时间之前、之后

[Java] 纯文本查看 复制代码

boolean isBefore = LocalTime.parse("15:02").isBefore(LocalTime.parse("16:02"));
boolean isAfter = LocalTime.parse("15:02").isAfter(LocalTime.parse("16:02"));
System.out.println("isBefore: " + isBefore);
System.out.println("isAfter: " + isAfter);

输出 isBefore: true, isAfter: false。

在LocalTime类中也将每天的开始和结束作为常量供我们使用:

[AppleScript] 纯文本查看 复制代码

System.out.println(LocalTime.MAX);
System.out.println(LocalTime.MIN);

输出:

[Java] 纯文本查看 复制代码

23:59:59.999999999
00:00

LocalTime就这些了，下面我们来了解一下LocalDateTime

LocalDateTime

LocalDateTime是用来表示日期和时间的，这是一个最常用的类之一。

获取当前的日期和时间:

[Java] 纯文本查看 复制代码

LocalDateTime now = LocalDateTime.now();
System.out.println("现在: " + now);

输出

[Java] 纯文本查看 复制代码

现在: 2017-07-20T15:17:19.926

下面使用静态方法和字符串的方式分别创建LocalDateTime对象

[Java] 纯文本查看 复制代码

LocalDateTime.of(2017, Month.JULY, 20, 15, 18);
LocalDateTime.parse("2017-07-20T15:18:00");
``
同时`LocalDateTime`也提供了相关API来对日期和时间进行增减操作:
```java
LocalDateTime tomorrow = now.plusDays(1);
System.out.println("明天的这个时间: " + tomorrow);
LocalDateTime minusTowHour = now.minusHours(2);
System.out.println("两小时前: " + minusTowHour);

[Java] 纯文本查看 复制代码

这个类也提供一系列的get方法来获取特定单位:

[Java] 纯文本查看 复制代码

Month month = now.getMonth();
System.out.println("当前月份: " + month);

日期格式化

在日常开发中我们用到最多的也许就是日期、时间的格式化了，那在Java8种该如何操作呢？

[Java] 纯文本查看 复制代码

LocalDateTime now = LocalDateTime.now();
DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
System.out.println("默认格式化: " + now);
System.out.println("自定义格式化: " + now.format(dateTimeFormatter));
LocalDateTime localDateTime = LocalDateTime.parse("2017-07-20 15:27:44", dateTimeFormatter);
System.out.println("字符串转LocalDateTime: " + localDateTime);

也可以使用DateTimeFormatter的format方法将日期、时间格式化为字符串

[Java] 纯文本查看 复制代码

DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd");
String dateString = dateTimeFormatter.format(LocalDate.now());
System.out.println("日期转字符串: " + dateString);

日期周期

Period类用于修改给定日期或获得的两个日期之间的区别。

给初始化的日期添加5天:

[Java] 纯文本查看 复制代码

LocalDate initialDate = LocalDate.parse("2017-07-20");
LocalDate finalDate = initialDate.plus(Period.ofDays(5));
System.out.println("初始化日期: " + initialDate);
System.out.println("加日期之后: " + finalDate);

周期API中提供给我们可以比较两个日期的差别，像下面这样获取差距天数:

[Java] 纯文本查看 复制代码

long between = ChronoUnit.DAYS.between(initialDate, finalDate);
System.out.println("差距天数: " + between);

上面的代码会返回5，当然你想获取两个日期相差多少小时也是简单的。

与遗留代码转换

在之前的代码中你可能出现了大量的Date类，如何将它转换为Java8种的时间类呢？

Date和Instant互相转换

[Java] 纯文本查看 复制代码

Date date = Date.from(Instant.now());
Instant instant = date.toInstant();

Date转换为LocalDateTime

[Java] 纯文本查看 复制代码

LocalDateTime localDateTime = LocalDateTime.from(new Date());
System.out.println(localDateTime);

LocalDateTime转Date

[Java] 纯文本查看 复制代码

Date date =
Date.from(localDateTime.atZone(ZoneId.systemDefault()).toInstant());

LocalDate转Date

[Java] 纯文本查看 复制代码

Date date =
Date.from(LocalDate.now().atStartOfDay().atZone(ZoneId.systemDefault()).toInstant()

节选自ImportNew