JAVA时间戳类Instant

首页 / 新闻资讯 / 正文

前言

在JAVA8之前的版本,去获取时间戳(毫秒级别)常用的办法有两种

// 方法一:构建日期Date类然后调用getTime方法 Date date = new Date(); System.out.println(date.getTime());  // 方法二:使用System类静态方法获取 System.out.println(System.currentTimeMillis());

由于Date类大部分方法已经废弃,而且上面两种方法的时间戳只能精确到毫秒级别,所以我们有必要了解下jdk1.8推出的Instant类,该类可以将时间戳精确到纳秒级别。

Instant类

时间点

该类对象表示的是时间线上的一点,这个时间点存在标准的UTC时间,注意这个时间并不是指北京时间或东京时间而是指世界时间

// 获取当前时间 2022-09-26T03:12:58.517Z(比当地时间相差8个小时) System.out.println(Instant.now());  // 获取系统默认时间戳 2022-09-26T11:12:58.517+08:00[Asia/Shanghai] System.out.println(Instant.now().atZone(ZoneId.systemDefault()));

在Instant时间线上存在三个重要的点位,最大点、最小点、原点也就是说小于1970-01-01的时间戳就为负数,超过1970-01-01的时间戳就为正数

// 时间线上最大点  +1000000000-12-31T23:59:59.999999999Z System.out.println(Instant.MAX);  // 时间线上最小点  -1000000000-01-01T00:00:00Z System.out.println(Instant.MIN);  // 时间线上原点   1970-01-01T00:00:00Z System.out.println(Instant.EPOCH);  // 输出结果为-8369623 System.out.println(Instant.parse("1969-09-26T03:06:17.323Z").getEpochSecond());

时间表示

在Instant中采用两个字段表示时间戳

/**  * The number of seconds from the epoch of 1970-01-01T00:00:00Z.  * 该字段表示Instant时间距离原点1970-01-01T00:00:00Z的时间(单位秒)  */ private final long seconds; /**  * The number of nanoseconds, later along the time-line, from the seconds field.  * This is always positive, and never exceeds 999,999,999.  * 该字段表示Instant当前时间的纳秒数这个值不会超过999,999,999,因为1秒=1000_000_000纳秒  */ private final int nanos;

Instant实例化

普通实例化分为如下几种

// 获取当前时间 Instant instant1 = Instant.now();  // 字符串转Instant Instant instant2 = Instant.parse("2022-09-26T03:46:24.373Z");  // 构建秒级Instant对象,从时间1970-01-01T00:00:00Z开始计算(距离原点5000秒) // 结果为:1970-01-01T01:23:20Z Instant instant3 = Instant.ofEpochSecond(5000);  // 构建毫秒级Instant对象,同样从时间1970-01-01T00:00:00Z开始计算(距离原点5000毫秒) // 结果为:1970-01-01T00:00:05Z Instant instant4 = Instant.ofEpochMilli(5000);

还有一种特殊的如下,可以构建纳秒级的Instant对象

// 构建纳秒级Instant对象,同样从时间1970-01-01T00:00:00Z开始计算 // 参数:epochSecond(秒),nanoAdjustment(纳秒) // 结果为:1970-01-01T00:00:05.000001111Z Instant instant5 = Instant.ofEpochSecond(5, 1111);

不过我们需要注意Instant.ofEpochSecond方法的源码,如下

static final long NANOS_PER_SECOND = 1000_000_000L; /**  * @param epochSecond  秒从1970-01-01T00:00:00Z开始计算  * @param nanoAdjustment  纳秒  */ public static Instant ofEpochSecond(long epochSecond, long nanoAdjustment) {     // Math.floorDiv是除法运算,返回小于或等于商的整数 Math.floorDiv(25, 3)=8     // Math.addExact加法运算,Math.addExact(1, 2)=3     long secs = Math.addExact(epochSecond, Math.floorDiv(nanoAdjustment, NANOS_PER_SECOND));     // Math.floorMod是模运算,Math.floorMod(9, 20)=9     int nos = (int)Math.floorMod(nanoAdjustment, NANOS_PER_SECOND);     return create(secs, nos); }

Instant获取参数

Instant instant = Instant.now(); // 时区相差8小时 2022-09-26T07:04:19.110Z System.out.println(instant);  System.out.println("秒:"+instant.getEpochSecond());  System.out.println("毫秒:"+instant.toEpochMilli()); // 1毫秒 = 1000 000 纳秒 System.out.println("纳秒:"+instant.getNano());

Instant时间点比较

由于时间点位于时间线上,所以可以直接进行对比。

Instant instant1 = Instant.parse("2022-09-26T07:04:19.110Z"); Instant instant2 = Instant.parse("2022-09-26T07:04:19.110Z"); Instant instant3 = Instant.parse("2022-08-26T07:04:19.110Z");  // 相等为0 System.out.println(instant1.compareTo(instant2)); // instant1大于instant3 为1 System.out.println(instant1.compareTo(instant3)); // instant1小于instant3 为-1 System.out.println(instant3.compareTo(instant1));  // true System.out.println(instant1.isAfter(instant3)); // false System.out.println(instant1.isBefore(instant3));

Instant时间点运算

Instant instant1 = Instant.parse("2022-09-26T07:04:19.110Z");  // 在instant1的基础上增加2秒,值为:2022-09-26T07:04:21.110Z System.out.println(instant1.plusSeconds(2));  // 在instant1的基础上增加1毫秒,值为:2022-09-26T07:04:19.111Z System.out.println(instant1.plusMillis(1));  // 在instant1的基础上增加1001纳秒,值为:2022-09-26T07:04:19.110001001Z System.out.println(instant1.plusNanos(1001));  // 在instant1的基础上增加1秒,值为:2022-09-26T07:04:20.110Z // 该值取决于后面指定的单位,可以从ChronoUnit枚举类获取 System.out.println(instant1.plus(1, ChronoUnit.SECONDS));  // 在instant1的基础上减去1秒,值为:2022-09-26T07:04:18.110Z // plus是增加,minus是减少,逻辑类似可以参考上面plus相关A System.out.println(instant1.minusSeconds(1));

Instant时间点计算时需要注意,无论是调用plus或者minus相关API都会重新创建新对象。