Javatime 简明教程

java.time.Instant Class

Introduction

java.time.Instant 类对时间线上的单个瞬时点进行建模。

Class declaration

以下是 java.time.Instant 类的声明 −

public final class Instant
   extends Object
      implements Temporal, TemporalAdjuster, Comparable, Serializable

Field

  1. 以下为 Java.time.Instant 类的字段 -

  2. static Instant EPOCH − 1970-01-01T00:00:00Z 历元时刻的常量。

  3. static Instant MAX − 支持的最大 Instant,“1000000000-12-31T23:59:59.999999999Z”。

  4. static Instant MIN − 支持的最小 Instant,“-1000000000-01-01T00:00Z”。

Class methods

Sr.No.

Method & Description

1

Temporal adjustInto(Temporal temporal) 调整指定的时间对象以获得此时间点。

2

OffsetDateTime atOffset(ZoneOffset offset) 将此时间点与偏移组合以创建 OffsetDateTime。

3

ZonedDateTime atZone(ZoneId zone) 将此时间点与时区组合以创建 ZonedDateTime。

4

int compareTo(Instant otherInstant) 将此时间点与指定时间点进行比较。

5

boolean equals(Object otherInstant) 检查此时间点是否等于指定时间点。

6

static Instant from(TemporalAccessor temporal) 从时间对象获取 Instant 的实例。

7

int get(TemporalField field) 从此时间点获取指定字段值,类型为 int。

8

long getEpochSecond() 获取从 1970-01-01T00:00:00Z Java 历元开始的秒数。

9

long getLong(TemporalField field) 从此时间点获取指定字段值,类型为 long。

10

int getNano() 获取从秒开始的纳秒数,时间线上的靠后时间。

11

int hashCode() 返回此时间的哈希码。

12

boolean isAfter(Instant otherInstant) 检查此时间点是否在指定时间点之后。

13

boolean isBefore(Instant otherInstant) 检查此时间点是否在指定时间点之前。

14

boolean isSupported(TemporalField field) 检查指定的字段是否受支持。

15

boolean isSupported(TemporalUnit unit) 检查指定单位是否受支持。

16

Instant minus(long amountToSubtract, TemporalUnit unit) 用指定的时间减去副本

17

Instant minus(TemporalAmount amountToSubtract) 用指定的时间减去副本

18

Instant minusMillis(long millisToSubtract) 用减去的指定毫秒时间副本

19

Instant minusNanos(long nanosToSubtract) 用减去的指定纳秒时间副本

20

Instant minusSeconds(long secondsToSubtract) 用减去的指定秒时间副本

21

static Instant now() 从系统时钟获取当前瞬间

22

static Instant now(Clock clock) 从指定时钟获取当前瞬间

23

static Instant ofEpochMilli(long epochMilli) 从 1970-01-01T00:00:00Z 历元的毫秒中获取一个瞬间的实例

24

static Instant ofEpochSecond(long epochSecond) 从 1970-01-01T00:00:00Z 历元的秒钟中获取一个瞬间的实例

25

static Instant ofEpochSecond(long epochSecond, long nanoAdjustment) 使用从 1970-01-01T00:00:00Z 历元的秒钟和纳秒级时间中获取一个瞬间的实例

26

static Instant parse(CharSequence text) 从文本字符串中获取一个瞬间的实例,例如 2007-12-03T10:15:30.00Z。

27

Instant plus(long amountToAdd, TemporalUnit unit) 用指定的时间添加副本

28

Instant plus(TemporalAmount amountToAdd) 用指定的时间添加副本

29

Instant plusMillis(long millisToAdd) 用添加的指定毫秒时间副本

30

Instant plusNanos(long nanosToAdd) 用添加的指定纳秒时间副本

31

Instant plusSeconds(long secondsToAdd) 用添加的指定秒时间副本

32

R query(TemporalQuery query) 使用指定查询查询此瞬间

33

ValueRange range(TemporalField field) 获取指定字段的有效值范围

34

long toEpochMilli() 将此瞬间转换为从 1970-01-01T00:00:00Z 历元的毫秒数

35

String toString() 使用 ISO-8601 表示法表示的 instant 的字符串表示形式。

36

Instant truncatedTo(TemporalUnit unit) 返回 truncated 为指定单位的此 Instant 的副本。

37

long until(Temporal endExclusive, TemporalUnit unit) 计算以指定单位表示的与另一个 instant 的时间数量。

38

Instant with(TemporalAdjuster adjuster) 返回此 instant 的调整副本。

39

Instant with(TemporalField field, long newValue) 返回将指定字段设置为新值的此 instant 的副本。

Methods inherited

此类从以下类中继承方法:

  1. Java.lang.Object