Java8 Instant时间戳使用小记

Z时代
2024-01-10
分类：综合

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小时，转化为北京时间

方法名称	描述
plusMillis()	增加时间戳时间，以毫秒为单位
minusNanos()	增加时间戳时间，以纳秒为单位
minusSeconds()	增加时间戳时间，以秒为单位
TimeUnit.HOURS.toMillis()	将小时转化为毫秒数


  //增加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);