Java时间戳类Instant的使用详解

目录

• 前言
• Instant类
• 时间点
• 时间表示
• Instant实例化
• Instant获取参数
• Instant时间点比较
• 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都会重新创建新对象。

到此这篇关于Java时间戳类Instant的使用详解的文章就介绍到这了,更多相关Java时间戳类Instant内容请搜索自由互联以前的文章或继续浏览下面的相关文章希望大家以后多多支持自由互联！