Uses of Interface java.time.temporal.TemporalUnit (Java Platform SE 8 )
Date: 2026-07-22

## Uses of Interface
java.time.temporal.TemporalUnit

- Packages that use TemporalUnit
  Package | Description
  --- | ---
  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.temporal | Access to date and time using fields and units, and date time adjusters.

- - ### Uses of TemporalUnit in java.time

    Methods in java.time that return types with arguments of type TemporalUnit
    Modifier and Type | Method and Description
    --- | ---
    `List<TemporalUnit>` | Period.`getUnits()` Gets the set of units supported by this period.
    `List<TemporalUnit>` | Duration.`getUnits()` Gets the set of units supported by this duration.

    Methods in java.time with parameters of type TemporalUnit
    Modifier and Type | Method and Description
    --- | ---
    `long` | Period.`get(TemporalUnit unit)` Gets the value of the requested unit.
    `long` | Duration.`get(TemporalUnit unit)` Gets the value of the requested unit.
    `boolean` | Year.`isSupported(TemporalUnit unit)` Checks if the specified unit is supported.
    `boolean` | OffsetDateTime.`isSupported(TemporalUnit unit)` Checks if the specified unit is supported.
    `boolean` | LocalDateTime.`isSupported(TemporalUnit unit)` Checks if the specified unit is supported.
    `boolean` | OffsetTime.`isSupported(TemporalUnit unit)` Checks if the specified unit is supported.
    `boolean` | Instant.`isSupported(TemporalUnit unit)` Checks if the specified unit is supported.
    `boolean` | YearMonth.`isSupported(TemporalUnit unit)` Checks if the specified unit is supported.
    `boolean` | LocalDate.`isSupported(TemporalUnit unit)` Checks if the specified unit is supported.
    `boolean` | LocalTime.`isSupported(TemporalUnit unit)` Checks if the specified unit is supported.
    `boolean` | ZonedDateTime.`isSupported(TemporalUnit unit)` Checks if the specified unit is supported.
    `Year` | Year.`minus(long amountToSubtract, TemporalUnit unit)` Returns a copy of this year with the specified amount subtracted.
    `OffsetDateTime` | OffsetDateTime.`minus(long amountToSubtract, TemporalUnit unit)` Returns a copy of this date-time with the specified amount subtracted.
    `LocalDateTime` | LocalDateTime.`minus(long amountToSubtract, TemporalUnit unit)` Returns a copy of this date-time with the specified amount subtracted.
    `OffsetTime` | OffsetTime.`minus(long amountToSubtract, TemporalUnit unit)` Returns a copy of this time with the specified amount subtracted.
    `Duration` | Duration.`minus(long amountToSubtract, TemporalUnit unit)` Returns a copy of this duration with the specified duration subtracted.
    `Instant` | Instant.`minus(long amountToSubtract, TemporalUnit unit)` Returns a copy of this instant with the specified amount subtracted.
    `YearMonth` | YearMonth.`minus(long amountToSubtract, TemporalUnit unit)` Returns a copy of this year-month with the specified amount subtracted.
    `LocalDate` | LocalDate.`minus(long amountToSubtract, TemporalUnit unit)` Returns a copy of this date with the specified amount subtracted.
    `LocalTime` | LocalTime.`minus(long amountToSubtract, TemporalUnit unit)` Returns a copy of this time with the specified amount subtracted.
    `ZonedDateTime` | ZonedDateTime.`minus(long amountToSubtract, TemporalUnit unit)` Returns a copy of this date-time with the specified amount subtracted.
    `static Duration` | Duration.`of(long amount, TemporalUnit unit)` Obtains a `Duration` representing an amount in the specified unit.
    `Year` | Year.`plus(long amountToAdd, TemporalUnit unit)` Returns a copy of this year with the specified amount added.
    `OffsetDateTime` | OffsetDateTime.`plus(long amountToAdd, TemporalUnit unit)` Returns a copy of this date-time with the specified amount added.
    `LocalDateTime` | LocalDateTime.`plus(long amountToAdd, TemporalUnit unit)` Returns a copy of this date-time with the specified amount added.
    `OffsetTime` | OffsetTime.`plus(long amountToAdd, TemporalUnit unit)` Returns a copy of this time with the specified amount added.
    `Duration` | Duration.`plus(long amountToAdd, TemporalUnit unit)` Returns a copy of this duration with the specified duration added.
    `Instant` | Instant.`plus(long amountToAdd, TemporalUnit unit)` Returns a copy of this instant with the specified amount added.
    `YearMonth` | YearMonth.`plus(long amountToAdd, TemporalUnit unit)` Returns a copy of this year-month with the specified amount added.
    `LocalDate` | LocalDate.`plus(long amountToAdd, TemporalUnit unit)` Returns a copy of this date with the specified amount added.
    `LocalTime` | LocalTime.`plus(long amountToAdd, TemporalUnit unit)` Returns a copy of this time with the specified amount added.
    `ZonedDateTime` | ZonedDateTime.`plus(long amountToAdd, TemporalUnit unit)` Returns a copy of this date-time with the specified amount added.
    `OffsetDateTime` | OffsetDateTime.`truncatedTo(TemporalUnit unit)` Returns a copy of this `OffsetDateTime` with the time truncated.
    `LocalDateTime` | LocalDateTime.`truncatedTo(TemporalUnit unit)` Returns a copy of this `LocalDateTime` with the time truncated.
    `OffsetTime` | OffsetTime.`truncatedTo(TemporalUnit unit)` Returns a copy of this `OffsetTime` with the time truncated.
    `Instant` | Instant.`truncatedTo(TemporalUnit unit)` Returns a copy of this `Instant` truncated to the specified unit.
    `LocalTime` | LocalTime.`truncatedTo(TemporalUnit unit)` Returns a copy of this `LocalTime` with the time truncated.
    `ZonedDateTime` | ZonedDateTime.`truncatedTo(TemporalUnit unit)` Returns a copy of this `ZonedDateTime` with the time truncated.
    `long` | Year.`until(Temporal endExclusive, TemporalUnit unit)` Calculates the amount of time until another year in terms of the specified unit.
    `long` | OffsetDateTime.`until(Temporal endExclusive, TemporalUnit unit)` Calculates the amount of time until another date-time in terms of the specified unit.
    `long` | LocalDateTime.`until(Temporal endExclusive, TemporalUnit unit)` Calculates the amount of time until another date-time in terms of the specified unit.
    `long` | OffsetTime.`until(Temporal endExclusive, TemporalUnit unit)` Calculates the amount of time until another time in terms of the specified unit.
    `long` | Instant.`until(Temporal endExclusive, TemporalUnit unit)` Calculates the amount of time until another instant in terms of the specified unit.
    `long` | YearMonth.`until(Temporal endExclusive, TemporalUnit unit)` Calculates the amount of time until another year-month in terms of the specified unit.
    `long` | LocalDate.`until(Temporal endExclusive, TemporalUnit unit)` Calculates the amount of time until another date in terms of the specified unit.
    `long` | LocalTime.`until(Temporal endExclusive, TemporalUnit unit)` Calculates the amount of time until another time in terms of the specified unit.
    `long` | ZonedDateTime.`until(Temporal endExclusive, TemporalUnit unit)` Calculates the amount of time until another date-time in terms of the specified unit.

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

    Methods in java.time.chrono that return types with arguments of type TemporalUnit
    Modifier and Type | Method and Description
    --- | ---
    `List<TemporalUnit>` | ChronoPeriod.`getUnits()` Gets the set of units supported by this period.

    Methods in java.time.chrono with parameters of type TemporalUnit
    Modifier and Type | Method and Description
    --- | ---
    `long` | ChronoPeriod.`get(TemporalUnit unit)` Gets the value of the requested unit.
    `default boolean` | ChronoLocalDate.`isSupported(TemporalUnit unit)` Checks if the specified unit is supported.
    `default boolean` | ChronoZonedDateTime.`isSupported(TemporalUnit unit)` Checks if the specified unit is supported.
    `default boolean` | ChronoLocalDateTime.`isSupported(TemporalUnit unit)` Checks if the specified unit is supported.
    `default ChronoLocalDate` | ChronoLocalDate.`minus(long amountToSubtract, TemporalUnit unit)` Returns an object of the same type as this object with the specified period subtracted.
    `MinguoDate` | MinguoDate.`minus(long amountToAdd, TemporalUnit unit)`
    `HijrahDate` | HijrahDate.`minus(long amountToSubtract, TemporalUnit unit)`
    `default ChronoZonedDateTime<D>` | ChronoZonedDateTime.`minus(long amountToSubtract, TemporalUnit unit)` Returns an object of the same type as this object with the specified period subtracted.
    `default ChronoLocalDateTime<D>` | ChronoLocalDateTime.`minus(long amountToSubtract, TemporalUnit unit)` Returns an object of the same type as this object with the specified period subtracted.
    `ThaiBuddhistDate` | ThaiBuddhistDate.`minus(long amountToAdd, TemporalUnit unit)`
    `JapaneseDate` | JapaneseDate.`minus(long amountToAdd, TemporalUnit unit)`
    `default ChronoLocalDate` | ChronoLocalDate.`plus(long amountToAdd, TemporalUnit unit)` Returns an object of the same type as this object with the specified period added.
    `MinguoDate` | MinguoDate.`plus(long amountToAdd, TemporalUnit unit)`
    `HijrahDate` | HijrahDate.`plus(long amountToAdd, TemporalUnit unit)`
    `ChronoZonedDateTime<D>` | ChronoZonedDateTime.`plus(long amountToAdd, TemporalUnit unit)` Returns an object of the same type as this object with the specified period added.
    `ChronoLocalDateTime<D>` | ChronoLocalDateTime.`plus(long amountToAdd, TemporalUnit unit)` Returns an object of the same type as this object with the specified period added.
    `ThaiBuddhistDate` | ThaiBuddhistDate.`plus(long amountToAdd, TemporalUnit unit)`
    `JapaneseDate` | JapaneseDate.`plus(long amountToAdd, TemporalUnit unit)`
    `long` | ChronoLocalDate.`until(Temporal endExclusive, TemporalUnit unit)` Calculates the amount of time until another date in terms of the specified unit.

  - ### Uses of TemporalUnit in java.time.temporal

    Classes in java.time.temporal that implement TemporalUnit
    Modifier and Type | Class and Description
    --- | ---
    `class` | `ChronoUnit` A standard set of date periods units.

    Fields in java.time.temporal declared as TemporalUnit
    Modifier and Type | Field and Description
    --- | ---
    `static TemporalUnit` | IsoFields.`QUARTER_YEARS` Unit that represents the concept of a quarter-year.
    `static TemporalUnit` | IsoFields.`WEEK_BASED_YEARS` The unit that represents week-based-years for the purpose of addition and subtraction.
    `static TemporalUnit` | WeekFields.`WEEK_BASED_YEARS` The unit that represents week-based-years for the purpose of addition and subtraction.

    Methods in java.time.temporal that return TemporalUnit
    Modifier and Type | Method and Description
    --- | ---
    `TemporalUnit` | TemporalField.`getBaseUnit()` Gets the unit that the field is measured in.
    `TemporalUnit` | ChronoField.`getBaseUnit()`
    `TemporalUnit` | TemporalField.`getRangeUnit()` Gets the range that the field is bound by.
    `TemporalUnit` | ChronoField.`getRangeUnit()`

    Methods in java.time.temporal that return types with arguments of type TemporalUnit
    Modifier and Type | Method and Description
    --- | ---
    `List<TemporalUnit>` | TemporalAmount.`getUnits()` Returns the list of units uniquely defining the value of this TemporalAmount.
    `static TemporalQuery<TemporalUnit>` | TemporalQueries.`precision()` A query for the smallest supported unit.

    Methods in java.time.temporal with parameters of type TemporalUnit
    Modifier and Type | Method and Description
    --- | ---
    `long` | TemporalAmount.`get(TemporalUnit unit)` Returns the value of the requested unit.
    `boolean` | Temporal.`isSupported(TemporalUnit unit)` Checks if the specified unit is supported.
    `default Temporal` | Temporal.`minus(long amountToSubtract, TemporalUnit unit)` Returns an object of the same type as this object with the specified period subtracted.
    `Temporal` | Temporal.`plus(long amountToAdd, TemporalUnit unit)` Returns an object of the same type as this object with the specified period added.
    `long` | Temporal.`until(Temporal endExclusive, TemporalUnit unit)` Calculates the amount of time until another temporal in terms of the specified unit.

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.