Java8 Instant时间戳使用小记

Java 8 Instant 时间戳

用于“时间戳”的运算。它是以Unix元年(传统 的设定为UTC时区1970年1月1日午夜时分)开始 所经历的描述进行运算

1. 创建Instant实例，获取系统的当前时间now

/**
 * Java 8 Instant时间戳学习
 */
@Test
public void testInstant(){
 // 通过Instant创建Instant实例 返回：return Clock.systemUTC().instant();
 Instant now = Instant.now();

//控制台输出：now = 2020-12-29T06:32:49.480Z （以ISO-8601格式输出)
 System.out.println("now = " + now);
}

注意：这里额控制台输出：now = 2020-12-29T06:32:49.480Z。

Intance的now方法：

public static Instant now() {
 return Clock.systemUTC().instant();
}

这是输出的世界标准时间，其中T表示时分秒的开始（或者日期与时间的间隔），Z表示这是一个世界标准时间。

Instant 是时间戳，是指世界标准时格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总秒数，Instant本身实际上是指明时区了，是0时区（也就是比北京时间少8小时）。

2. 获取当前时区的时间（本地时间）

2.1 通过方法Instant.now().atZone(ZoneId.systemDefault())获取当前地区的时间

 ZonedDateTime zonedDateTime = Instant.now().atZone(ZoneId.systemDefault());
 System.out.println(zonedDateTime);

输出结果

2020-12-31T17:31:14.953+08:00[Asia/Shanghai]

2.2 通过增加8小时，转化为北京时间

 //增加8个小时，使Instant.now()返回时间为北京时间
 Instant now2 = Instant.now().plusMillis(TimeUnit.HOURS.toMillis(8));
 System.out.println("now2 = " + now2);

输出结果：now2 = 2020-12-29T14:35:32.631Z

转换为符合当前的北京时间。

3. 通过Instant获取当前时间距离格林威治时间的值

通过 getEpochSecond()方法获取距离格林威治时间的秒数

通过toEpochMilli()方法获取距离格林威治时间的毫秒数

 //增加8个小时，使Instant.now()返回时间为北京时间
 Instant now2 = Instant.now().plusMillis(TimeUnit.HOURS.toMillis(8));
 //获取格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)距离当前时间的秒/毫秒值
 System.out.println("距离1970年01月01日00时00分00秒 : "+now2.getEpochSecond() + "秒");
 System.out.println("距离1970年01月01日00时00分00秒 : "+now2.toEpochMilli() + "毫秒");

输出结果：

距离1970年01月01日00时00分00秒 : 1609435201秒
距离1970年01月01日00时00分00秒 : 1609435201645毫秒

4. Instant的from、parse方法

4.1 java.time.Instant.from(TemporalAccessor temporal)源码：

public static Instant from(TemporalAccessor temporal) {
 if (temporal instanceof Instant) {
  return (Instant) temporal;
 }
 Objects.requireNonNull(temporal, "temporal");
 try {
  long instantSecs = temporal.getLong(INSTANT_SECONDS);
  int nanoOfSecond = temporal.get(NANO_OF_SECOND);
  return Instant.ofEpochSecond(instantSecs, nanoOfSecond);
 } catch (DateTimeException ex) {
  throw new DateTimeException("Unable to obtain Instant from TemporalAccessor: " +
    temporal + " of type " + temporal.getClass().getName(), ex);
 }
}

参数：temporal 是要转换的时间对象，返回的是一个转换为Instant的瞬间值

如果转换为Instant的时候失败，会抛出异常``DateTimeException`

4.2 parse方法源码

public static Instant parse(final CharSequence text) {
 return DateTimeFormatter.ISO_INSTANT.parse(text, Instant::from);
}

创建自定义的时间戳

 //创建自定义的时间戳
 System.out.println(Instant.parse("2020-12-29T14:35:32.631Z"));

输出结果

2020-12-29T14:35:32.631Z

5. Instant的其它常用函数

//获取当前时间戳
 Instant instant = Instant.now();
 //获得当前时间戳并且增加66毫秒
 Instant instant1 = Instant.now().plusMillis(66);
 //获得当前时间戳并且减少66毫秒
 Instant instant2 = Instant.now().minusMillis(66);

//判断时间戳 instant 是否在 instant1 之后，返回boolean
 System.out.println(instant.isAfter(instant1)); //返回false
 //判断时间戳 instant 是否在 instant1 之前，返回boolean
 System.out.println(instant.isBefore(instant1)); //返回true
 //判断两个时间戳是否相等， 返回boolean值
 System.out.println(instant.equals(instant1)); //返回false

//获得当前时间戳并增加1小时 通过TimeUnit.HOURS.toMillis(1)将小时转换为毫秒，然后通过plusMillis增加
 Instant instant3 = Instant.now().plusMillis(TimeUnit.HOURS.toMillis(1));
 //获取时间戳 instant和instant3 相差天数，返回long类型
 //如果小于1天，都算零天，大于等于1天，小于2天算一天
 System.out.println("相差天数 = " + instant.until(instant3, ChronoUnit.DAYS)); //返回0
 //获取时间戳 instant和instant3 相差的小时数，返回long类型
 System.out.println("相差小时 = " + instant.until(instant3, ChronoUnit.HOURS)); //返回1
 //获取时间戳 instant和instant3 相差的毫秒数，返回long类型
 System.out.println("相差毫秒数 = " + instant.until(instant3, ChronoUnit.MILLIS)); //返回3600000

输出结果：

false
true
false
相差天数 = 0
相差小时 = 1
相差毫秒数 = 3600000

6. 将获取的时间戳转化为LocalDate

Instant now = Instant.now();
//UTC
ZonedDateTime atZone = now.atZone(ZoneOffset.UTC);
//LocalDateTime
atZone.toLocalDateTime();
LocalDateTime.from(atZone);

//LocalDate
atZone.toLocalDate();
LocalDate date = LocalDate.from(atZone);
//LocalDateTime
atZone.toLocalDateTime();
LocalDateTime.from(date);

总结

来源：https://blog.csdn.net/qq_40542534/article/details/112043198