15、JDK 8 中的日期时间API

JDK 8 中的日期时间API

一、新的时间日期API

1、第三次引入的API是成功的， 并且Java 8中引入的java.time API 已经纠正了
过去的缺陷，将来很长一段时间内它都会为我们服务。

2、Java 8 吸收了 Joda-Time 的精华，以一个新的开始为 Java 创建优秀的 API。
新的 java.time 中包含了所有关于本地日期（LocalDate）、本地时间
（LocalTime）、本地日期时间（LocalDateTime）、时区（ZonedDateTime）
和持续时间（Duration）的类。历史悠久的 Date 类新增了 toInstant() 方法，
用于把 Date 转换成新的表示形式。这些新增的本地化时间日期 API 大大简
化了日期时间和本地化的管理。

二、新的时间日期API

1、java.time – 包含值对象的基础包

2、java.time.chrono – 提供对不同的日历系统的访问

3、java.time.format – 格式化和解析时间和日期

4、java.time.temporal – 包括底层框架和扩展特性

5、java.time.zone – 包含时区支持的类

三、LocalDate、 LocalTime、 LocalDateTime 类

1、LocalDate代表IOS格式（yyyy-MM-dd）的日期,可以存储 生日、纪念日等日期。

2、LocalTime表示一个时间，而不是日期。

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

import org.junit.Test;
import java.time.LocalDate;
import java.time.LocalTime;
import java.time.LocalDateTime;

public class LocalDateTimeTest {
    @Test
    public void test(){
        //now获取当前日期、时间、日期+时间
        LocalDate localDate = LocalDate.now();
        LocalTime localTime = LocalTime.now();
        LocalDateTime localDateTime = LocalDateTime.now();

//of：设置指定的年、月、日、时、分、秒（没有便宜量）
        LocalDateTime localDateTime1 = LocalDateTime.of(2020,11,13,10,10);
        System.out.println(localDateTime1);//2020-11-13T10:10
    }
}

常见方法

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-PEMcT2W1-1611074252100)(EF95F20C6D764405AFE0AFF2E70404AE)]

1、now获取当前日期、时间、日期+时
2、、of(): 设置日期+时间
3、getXxx(): 获取相关属性
4、withXxx()： 设置相关属性
5、plusXxx(): 加上相关属性

import org.junit.Test;
import java.time.LocalDate;
import java.time.LocalTime;
import java.time.LocalDateTime;

public class LocalDateTimeTest {
    @Test
    public void test(){
        //1、now获取当前日期、时间、日期+时间
        LocalDate localDate = LocalDate.now();
        LocalTime localTime = LocalTime.now();
        LocalDateTime localDateTime = LocalDateTime.now();

        //2、of(): 设置日期+时间
        LocalDateTime localDateTime1 = LocalDateTime.of(2020,11,13,10,10);
        System.out.println(localDateTime1);//2020-11-13T10:10

        //3、getXxx(): 获取相关属性
        System.out.println(localDateTime.getDayOfMonth());//

    //不可变性
        
        //4、withXxx()： 设置相关属性
        LocalDate localDate1 = localDate.withDayOfMonth(22);
        System.out.println(localDate);//不可变性
        System.out.println(localDate1);

        //5、plusXxx(): 加上相关属性
    }
}

四、Instant类（瞬时）

1、说明

• Instant：时间线上的一个瞬时点。 这可能被用来记录应用程序中的事件时间
  戳。

• 在处理时间和日期的时候，我们通常会想到年,月,日,时,分,秒。然而，这只是
  时间的一个模型，是面向人类的。第二种通用模型是面向机器的，或者说是连
  续的。在此模型中，时间线中的一个点表示为一个很大的数，这有利于计算机
  处理。 在UNIX中，这个数从1970年开始，以秒为的单位；同样的，在Java中，
  也是从1970年开始，但以毫秒为单位。

• java.time包通过值类型Instant提供机器视图，不提供处理人类意义上的时间
  单位。 Instant表示时间线上的一点，而不需要任何上下文信息，例如，时区。
  概念上讲， 它只是简单的表示自1970年1月1日0时0分0秒（ UTC）开始的秒
  数。 因为java.time包是基于纳秒计算的，所以Instant的精度可以达到纳秒级。

• (1 ns = 10-9 s) 1秒 = 1000毫秒 =10^6微秒=109纳秒

常见方法

• 1、now() : 获取本初子午线的时间
• 2、atOffset() : 根据时区，添加时间偏移量
• 3、toEpochMilli() : 获取1970-01-01 00:00:00到当前时间的毫秒数， 即为时间戳 --> Date类的 getTime()方法
• 4、ofEpochMilli(long epochMilli) -->Date(long millis)
  

@Test
    public void test2(){
        //实例化
        //1、now() : 获取本初子午线的时间
        Instant instant = Instant.now();//获取当前时间（0时区）
        System.out.println(instant);//2020-11-13T06:33:33.018859200Z(早八小时)

        //2、atOffset() : 根据时区，添加时间偏移量
        OffsetDateTime offsetDateTime = instant.atOffset(ZoneOffset.ofHours(8));
        System.out.println(offsetDateTime);//2020-11-13T14:39:11.752174300+08:00

        //3、toEpochMilli() : 获取1970-01-01 00:00:00到当前时间的毫秒数， 即为时间戳
        long milli = instant.toEpochMilli();
        System.out.println(milli);//1605249977944

        //4、ofEpochMilli(long epochMilli)：
        Instant instant1 = Instant.ofEpochMilli(milli);
        System.out.println(instant1);//2020-11-13T06:48:37.021Z (milli毫秒数对应的日期)

    }

