Uses of Class java.time.Instant (Java SE 12 & JDK 12 )

## Uses of Class
java.time.Instant

- Packages that use Instant
  Package | Description
  --- | ---
  java.lang | Provides classes that are fundamental to the design of the Java programming language.
  java.nio.file.attribute | Interfaces and classes providing access to file and file system attributes.
  java.sql | Provides the API for accessing and processing data stored in a data source (usually a relational database) using the Java™ programming language.
  java.time | The main API for dates, times, instants, and durations.
  java.time.chrono | Generic API for calendar systems other than the default ISO.
  java.time.zone | Support for time-zones and their rules.
  java.util | Contains the collections framework, some internationalization support classes, a service loader, properties, random number generation, string parsing and scanning classes, base64 encoding and decoding, a bit array, and several miscellaneous utility classes.
  java.util.logging | Provides the classes and interfaces of the Java™ 2 platform's core logging facilities.
  jdk.jfr | This package provides classes to create events and control Flight Recorder.
  jdk.jfr.consumer | This package contains classes for consuming Flight Recorder data.

- - ### Uses of Instant in java.lang

    Methods in java.lang that return types with arguments of type Instant
    Modifier and Type | Method | Description
    --- | --- | ---
    `Optional<Instant>` | ProcessHandle.Info.`startInstant()` | Returns the start time of the process.

  - ### Uses of Instant in java.nio.file.attribute

    Methods in java.nio.file.attribute that return Instant
    Modifier and Type | Method | Description
    --- | --- | ---
    `Instant` | FileTime.`toInstant()` | Converts this `FileTime` object to an `Instant`.

    Methods in java.nio.file.attribute with parameters of type Instant
    Modifier and Type | Method | Description
    --- | --- | ---
    `static FileTime` | FileTime.`from​(Instant instant)` | Returns a `FileTime` representing the same point of time value on the time-line as the provided `Instant` object.

  - ### Uses of Instant in java.sql

    Methods in java.sql that return Instant
    Modifier and Type | Method | Description
    --- | --- | ---
    `Instant` | Date.`toInstant()` | This method always throws an UnsupportedOperationException and should not be used because SQL `Date` values do not have a time component.
    `Instant` | Time.`toInstant()` | This method always throws an UnsupportedOperationException and should not be used because SQL `Time` values do not have a date component.
    `Instant` | Timestamp.`toInstant()` | Converts this `Timestamp` object to an `Instant`.

    Methods in java.sql with parameters of type Instant
    Modifier and Type | Method | Description
    --- | --- | ---
    `static Timestamp` | Timestamp.`from​(Instant instant)` | Obtains an instance of `Timestamp` from an `Instant` object.

  - ### Uses of Instant in java.time

    Fields in java.time declared as Instant
    Modifier and Type | Field | Description
    --- | --- | ---
    `static Instant` | Instant.`EPOCH` | Constant for the 1970-01-01T00:00:00Z epoch instant.
    `static Instant` | Instant.`MAX` | The maximum supported `Instant`, '1000000000-12-31T23:59:59.999999999Z'.
    `static Instant` | Instant.`MIN` | The minimum supported `Instant`, '-1000000000-01-01T00:00Z'.

    Methods in java.time that return Instant
    Modifier and Type | Method | Description
    --- | --- | ---
    `static Instant` | Instant.`from​(TemporalAccessor temporal)` | Obtains an instance of `Instant` from a temporal object.
    `abstract Instant` | Clock.`instant()` | Gets the current instant of the clock.
    `Instant` | Instant.`minus​(long amountToSubtract, TemporalUnit unit)` | Returns a copy of this instant with the specified amount subtracted.
    `Instant` | Instant.`minus​(TemporalAmount amountToSubtract)` | Returns a copy of this instant with the specified amount subtracted.
    `Instant` | Instant.`minusMillis​(long millisToSubtract)` | Returns a copy of this instant with the specified duration in milliseconds subtracted.
    `Instant` | Instant.`minusNanos​(long nanosToSubtract)` | Returns a copy of this instant with the specified duration in nanoseconds subtracted.
    `Instant` | Instant.`minusSeconds​(long secondsToSubtract)` | Returns a copy of this instant with the specified duration in seconds subtracted.
    `static Instant` | Instant.`now()` | Obtains the current instant from the system clock.
    `static Instant` | Instant.`now​(Clock clock)` | Obtains the current instant from the specified clock.
    `static Instant` | Instant.`ofEpochMilli​(long epochMilli)` | Obtains an instance of `Instant` using milliseconds from the epoch of 1970-01-01T00:00:00Z.
    `static Instant` | Instant.`ofEpochSecond​(long epochSecond)` | Obtains an instance of `Instant` using seconds from the epoch of 1970-01-01T00:00:00Z.
    `static Instant` | Instant.`ofEpochSecond​(long epochSecond, long nanoAdjustment)` | Obtains an instance of `Instant` using seconds from the epoch of 1970-01-01T00:00:00Z and nanosecond fraction of second.
    `static Instant` | Instant.`parse​(CharSequence text)` | Obtains an instance of `Instant` from a text string such as `2007-12-03T10:15:30.00Z`.
    `Instant` | Instant.`plus​(long amountToAdd, TemporalUnit unit)` | Returns a copy of this instant with the specified amount added.
    `Instant` | Instant.`plus​(TemporalAmount amountToAdd)` | Returns a copy of this instant with the specified amount added.
    `Instant` | Instant.`plusMillis​(long millisToAdd)` | Returns a copy of this instant with the specified duration in milliseconds added.
    `Instant` | Instant.`plusNanos​(long nanosToAdd)` | Returns a copy of this instant with the specified duration in nanoseconds added.
    `Instant` | Instant.`plusSeconds​(long secondsToAdd)` | Returns a copy of this instant with the specified duration in seconds added.
    `Instant` | OffsetDateTime.`toInstant()` | Converts this date-time to an `Instant`.
    `Instant` | Instant.`truncatedTo​(TemporalUnit unit)` | Returns a copy of this `Instant` truncated to the specified unit.
    `Instant` | Instant.`with​(TemporalAdjuster adjuster)` | Returns an adjusted copy of this instant.
    `Instant` | Instant.`with​(TemporalField field, long newValue)` | Returns a copy of this instant with the specified field set to a new value.

    Methods in java.time with parameters of type Instant
    Modifier and Type | Method | Description
    --- | --- | ---
    `int` | Instant.`compareTo​(Instant otherInstant)` | Compares this instant to the specified instant.
    `static Clock` | Clock.`fixed​(Instant fixedInstant, ZoneId zone)` | Obtains a clock that always returns the same instant.
    `boolean` | Instant.`isAfter​(Instant otherInstant)` | Checks if this instant is after the specified instant.
    `boolean` | Instant.`isBefore​(Instant otherInstant)` | Checks if this instant is before the specified instant.
    `static LocalDate` | LocalDate.`ofInstant​(Instant instant, ZoneId zone)` | Obtains an instance of `LocalDate` from an `Instant` and zone ID.
    `static LocalDateTime` | LocalDateTime.`ofInstant​(Instant instant, ZoneId zone)` | Obtains an instance of `LocalDateTime` from an `Instant` and zone ID.
    `static LocalTime` | LocalTime.`ofInstant​(Instant instant, ZoneId zone)` | Obtains an instance of `LocalTime` from an `Instant` and zone ID.
    `static OffsetDateTime` | OffsetDateTime.`ofInstant​(Instant instant, ZoneId zone)` | Obtains an instance of `OffsetDateTime` from an `Instant` and zone ID.
    `static OffsetTime` | OffsetTime.`ofInstant​(Instant instant, ZoneId zone)` | Obtains an instance of `OffsetTime` from an `Instant` and zone ID.
    `static ZonedDateTime` | ZonedDateTime.`ofInstant​(Instant instant, ZoneId zone)` | Obtains an instance of `ZonedDateTime` from an `Instant`.

  - ### Uses of Instant in java.time.chrono

    Methods in java.time.chrono that return Instant
    Modifier and Type | Method | Description
    --- | --- | ---
    `default Instant` | ChronoLocalDateTime.`toInstant​(ZoneOffset offset)` | Converts this date-time to an `Instant`.
    `default Instant` | ChronoZonedDateTime.`toInstant()` | Converts this date-time to an `Instant`.

    Methods in java.time.chrono with parameters of type Instant
    Modifier and Type | Method | Description
    --- | --- | ---
    `default ChronoZonedDateTime<? extends ChronoLocalDate>` | Chronology.`zonedDateTime​(Instant instant, ZoneId zone)` | Obtains a `ChronoZonedDateTime` in this chronology from an `Instant`.
    `ZonedDateTime` | IsoChronology.`zonedDateTime​(Instant instant, ZoneId zone)` | Obtains an ISO zoned date-time in this chronology from an `Instant`.

  - ### Uses of Instant in java.time.zone

    Methods in java.time.zone that return Instant
    Modifier and Type | Method | Description
    --- | --- | ---
    `Instant` | ZoneOffsetTransition.`getInstant()` | Gets the transition instant.

    Methods in java.time.zone with parameters of type Instant
    Modifier and Type | Method | Description
    --- | --- | ---
    `Duration` | ZoneRules.`getDaylightSavings​(Instant instant)` | Gets the amount of daylight savings in use for the specified instant in this zone.
    `ZoneOffset` | ZoneRules.`getOffset​(Instant instant)` | Gets the offset applicable at the specified instant in these rules.
    `ZoneOffset` | ZoneRules.`getStandardOffset​(Instant instant)` | Gets the standard offset for the specified instant in this zone.
    `boolean` | ZoneRules.`isDaylightSavings​(Instant instant)` | Checks if the specified instant is in daylight savings.
    `ZoneOffsetTransition` | ZoneRules.`nextTransition​(Instant instant)` | Gets the next transition after the specified instant.
    `ZoneOffsetTransition` | ZoneRules.`previousTransition​(Instant instant)` | Gets the previous transition before the specified instant.

  - ### Uses of Instant in java.util

    Methods in java.util that return Instant
    Modifier and Type | Method | Description
    --- | --- | ---
    `Instant` | Calendar.`toInstant()` | Converts this object to an `Instant`.
    `Instant` | Date.`toInstant()` | Converts this `Date` object to an `Instant`.

    Methods in java.util with parameters of type Instant
    Modifier and Type | Method | Description
    --- | --- | ---
    `static Date` | Date.`from​(Instant instant)` | Obtains an instance of `Date` from an `Instant` object.

  - ### Uses of Instant in java.util.logging

    Methods in java.util.logging that return Instant
    Modifier and Type | Method | Description
    --- | --- | ---
    `Instant` | LogRecord.`getInstant()` | Gets the instant that the event occurred.

    Methods in java.util.logging with parameters of type Instant
    Modifier and Type | Method | Description
    --- | --- | ---
    `void` | LogRecord.`setInstant​(Instant instant)` | Sets the instant that the event occurred.

  - ### Uses of Instant in jdk.jfr

    Methods in jdk.jfr that return Instant
    Modifier and Type | Method | Description
    --- | --- | ---
    `Instant` | Recording.`getStartTime()` | Returns the time when this recording was started.
    `Instant` | Recording.`getStopTime()` | Returns the time when this recording was stopped.

    Methods in jdk.jfr with parameters of type Instant
    Modifier and Type | Method | Description
    --- | --- | ---
    `InputStream` | Recording.`getStream​(Instant start, Instant end)` | Creates a data stream for a specified interval.

  - ### Uses of Instant in jdk.jfr.consumer

    Methods in jdk.jfr.consumer that return Instant
    Modifier and Type | Method | Description
    --- | --- | ---
    `Instant` | RecordedEvent.`getEndTime()` | Returns the end time of the event.
    `Instant` | RecordedObject.`getInstant​(String name)` | Returns the value of a timestamp field.
    `Instant` | RecordedEvent.`getStartTime()` | Returns the start time of the event.