时间API回顾
Java的日期时间API，一直有一些令人头疼的问题。
有了 java.util.Date 又搞出个java.sql.Date，改个名字不行？
好好的new Date(year,month,day) 早早的就被标记为 @Deprecated,那时候还是jdk1.1，如今都java9了，还没删除。
BTW，如果你还不知道为什么该方法被标记为弃用，请执行一下如下代码：
Date date =new Date(2017,5,1);
System.out.println(date);//Fri Jun 01 00:00:00 CST 3917
好吧，有一天又给了一个Calendar，每次一个操作，都感觉，IDE一行设置80个字符，是真不够。
我想搞个纯日期，那叫一个麻烦，相信很多人都这么写：
Calendar cal=Calendar.getInstance();
cal.set(Calendar.HOUR,0);
cal.set(Calendar.MINUTE,0);
cal.set(Calendar.SECOND,0);
Date date=cal.getTime();
心塞~
貌似看起来Calendar比Date好一点，但他继承了Date一个很恶心的特性，月份问题。
System.out.println(cal.getTime());//Fri Nov 17 12:00:00 CST 2017
System.out.println(cal.get(Calendar.MONTH));//10
JSR310
java8终于有了个改观，这就是JSR310.
JSR-310规范提供一个新的和改进的Java日期与时间API，该规范领导者Stephen Colebourne就是joda-time作者，因此很多环节很像joda-time。
java8 datetime api 带来了什么
旧时代的时间api，在java.util 包中，而JSR310的类都在 java.time 包中。
日期时间API将日期和时间分开为LocalDate和LocalTime;
既有日期又有时间，则使用 LocalDateTime;
改善了jdk的TimeZone，使用更优雅的ZoneId；
增加了 Instant 的概念，可以理解为时间线上的一个瞬间；
很重要的，jsr310类都是线程安全的。
瞬时时间
Temporal，这是一个接口，所有的时间点都实现了该接口。
LocalDate
//获取当前日期
LocalDate date1=LocalDate.now();
System.out.println(date1);
//获取指定日期
LocalDate date2=LocalDate.of(2017, 12, 24);
System.out.println(date2);
//获取当月第一天日期
LocalDate minus = date1.minus(date1.getDayOfMonth()-1,ChronoUnit.DAYS);
System.out.println(minus);
//将日期的月份修改为指定值
date2.withMonfh(2);//2017-02-24
//格式化
DateTimeFormatter formatter=DateTimeFormatter.ofPattern("yyyy-MM");
System.out.println(date2.format(formatter));//2017-12
//获取某个时间单位
DayOfWeek weekday = date2.getDayOfWeek();
System.out.println(weekday.getValue());//SUNDAY
System.out.println(weekday);//7
System.out.println(date2.getDayOfMonth());//24
//也可以用通用的方法
System.out.println(date2.get(ChronoField.YEAR));//2017
LocalDate 与 Date 转换
//LocalDate -> Date
LocalDate localDate1=LocalDate.now();
ZoneId zoneId=ZoneId.systemDefault();
Instant instant=localDate1.atStartOfDay(zoneId).toInstant();
Date from = Date.from(instant);
System.out.println(from);
//Date 转 LocalDate
Date date2=new Date();
Instant instant = date2.toInstant();
ZoneId zoneId=ZoneId.systemDefault();
LocalDate localDate2 = instant.atZone(zoneId).toLocalDate();
System.out.println(localDate);
LocalTime
实际单纯使用时间的场景，并没有单纯使用日期的时间多。而且，LocalDate的思路捋清楚，LocalTime的使用大同小异。
LocalDateTime
结合了LocalDate 和 LocalTime,也就是传统意义上类似Date的时间。
LocalDate localDate = dt.toLocalDate();
LocalTime localTime = dt.toLocalTime();
很多方法和LocalDate是类似的，不再浪费篇幅。
LocalDateTime 与 Date
Date 转 LocalDateTime
Date date = new Date();
Instant instant = date.toInstant();
ZoneId zone = ZoneId.systemDefault();
LocalDateTime localDateTime = LocalDateTime.ofInstant(instant, zone);
# LocalDateTime 转 Date
LocalDateTime localDateTime = LocalDateTime.now();
ZoneId zone = ZoneId.systemDefault();
Instant instant = localDateTime.atZone(zone).toInstant();
Date date = Date.from(instant);
Instant
这是一个时间点，它是1970-01-01 以来的偏移量，它包含秒和纳秒。
Instant now = Instant.now();
//完整的时间戳
date.getEpochSecond()+"."+date.getNano()/1000/1000;
与之对应的旧的api类似于 System.currentTimeMillis()和 System.nanoTime()。或者可以参考其他语言的时间戳。
从前面的格式转换可以看出。
Date -> Instant -(ZoneId)-> LocalDate
用文字描述，就是 Date 可以转换为 Instant；Instant 可以借助ZoneId 转换为LocalDate。反之亦然。
Instant 和 LocalDateTime
Instant 和 LocalDateTime的区别在于，前者是时间线上的一个绝对时刻，而LocalDateTime是Instant在不同时区的一个时间表示，但它并没有保存时区。
其他几个不常用的瞬时时间
瞬时时间的实现很多，很多并不常用：
ZonedDateTime: 就是带了时区的LocalDateTime。 Year： 年。 YearMonth：只记录月。 MonthDay: 只记录月日。
说明一点，怎么获得这些类型，一般我们使用的多是完整的时间或日期，如LocalDateTime，而这些不常用的类型，大部分都是从LocalDateTime转换而来。
LocalDateTime d1=LocalDateTime.now();
YearMonth ym=YearMonth.from(d1);
// 当然也可以直接创建
ym=YearMonth.now();
格式化
作为SimpleDateFormat的替代品，使用 DateTimeFormatter。
创建 DateTimeFormatter
//使用內建的模式
DateTimeFormatter formater=DateTimeFormatter.ISO_DATE_TIME;
// 自定义模式
DateTimeFormatter formater=DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
//使用国际化样式，它的具体表现取决于默认的Locale
FormatStyle dateTimeStyle=FormatStyle.MEDIUM;
DateTimeFormatter formater=DateTimeFormatter.ofLocalizedDateTime(dateTimeStyle);
格式化
直接调用瞬时时间的format方法。
String format = d1.format(formater);
反过来，直接调用静态工厂方法parse解析时间：
// 标准的ISO8601时间格式
LocalDateTime.parse("2017-11-30T16:10:32");
// 非标准的时间格式
LocalDateTime parse = LocalDateTime.parse("2017-11-30 16:10:32",formater);
国际化测试
LocalDateTime d1=LocalDateTime.now();
FormatStyle dateTimeStyle=FormatStyle.LONG;
Locale.setDefault(Locale.CHINA);
DateTimeFormatter formater=DateTimeFormatter.ofLocalizedDateTime(dateTimeStyle);
String format = d1.format(formater);
System.out.println(format);//2017年11月30日 下午04时10分32秒
dateTimeStyle=FormatStyle.MEDIUM;
Locale.setDefault(Locale.CHINA);
formater=DateTimeFormatter.ofLocalizedDateTime(dateTimeStyle);
format = d1.format(formater);
System.out.println(format);//2017-11-30 16:10:32
Locale.setDefault(Locale.UK);
formater=DateTimeFormatter.ofLocalizedDateTime(dateTimeStyle);
format = d1.format(formater);
System.out.println(format);//30-Nov-2017 16:10:32
时区
ZoneId
它是根据名称来记忆时区的方式，如：Asia/Shanghai
ZoneId zoneId=ZoneId.systemDefault();
System.out.println(zoneId);
TimeZone tz=TimeZone.getDefault();
System.out.println(tz);
输出：
Asia/Shanghai
sun.util.calendar.ZoneInfo[id="Asia/Shanghai",offset=28800000,dstSavings=0,useDaylight=false,transitions=19,lastRule=null]
ZoneId忽略了哪些用处不大的信息，更清晰。如果必要的时候，可以在属性 zoneId.getRules() 中获取。
ZoneOffset
时区偏移，它是根据偏移量来记忆时区的方式,如：GMT+08:00
方法
jsr的api提供了很多很多的方法，但从字面上很容易知道他的作用。下面对方法分分类，他们都具有如下的方法前缀：
now： 获取当前时间，每一个瞬时时间都有此方法。
of：静态工厂方法。
parse：静态工厂方法，从字符串解析。
from: 静态工厂转换方法，从另一个时间取值创建对象。
until: 计算时间差
get*：获取某些东西的值。
is*：检查某些东西的是否是true。
with*：不可变的setter等价物。
plus*：加一些量到某个对象。
minus*：从某个对象减去一些量。
to*：转换到另一个类型。
at*：把这个对象与另一个对象组合起来，例如：instant.atZone(zoneId)。
时间单位
很多方法都会 TemporalUnit 类型的参数，而它只是一个接口，我们通常使用它的实现类 ChronoUnit 来枚举可用的单位。如：
ChronoUnit days = ChronoUnit.DAYS;
Chronology
历法，实现了常见一些历法。
Chronology c=IsoChronology.INSTANCE;
ChronoLocalDateTime d = c.localDateTime(LocalDateTime.now());
System.out.println(d);
//2017-11-29T21:40:05.902
其他实现的历法有：
//回历，伊斯兰历法
HijrahChronology.INSTANCE;
//日本历
JapaneseChronology.INSTANCE;
//民国历
MinguoChronology.INSTANCE;
//泰历，佛历
ThaiBuddhistChronology.INSTANCE;
Duration
表示一个时间段，时间粒度精确到秒。
它继承了 TemporalAmount 接口。
LocalDateTime d1 = LocalDateTime.of(2000, 1, 1, 7, 30, 10);
LocalDateTime d2 = LocalDateTime.of(2000, 1, 1, 7, 32, 0);
Duration duration = Duration.between(d1, d2);
System.out.println(duration);//PT1M50S 表示两个时间过去了1分钟50秒
除了两个时间计算，也可以使用时间量创建。
Duration duration=Duration.ofDays(3);
时间计算
在日期计算上，引入的joda-time特性，实在太方便了。
时间与量的计算
一个时间类型，与一个量的计算，计算结果仍是个时间。
如，计算一个时间对应的几天前，几小时后的时间。
如果要得到本月的第一天的日期，那么以前我们需要这么做。
Calendar cal=Calendar.getInstance();
cal.set(Calendar.HOUR,0);
cal.set(Calendar.MINUTE,0);
cal.set(Calendar.SECOND,0);
cal.set(Calendar.DAY_OF_MONTH,1);
System.out.println(cal.getTime());
现在呢？
LocalDate date=LocalDate.now().withDayOfMonth(1);
System.out.println(date);
如果我们希望计算当前时间的前一天的时刻，以前需要这么做：
Calendar cal=Calendar.getInstance();
cal.add(Calendar.DAY_OF_MONTH, -1);
现在呢？
LocalDateTime date=LocalDateTime.now().minusDays(1);
既简单，语义也更佳。支持链式语法，编码方便。
除此之外还可以通过一个时间量来计算，方法为：minus(TemporalAmount amountToSubtract)，典型的 TemporalAmount的实现就是 Duration.
LocalDateTime d1=LocalDateTime.now();
Duration duration=Duration.ofDays(3);
LocalDateTime d2=d1.minus(duration);
System.out.println(d2);
时间与时间的计算
两个时间之间的计算，结果为一个量。如，计算两个时间相隔多少天。
举例，计算2016年元旦到五一劳动节相隔多少天？
LocalDateTime d1=LocalDateTime.of(2016, 1, 1, 0, 0);
LocalDateTime d2=LocalDateTime.of(2016, 5, 1, 0, 0);
long interval = d1.until(d2, ChronoUnit.DAYS);
System.out.println(interval);
也可以使用时间量的计算：
Duration d=Duration.between(d1, d2);
System.out.println(d.toDays());
Clock
这是个好有意思的api，它代表一个时钟，什么意思？
举个栗子，如果我们每秒打印一下当前时间，你可能这样做：
while(true) {
Date date = new Date();
System.out.println(date);
Thread.sleep(1000);
}
就是说，每次都创建一个当前时间的对象，然后打印输出（或者渲染一个时钟）。
现在我们来看 Clock吧，它就是一个时钟，只是我们看不见。它的值不是一成不变的，而像一个真正的时钟，一直在 tick...tick... 的走。
Clock c=Clock.systemDefaultZone();
while(true) {
System.out.println(c.instant());
Thread.sleep(1000);
}
这就好比你戴了一块表，需要时间的时候，看一眼，就知道现在是什么时候了。而传统的方式，就好比你想知道几点了，问CPU，哥们，几点了？
当然，一般情况下，Clock我们就当做一个看不见的钟表，需要对应的数据时：
LocalDateTime now = LocalDateTime.now(clock);
每一个瞬时时间类都有该方法。
总结
-
关键知识点：瞬时时间、时间量、ZoneId、Clock，其他知识点，调方法就可以了。
-
JSR310 标准中的每一个时间对象，都是线程安全的。
-
每一个对象都没有公开的构造器，如果需要一个对象你首先想的不是
new,而是静态工厂方法:now、of、from。 -
请习惯链式语法。
-
月份不需要再减一了，切记。
-
如果你喜欢敲全类名，请在使用时间api时忘记
java.util和java.text，记住java.time。
