Java高级编程--JDK8新增的日期时间API
在开发过程中我们常常会碰到要处理时间的需求，前篇介绍了JDK8之前的日期时间API的使用，但是这些API中有很多方法都已经过时了，不再适用或效率不高，难以适应现在的需求，本篇博客将介绍在JDK8中新增的日期时间API的使用...
在开发过程中我们常常会碰到要处理时间的需求，前篇介绍了JDK8之前的日期时间API的使用，但是这些API中有很多方法都已经过时了，不再适用或效率不高，难以适应现在的需求，本篇博客将介绍在JDK8中新增的日期时间API的使用。
JDK8之前的日期时间API↷传送门
目录：
☍ LocalDate、LocalTime、LocalDateTime类
新日期时间API背景：
JDK 1.0中包含了一个java.util.Date类，但是它的大多数方法已经在JDK 1.1引入Calendar类之后被弃用了。而Calendar并不比Date好多少。它们面临的问题是：
☃ 可变性：对原对象的操作会导致对象发生变化，像日期和时间这样的类应该是不可变的，应该是操作后返回新的对象。
☃ 偏移性：Date中的年份是从1900开始的，而月份都从0开始。
☃ SimpleDateTime格式化只对Date有用，Calendar则不行。
☃ 此外，它们也不是线程安全的；不能处理闰秒等。
Java 8中引入的java.time API 已经纠正了
过去的缺陷，将来很长一段时间内它都会为我们服务。
新的 java.time 中包含了所有关于本地日期（LocalDate）、本地时间（LocalTime）、本地日期时间（LocalDateTime）、时区（ZonedDateTime）和持续时间（Duration）的类。
▾ LocalDate、LocalTime、LocalDateTime类
LocalDate、LocalTime、LocalDateTime 类是其中较重要的几个类，它们的实例
是不可变的对象，分别表示使用 ISO-8601日历系统的日期、时间、日期和时间。
它们提供了简单的本地日期或时间，不包含与时区
相关的信息。
➣ LocalDate代表IOS格式（yyyy-MM-dd）的日期：如：2020-06-16
➣ LocalTime表示一个时间，而不是日期，如：08:05:58.464
➣ LocalDateTime是用来表示日期和时间的，这是一个最常用的类之一，如：2020-06-16T08:05:58.464
注：ISO-8601日历系统是国际标准化组织制定的现代公民的日期和时间的表示
法，也就是公历
常用方法：
/**
* 描述:JDK8中的日期相关API的使用
* 1、LocalDateTime类相较于LocalDte和LocalTime使用的多一些 (具有类似String的不变性，不改变原对象，返回新的信息)
* LocalDateTime.now(); 获取当前日期/时间的方法
* of(x,y...); 设置日期时间信息
* getXxx(); 获取指定信息内容，如年、月、日等
* withXxx(value):设置日期时间信息的某个属性，如设置日，设置小时等
* plusXxx(value):增加某个属性的值，负数为减 返回新的对象
*/
public void testLocalDateTimeAPI1(){
/*now()方法，获取当前日期时间信息*/
System.out.println("-----------now()方法---------");
LocalDate localDate = LocalDate.now(); //获取当前日期
LocalTime localTime = LocalTime.now(); //获取当前时间
LocalDateTime localDateTime = LocalDateTime.now(); //获取当前日期+时间
System.out.println("LocalDate:" + localDate); //LocalDate:2020-06-16
System.out.println("LocalTime:" + localTime); //LocalTime:08:05:58.464
System.out.println("localDateTime:" + localDateTime); //localDateTime:2020-06-16T08:05:58.464
/*of(x,y...)方法，设置日期时间信息 不变性*/
System.out.println("-----------of()方法---------");
LocalDateTime localDateTime1 = LocalDateTime.of(2016,9,01,12,20,18,256);
System.out.println(localDateTime); //2020-06-16T08:05:58.464
System.out.println(localDateTime1); //2016-09-01T12:20:18.000000256
/*getXxx()方法，获取指定信息内容，如年月日等*/
System.out.println("-----------getXxx()方法---------");
int year = localDate.getYear();
int month = localDate.getMonthValue();
int day = localDateTime.getDayOfMonth();
int hour = localTime.getHour();
System.out.println("当前日期：" + year + "-" + month + "-" + day + " " + hour + ":"+localTime.getMinute()+":"+localTime.getSecond());
//当前日期：2020-6-16 8:5:58
/*withXxx(value):设置日期时间信息的某个属性，如设置日，设置小时等*/
//体现LocalDate,LocalTime,LocalDateTime的不可变性
System.out.println("-----------withXxx()方法---------");
LocalDateTime localDateTime2 = localDateTime.withDayOfMonth(8);
System.out.println(localDateTime1); //2016-09-01T12:20:18.000000256
System.out.println(localDateTime2); //2020-06-08T08:05:58.464
/*plusXxx(value):增加某个属性的值，负数为减 返回新的对象*/
System.out.println("-----------plusXxx(value)方法---------");
LocalDateTime localDateTime3 = localDateTime2.plusYears(1);
System.out.println(localDateTime3); //2021-06-08T08:05:58.464
/*minusXxx(value):减少某个属性的值，负数为加 返回新的对象*/
System.out.println("-----------minusXxx(value)方法---------");
LocalDateTime localDateTime4 = localDateTime2.minusYears(1);
System.out.println(localDateTime4); //2019-06-08T08:05:58.464
}
▾ Instant瞬时类
☃ Instant：时间线上的一个瞬时点。 这可以被用来记录应用程序中的事件时间戳。
☃ Instant表示时间线上的一点，而不需要任何上下文信息，例如，时区。
概念上讲，它只是简单的表示自1970年1月1日0时0分0秒（UTC）开始的秒
数。
☃ java.time包是基于纳秒计算的，所以Instant的精度可以达到纳秒级。
✦ 1秒 = 1000毫秒 =10^6 微秒=10^9 纳秒
✦ 时间戳是指格林威治时间1970年01月01日 00时00分00秒( 北京时间1970年01月01日08时00分00秒)起至现在的总秒数。
public void testInstant(){
Instant instant = Instant.now(); //获取本初子午线对应的标准时间
System.out.println(instant); //2020-06-13T11:16:44.956Z 和中国时区差将近8小时
//2020-06-16T00:33:23.768Z
//处理为中国时区:东8区
OffsetDateTime offsetDateTime = instant.atOffset(ZoneOffset.ofHours(8));
System.out.println(offsetDateTime); //2020-06-16T08:33:23.768+08:00
//获取毫秒数 从1970-01-01 00：00：00开始
Long millis = instant.toEpochMilli();
System.out.println(millis); //1592267603768
System.out.println(new Date().getTime()); //1592267603898
//将毫秒数转为Instant对象
Instant instant1 = Instant.ofEpochMilli(1592267462055L);
System.out.println(instant1.toEpochMilli()); //1592267462055
//Date --> Instant
Instant instant2 = new Date().toInstant();
System.out.println(instant2); //2020-06-16T00:33:23.898Z
//Instant --> Date 通过毫秒数
//LocalDateTime --> Instant
}
▾ DateTimeFormat格式化与解析类
DateTimeFormat类格式化方法：
➣ 预定义的标准格式。如：
ISO_LOCAL_DATE_TIME;ISO_LOCAL_DATE;ISO_LOCAL_TIM，与LocalDateTime、LocalDate、LocalTime类对应
➣ 本地化相关的格式。如：ofLocalizedDateTime(FormatStyle.LONG)
➣ 自定义的格式。如：ofPattern(“yyyy-MM-dd hh:mm:ss”)
public void testDateTimeFormat(){
//方式一：预定义的标准格式 ISO_LOCAL_DATE_TIME对应LocalDateTime类格式; ISO_LOCAL_DATE对应LocalDate类格式; ISO_LOCAL_TIME对应LocalTime类格式
DateTimeFormatter dtf = DateTimeFormatter.ISO_LOCAL_DATE;
//格式化：LocalDateTime/LocalDate/LocalTime --> 字符串
LocalDateTime localDateTime = LocalDateTime.now();
System.out.println("localDate:" + localDateTime); //localDate:2020-06-16T08:43:54.724
String timeStr1 = dtf.format(localDateTime);
System.out.println("timeStr1:" + timeStr1); //timeStr1:2020-06-16
//解析： 逆过程 字符串 --> TemporalAccessor抽象类
TemporalAccessor parse1 = dtf.parse(timeStr1);
System.out.println("parse1:"+parse1); //parse1:{},ISO resolved to 2020-06-16
//方式二：本地化相关的格式。
// 如：ofLocalizedDateTime()
// 参数：FormatStyle.LONG/FormatStyle.MEDIUM/FormatStyle.SHORT 适用于LocalDateTime
// 如：ofLocalizedDate()
// 参数：FormatStyleFULL/FormatStyle.LONG/FormatStyle.MEDIUM/FormatStyle.SHORT 适用于LocalDate
DateTimeFormatter formatter1 = DateTimeFormatter.ofLocalizedDateTime(FormatStyle.LONG);
//格式化
String timeStr2 = formatter1.format(localDateTime);
System.out.println("timeStr2:"+timeStr2); //timeStr2:2020年6月16日 上午08时43分54秒
//方式三：自定义格式化格式
DateTimeFormatter formatter2 = DateTimeFormatter.ofPattern("yyyy-MM--dd a HH:mm:ss");
//格式化
String timeStr3 = formatter2.format(LocalDateTime.now());
System.out.println("timeStr3:" + timeStr3); //timeStr3:2020-06--16 上午 08:43:54
//解析
TemporalAccessor parse2 = formatter2.parse(timeStr3);
//TemporalAccessor --> LocalXxx
LocalDateTime localDateTime1 = LocalDateTime.from(parse2);
System.out.println("parse2:"+localDateTime1); //parse2:2020-06-16T08:43:54
//直接转化字符串，parse(CharSequence text) 或 parse(CharSequence text, DateTimeFormatter formatter）
LocalDate localDate = LocalDate.parse("2020-06-13");
System.out.println("localDate:"+localDate); //localDate:2020-06-13
LocalDate localDate1 = LocalDate.parse("2020-06-13",DateTimeFormatter.ofPattern("yyyy-MM-dd"));
System.out.println("localDate1:" + localDate1); //localDate1:2020-06-13
}
▾ 其他日期API
✦ 此部分了解即可，用的时候知道有这些API就行。
☄ ZoneId：该类中包含了所有的时区信息，一个时区的ID，如 Europe/Paris
☄ ZonedDateTime：一个在ISO-8601日历系统时区的日期时间，如 2007-12-03T10:15:30+01:00 Europe/Paris
➣ 其中每个时区都对应着ID，地区ID都为“{区域}/{城市}”的格式，例如：
Asia/Shanghai等
☄ Clock：使用时区提供对当前即时、日期和时间的访问的时钟
☄ 日期间隔：Period，用于计算两个“日期”间隔
☄ TemporalAdjuster : 时间校正器。有时我们可能需要获取例如：将日期调整到“下一个工作日”等操作。
☄ TemporalAdjusters : 该类通过静态方法(firstDayOfXxx()/lastDayOfXxx()/nextXxx())提供了大量的常用TemporalAdjuster 的实现。
public void otherTimeAPI(){
//Duration:用于计算两个“时间”间隔，以秒和纳秒为基准
System.out.println("-------Duration--------");
LocalTime localTime = LocalTime.now();
LocalTime localTime1 = LocalTime.of(8, 23, 32);
System.out.println(localTime + "+++++" + localTime1); //09:24:37.366+++++08:23:32
//between():静态方法，返回Duration对象，表示两个时间的间隔
Duration duration = Duration.between(localTime1, localTime);
//时间间隔对象Duration
System.out.println("duration:" + duration); //duration:PT1H1M5.366S
//将间隔对象转换为秒
System.out.println("duration.getSeconds():" + duration.getSeconds()); //duration.getSeconds():3665
//获取秒数小数点后的纳秒级数
System.out.println("duration.getNano():" + duration.getNano());
LocalDateTime localDateTime = LocalDateTime.of(2016, 6, 12, 15, 23, 32);
LocalDateTime localDateTime1 = LocalDateTime.of(2017, 6, 12, 15, 23, 32);
Duration duration1 = Duration.between(localDateTime, localDateTime1);
//time1-time2间隔天数
System.out.println("duration1.toDays():" + duration1.toDays()); //duration1.toDays():365
System.out.println();
//Period:用于计算两个“日期”间隔，以年、月、日衡量
System.out.println("-------Period--------");
LocalDate localDate = LocalDate.now();
LocalDate localDate1 = LocalDate.of(2028, 3, 18);
//period日期间隔类
Period period = Period.between(localDate, localDate1);
System.out.println("period:" + period);
//间隔年份
System.out.println("period.getYears():" + period.getYears());
//间隔月份
System.out.println("period.getMonths():" + period.getMonths());
//间隔日
System.out.println("period.getDays():" + period.getDays());
//使用withXxx()设置period对象
Period period1 = period.withYears(2);
System.out.println("period1:" + period1);
System.out.println();
//ZonedDateTime:带时区的日期时间
// ZonedDateTime的now():获取本时区的ZonedDateTime对象
System.out.println("------ZonedDateTime-------");
ZonedDateTime zonedDateTime = ZonedDateTime.now();
System.out.println(zonedDateTime);
// ZonedDateTime的now(ZoneId id):获取指定时区的ZonedDateTime对象
ZonedDateTime zonedDateTime1 = ZonedDateTime.now(ZoneId.of("Asia/Tokyo"));
System.out.println(zonedDateTime1);
System.out.println();
// TemporalAdjuster:时间校正器
// 获取当前日期的下一个周日是哪天？
System.out.println("--------TemporalAdjuster----------");
TemporalAdjuster temporalAdjuster = TemporalAdjusters.next(DayOfWeek.SUNDAY);
LocalDateTime localDateTime3 = LocalDateTime.now().with(temporalAdjuster);
System.out.println("下一个周日是："+localDateTime3);
// 获取下一个工作日是哪天？
LocalDate localDate4 = LocalDate.now().with(new TemporalAdjuster() {
@Override
public Temporal adjustInto(Temporal temporal) {
LocalDate date = (LocalDate) temporal;
if (date.getDayOfWeek().equals(DayOfWeek.FRIDAY)) {
return date.plusDays(3);
} else if (date.getDayOfWeek().equals(DayOfWeek.SATURDAY)) {
return date.plusDays(2);
} else {
return date.plusDays(1);
}
}
});
System.out.println("下一个工作日是：" + localDate4);
System.out.println();
//ZoneId:类中包含了所有的时区信息
// ZoneId的getAvailableZoneIds():获取所有的ZoneId
System.out.println("-------ZoneId--------");
Set<String> zoneIds = ZoneId.getAvailableZoneIds();
for (String s : zoneIds) {
System.out.println(s);
}
// ZoneId的of():获取指定时区的时间
LocalDateTime localDateTime2 = LocalDateTime.now(ZoneId.of("Asia/Tokyo"));
System.out.println(localDateTime2);
}
本博客与CSDN博客༺ཌ༈君☠纤༈ད༻同步发布
梦想是一场华美的旅途，每个人在找到它之前，都只是孤独的少年。
