Uses of Class java.time.Instant (Java Platform SE 8 )
Date: 2026-08-19

## Uses of Class
java.time.Instant

- Packages that use Instant
  Package | Description
  --- | ---
  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 JavaTM 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, legacy collection classes, event model, date and time facilities, internationalization, and miscellaneous utility classes (a string tokenizer, a random-number generator, and a bit array).

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

    Methods in java.nio.file.attribute that return Instant
    Modifier and Type | Method and 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 and 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 and Description
    --- | ---
    `Instant` | Timestamp.`toInstant()` Converts this `Timestamp` object to an `Instant`.
    `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` | Date.`toInstant()` This method always throws an UnsupportedOperationException and should not be used because SQL `Date` values do not have a time component.

    Methods in java.sql with parameters of type Instant
    Modifier and Type | Method and 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 and 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 and 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 and 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 OffsetTime` | OffsetTime.`ofInstant(Instant instant, ZoneId zone)` Obtains an instance of `OffsetTime` 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 ZonedDateTime` | ZonedDateTime.`ofInstant(Instant instant, ZoneId zone)` Obtains an instance of `ZonedDateTime` from an `Instant`.
    `static OffsetDateTime` | OffsetDateTime.`ofInstant(Instant instant, ZoneId zone)` Obtains an instance of `OffsetDateTime` from an `Instant` and zone ID.

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

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

    Methods in java.time.chrono with parameters of type Instant
    Modifier and Type | Method and Description
    --- | ---
    `ChronoZonedDateTime<ThaiBuddhistDate>` | ThaiBuddhistChronology.`zonedDateTime(Instant instant, ZoneId zone)`
    `ChronoZonedDateTime<MinguoDate>` | MinguoChronology.`zonedDateTime(Instant instant, ZoneId zone)`
    `ChronoZonedDateTime<JapaneseDate>` | JapaneseChronology.`zonedDateTime(Instant instant, ZoneId zone)`
    `ChronoZonedDateTime<HijrahDate>` | HijrahChronology.`zonedDateTime(Instant instant, ZoneId zone)`
    `ZonedDateTime` | IsoChronology.`zonedDateTime(Instant instant, ZoneId zone)` Obtains an ISO zoned date-time in this chronology from an `Instant`.
    `default ChronoZonedDateTime<? extends ChronoLocalDate>` | Chronology.`zonedDateTime(Instant instant, ZoneId zone)` Obtains a `ChronoZonedDateTime` 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 and Description
    --- | ---
    `Instant` | ZoneOffsetTransition.`getInstant()` Gets the transition instant.

    Methods in java.time.zone with parameters of type Instant
    Modifier and Type | Method and 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 and 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 and Description
    --- | ---
    `static Date` | Date.`from(Instant instant)` Obtains an instance of `Date` from an `Instant` object.

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2026, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.