Java 8 Instant 时间戳小记

向右看齐 2023-01-01 06:50 429阅读 0赞

## Java 8 Instant 时间戳 ##

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

<table> 
 <thead> 
  <tr> 
   <th>方法名称</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>plusMillis()</td> 
   <td>增加时间戳时间，以毫秒为单位</td> 
  </tr> 
  <tr> 
   <td>minusNanos()</td> 
   <td>增加时间戳时间，以纳秒为单位</td> 
  </tr> 
  <tr> 
   <td>minusSeconds()</td> 
   <td>增加时间戳时间，以秒为单位</td> 
  </tr> 
  <tr> 
   <td>TimeUnit.HOURS.toMillis()</td> 
   <td>将小时转化为毫秒数</td> 
  </tr> 
 </tbody> 
</table>

//增加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获取当前时间距离格林威治时间的值 ##

1.  通过 `getEpochSecond()`方法获取距离格林威治时间的**秒数**
2.  通过`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);