五、java.time.format.DateTimeFormatter类

类似于SimpleDateFormat

1、java.time.format.DateTimeFormatter 类：该类提供了三种格式化方法：

• 预定义的标准格式。如：
  ISO_LOCAL_DATE_TIME;
  ISO_LOCAL_DATE;
  ISO_LOCAL_TIME；

 @Test
    public void test(){

        DateTimeFormatter isoDateTime = DateTimeFormatter.ISO_DATE_TIME;
        //格式化：日期 -->字符串
        LocalDateTime localDateTime = LocalDateTime.now();
        String str1 = isoDateTime.format(localDateTime);
        System.out.println(localDateTime);//2020-11-13T15:08:19.007738400

        //解析：字符串 --> 日期
        TemporalAccessor parse = isoDateTime.parse("2020-11-13T15:08:19.007738400");
        System.out.println(parse);//{},ISO resolved to 2020-11-13T15:08:19.007738400
    }

• 本地化相关的格式。如： ofLocalizedDateTime(FormatStyle.LONG)
• 重点：自定义的格式。如： ofPattern(“yyyy-MM-dd hh:mm:ss”)

 @Test
    public void test4(){
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd hh:mm:ss");
        //格式化： 日期 --> 字符串
        System.out.println(formatter);//Value(YearOfEra,4,19,EXCEEDS_PAD)'-'Value(MonthOfYear,2)'-'Value(DayOfMonth,2)' 'Value(ClockHourOfAmPm,2)':'Value(MinuteOfHour,2)':'Value(SecondOfMinute,2)
        String str = formatter.format(LocalDateTime.now());
        System.out.println(str);//2020-11-13 03:22:34

        //解析:  字符串 --> 日期
        TemporalAccessor parse = formatter.parse("2020-11-13 03:22:34");
        System.out.println(parse);//{SecondOfMinute=34, NanoOfSecond=0, MilliOfSecond=0, MinuteOfHour=22, MicroOfSecond=0, HourOfAmPm=3},ISO resolved to 2020-11-13
    }

六、其他与日期有关的API

ZoneId： 该类中包含了所有的时区信息， 一个时区的ID， 如 Europe/Paris

ZonedDateTime： 一个在ISO-8601日历系统时区的日期时间， 如 2007-12-
03T10:15:30+01:00 Europe/Paris。

• 其中每个时区都对应着ID， 地区ID都为“ {区域}/{城市}” 的格式， 例如：Asia/Shanghai等

Clock： 使用时区提供对当前即时、 日期和时间的访问的时钟。

• 持续时间： Duration， 用于计算两个“时间” 间隔
• 日期间隔： Period， 用于计算两个“日期” 间隔

TemporalAdjuster : 时间校正器。有时我们可能需要获取例如：将日期调整
到“下一个工作日”等操作。

TemporalAdjusters : 该类通过静态方法

• (firstDayOfXxx()/lastDayOfXxx()/nextXxx())提供了大量的常用
  TemporalAdjuster 的实现。

//ZoneId:类中包含了所有的时区信息
// ZoneId的getAvailableZoneIds():获取所有的ZoneId
Set<String> zoneIds = ZoneId.getAvailableZoneIds();
for (String s : zoneIds) {
System.out.println(s);
}
// ZoneId的of():获取指定时区的时间
LocalDateTime localDateTime = LocalDateTime.now(ZoneId.of("Asia/Tokyo"));
System.out.println(localDateTime);
//ZonedDateTime:带时区的日期时间
// ZonedDateTime的now():获取本时区的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);

//Duration:用于计算两个“时间”间隔，以秒和纳秒为基准
LocalTime localTime = LocalTime.now();
LocalTime localTime1 = LocalTime.of(15, 23, 32);
//between():静态方法，返回Duration对象，表示两个时间的间隔
Duration duration = Duration.between(localTime1, localTime);
System.out.println(duration);
System.out.println(duration.getSeconds());
System.out.println(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(localDateTime1, localDateTime);
System.out.println(duration1.toDays());

//Period:用于计算两个“日期”间隔，以年、月、日衡量
LocalDate localDate = LocalDate.now();
LocalDate localDate1 = LocalDate.of(2028, 3, 18);
Period period = Period.between(localDate, localDate1);
System.out.println(period);
System.out.println(period.getYears());
System.out.println(period.getMonths());
System.out.println(period.getDays());
Period period1 = period.withYears(2);
System.out.println(period1);

// TemporalAdjuster:时间校正器
// 获取当前日期的下一个周日是哪天？
TemporalAdjuster temporalAdjuster = TemporalAdjusters.next(DayOfWeek.SUNDAY);
LocalDateTime localDateTime = LocalDateTime.now().with(temporalAdjuster);
System.out.println(localDateTime);
// 获取下一个工作日是哪天？
LocalDate localDate = 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("下一个工作日是： " + localDate);

七、与传统日期处理的转换