Uses of Interface java.time.temporal.TemporalField (Java Platform SE 8 )
Date: 2026-04-17

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

- Packages that use TemporalField
  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.format | Provides classes to print and parse dates and times.
  java.time.temporal | Access to date and time using fields and units, and date time adjusters.

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

    Methods in java.time with parameters of type TemporalField
    Modifier and Type | Method and Description
    --- | ---
    `int` | Month.`get(TemporalField field)` Gets the value of the specified field from this month-of-year as an `int`.
    `int` | MonthDay.`get(TemporalField field)` Gets the value of the specified field from this month-day as an `int`.
    `int` | LocalDateTime.`get(TemporalField field)` Gets the value of the specified field from this date-time as an `int`.
    `int` | OffsetTime.`get(TemporalField field)` Gets the value of the specified field from this time as an `int`.
    `int` | ZonedDateTime.`get(TemporalField field)` Gets the value of the specified field from this date-time as an `int`.
    `int` | ZoneOffset.`get(TemporalField field)` Gets the value of the specified field from this offset as an `int`.
    `int` | LocalTime.`get(TemporalField field)` Gets the value of the specified field from this time as an `int`.
    `int` | OffsetDateTime.`get(TemporalField field)` Gets the value of the specified field from this date-time as an `int`.
    `int` | DayOfWeek.`get(TemporalField field)` Gets the value of the specified field from this day-of-week as an `int`.
    `int` | Instant.`get(TemporalField field)` Gets the value of the specified field from this instant as an `int`.
    `int` | Year.`get(TemporalField field)` Gets the value of the specified field from this year as an `int`.
    `int` | YearMonth.`get(TemporalField field)` Gets the value of the specified field from this year-month as an `int`.
    `int` | LocalDate.`get(TemporalField field)` Gets the value of the specified field from this date as an `int`.
    `long` | Month.`getLong(TemporalField field)` Gets the value of the specified field from this month-of-year as a `long`.
    `long` | MonthDay.`getLong(TemporalField field)` Gets the value of the specified field from this month-day as a `long`.
    `long` | LocalDateTime.`getLong(TemporalField field)` Gets the value of the specified field from this date-time as a `long`.
    `long` | OffsetTime.`getLong(TemporalField field)` Gets the value of the specified field from this time as a `long`.
    `long` | ZonedDateTime.`getLong(TemporalField field)` Gets the value of the specified field from this date-time as a `long`.
    `long` | ZoneOffset.`getLong(TemporalField field)` Gets the value of the specified field from this offset as a `long`.
    `long` | LocalTime.`getLong(TemporalField field)` Gets the value of the specified field from this time as a `long`.
    `long` | OffsetDateTime.`getLong(TemporalField field)` Gets the value of the specified field from this date-time as a `long`.
    `long` | DayOfWeek.`getLong(TemporalField field)` Gets the value of the specified field from this day-of-week as a `long`.
    `long` | Instant.`getLong(TemporalField field)` Gets the value of the specified field from this instant as a `long`.
    `long` | Year.`getLong(TemporalField field)` Gets the value of the specified field from this year as a `long`.
    `long` | YearMonth.`getLong(TemporalField field)` Gets the value of the specified field from this year-month as a `long`.
    `long` | LocalDate.`getLong(TemporalField field)` Gets the value of the specified field from this date as a `long`.
    `boolean` | Month.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `boolean` | MonthDay.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `boolean` | LocalDateTime.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `boolean` | OffsetTime.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `boolean` | ZonedDateTime.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `boolean` | ZoneOffset.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `boolean` | LocalTime.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `boolean` | OffsetDateTime.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `boolean` | DayOfWeek.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `boolean` | Instant.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `boolean` | Year.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `boolean` | YearMonth.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `boolean` | LocalDate.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `ValueRange` | Month.`range(TemporalField field)` Gets the range of valid values for the specified field.
    `ValueRange` | MonthDay.`range(TemporalField field)` Gets the range of valid values for the specified field.
    `ValueRange` | LocalDateTime.`range(TemporalField field)` Gets the range of valid values for the specified field.
    `ValueRange` | OffsetTime.`range(TemporalField field)` Gets the range of valid values for the specified field.
    `ValueRange` | ZonedDateTime.`range(TemporalField field)` Gets the range of valid values for the specified field.
    `ValueRange` | ZoneOffset.`range(TemporalField field)` Gets the range of valid values for the specified field.
    `ValueRange` | LocalTime.`range(TemporalField field)` Gets the range of valid values for the specified field.
    `ValueRange` | OffsetDateTime.`range(TemporalField field)` Gets the range of valid values for the specified field.
    `ValueRange` | DayOfWeek.`range(TemporalField field)` Gets the range of valid values for the specified field.
    `ValueRange` | Instant.`range(TemporalField field)` Gets the range of valid values for the specified field.
    `ValueRange` | Year.`range(TemporalField field)` Gets the range of valid values for the specified field.
    `ValueRange` | YearMonth.`range(TemporalField field)` Gets the range of valid values for the specified field.
    `ValueRange` | LocalDate.`range(TemporalField field)` Gets the range of valid values for the specified field.
    `LocalDateTime` | LocalDateTime.`with(TemporalField field, long newValue)` Returns a copy of this date-time with the specified field set to a new value.
    `OffsetTime` | OffsetTime.`with(TemporalField field, long newValue)` Returns a copy of this time with the specified field set to a new value.
    `ZonedDateTime` | ZonedDateTime.`with(TemporalField field, long newValue)` Returns a copy of this date-time with the specified field set to a new value.
    `LocalTime` | LocalTime.`with(TemporalField field, long newValue)` Returns a copy of this time with the specified field set to a new value.
    `OffsetDateTime` | OffsetDateTime.`with(TemporalField field, long newValue)` Returns a copy of this date-time with the specified field set to a new value.
    `Instant` | Instant.`with(TemporalField field, long newValue)` Returns a copy of this instant with the specified field set to a new value.
    `Year` | Year.`with(TemporalField field, long newValue)` Returns a copy of this year with the specified field set to a new value.
    `YearMonth` | YearMonth.`with(TemporalField field, long newValue)` Returns a copy of this year-month with the specified field set to a new value.
    `LocalDate` | LocalDate.`with(TemporalField field, long newValue)` Returns a copy of this date with the specified field set to a new value.

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

    Methods in java.time.chrono with parameters of type TemporalField
    Modifier and Type | Method and Description
    --- | ---
    `default int` | ChronoZonedDateTime.`get(TemporalField field)`
    `default int` | Era.`get(TemporalField field)` Gets the value of the specified field from this era as an `int`.
    `long` | JapaneseDate.`getLong(TemporalField field)`
    `default long` | ChronoZonedDateTime.`getLong(TemporalField field)`
    `long` | HijrahDate.`getLong(TemporalField field)`
    `default long` | Era.`getLong(TemporalField field)` Gets the value of the specified field from this era as a `long`.
    `long` | ThaiBuddhistDate.`getLong(TemporalField field)`
    `long` | MinguoDate.`getLong(TemporalField field)`
    `boolean` | JapaneseDate.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `boolean` | ChronoZonedDateTime.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `default boolean` | ChronoLocalDate.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `default boolean` | Era.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `boolean` | ChronoLocalDateTime.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `ValueRange` | JapaneseDate.`range(TemporalField field)`
    `default ValueRange` | ChronoZonedDateTime.`range(TemporalField field)`
    `ValueRange` | HijrahDate.`range(TemporalField field)`
    `default ValueRange` | Era.`range(TemporalField field)` Gets the range of valid values for the specified field.
    `ValueRange` | ThaiBuddhistDate.`range(TemporalField field)`
    `ValueRange` | HijrahEra.`range(TemporalField field)` Gets the range of valid values for the specified field.
    `ValueRange` | JapaneseEra.`range(TemporalField field)` Gets the range of valid values for the specified field.
    `ValueRange` | MinguoDate.`range(TemporalField field)`
    `JapaneseDate` | JapaneseDate.`with(TemporalField field, long newValue)`
    `ChronoZonedDateTime<D>` | ChronoZonedDateTime.`with(TemporalField field, long newValue)` Returns an object of the same type as this object with the specified field altered.
    `HijrahDate` | HijrahDate.`with(TemporalField field, long newValue)`
    `default ChronoLocalDate` | ChronoLocalDate.`with(TemporalField field, long newValue)` Returns an object of the same type as this object with the specified field altered.
    `ThaiBuddhistDate` | ThaiBuddhistDate.`with(TemporalField field, long newValue)`
    `MinguoDate` | MinguoDate.`with(TemporalField field, long newValue)`
    `ChronoLocalDateTime<D>` | ChronoLocalDateTime.`with(TemporalField field, long newValue)` Returns an object of the same type as this object with the specified field altered.

    Method parameters in java.time.chrono with type arguments of type TemporalField
    Modifier and Type | Method and Description
    --- | ---
    `ChronoLocalDate` | AbstractChronology.`resolveDate(Map<TemporalField,Long> fieldValues, ResolverStyle resolverStyle)` Resolves parsed `ChronoField` values into a date during parsing.
    `MinguoDate` | MinguoChronology.`resolveDate(Map<TemporalField,Long> fieldValues, ResolverStyle resolverStyle)`
    `ThaiBuddhistDate` | ThaiBuddhistChronology.`resolveDate(Map<TemporalField,Long> fieldValues, ResolverStyle resolverStyle)`
    `JapaneseDate` | JapaneseChronology.`resolveDate(Map<TemporalField,Long> fieldValues, ResolverStyle resolverStyle)`
    `ChronoLocalDate` | Chronology.`resolveDate(Map<TemporalField,Long> fieldValues, ResolverStyle resolverStyle)` Resolves parsed `ChronoField` values into a date during parsing.
    `LocalDate` | IsoChronology.`resolveDate(Map<TemporalField,Long> fieldValues, ResolverStyle resolverStyle)` Resolves parsed `ChronoField` values into a date during parsing.
    `HijrahDate` | HijrahChronology.`resolveDate(Map<TemporalField,Long> fieldValues, ResolverStyle resolverStyle)`

  - ### Uses of TemporalField in java.time.format

    Methods in java.time.format that return types with arguments of type TemporalField
    Modifier and Type | Method and Description
    --- | ---
    `Set<TemporalField>` | DateTimeFormatter.`getResolverFields()` Gets the resolver fields to use during parsing.

    Methods in java.time.format with parameters of type TemporalField
    Modifier and Type | Method and Description
    --- | ---
    `DateTimeFormatterBuilder` | DateTimeFormatterBuilder.`appendFraction(TemporalField field, int minWidth, int maxWidth, boolean decimalPoint)` Appends the fractional value of a date-time field to the formatter.
    `DateTimeFormatterBuilder` | DateTimeFormatterBuilder.`appendText(TemporalField field)` Appends the text of a date-time field to the formatter using the full text style.
    `DateTimeFormatterBuilder` | DateTimeFormatterBuilder.`appendText(TemporalField field, Map<Long,String> textLookup)` Appends the text of a date-time field to the formatter using the specified map to supply the text.
    `DateTimeFormatterBuilder` | DateTimeFormatterBuilder.`appendText(TemporalField field, TextStyle textStyle)` Appends the text of a date-time field to the formatter.
    `DateTimeFormatterBuilder` | DateTimeFormatterBuilder.`appendValue(TemporalField field)` Appends the value of a date-time field to the formatter using a normal output style.
    `DateTimeFormatterBuilder` | DateTimeFormatterBuilder.`appendValue(TemporalField field, int width)` Appends the value of a date-time field to the formatter using a fixed width, zero-padded approach.
    `DateTimeFormatterBuilder` | DateTimeFormatterBuilder.`appendValue(TemporalField field, int minWidth, int maxWidth, SignStyle signStyle)` Appends the value of a date-time field to the formatter providing full control over formatting.
    `DateTimeFormatterBuilder` | DateTimeFormatterBuilder.`appendValueReduced(TemporalField field, int width, int maxWidth, ChronoLocalDate baseDate)` Appends the reduced value of a date-time field to the formatter.
    `DateTimeFormatterBuilder` | DateTimeFormatterBuilder.`appendValueReduced(TemporalField field, int width, int maxWidth, int baseValue)` Appends the reduced value of a date-time field to the formatter.
    `DateTimeFormatterBuilder` | DateTimeFormatterBuilder.`parseDefaulting(TemporalField field, long value)` Appends a default value for a field to the formatter for use in parsing.
    `DateTimeFormatter` | DateTimeFormatter.`withResolverFields(TemporalField... resolverFields)` Returns a copy of this formatter with a new set of resolver fields.

    Method parameters in java.time.format with type arguments of type TemporalField
    Modifier and Type | Method and Description
    --- | ---
    `DateTimeFormatter` | DateTimeFormatter.`withResolverFields(Set<TemporalField> resolverFields)` Returns a copy of this formatter with a new set of resolver fields.

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

    Classes in java.time.temporal that implement TemporalField
    Modifier and Type | Class and Description
    --- | ---
    `class` | `ChronoField` A standard set of fields.

    Fields in java.time.temporal declared as TemporalField
    Modifier and Type | Field and Description
    --- | ---
    `static TemporalField` | IsoFields.`DAY_OF_QUARTER` The field that represents the day-of-quarter.
    `static TemporalField` | JulianFields.`JULIAN_DAY` Julian Day field.
    `static TemporalField` | JulianFields.`MODIFIED_JULIAN_DAY` Modified Julian Day field.
    `static TemporalField` | IsoFields.`QUARTER_OF_YEAR` The field that represents the quarter-of-year.
    `static TemporalField` | JulianFields.`RATA_DIE` Rata Die field.
    `static TemporalField` | IsoFields.`WEEK_BASED_YEAR` The field that represents the week-based-year.
    `static TemporalField` | IsoFields.`WEEK_OF_WEEK_BASED_YEAR` The field that represents the week-of-week-based-year.

    Methods in java.time.temporal that return TemporalField
    Modifier and Type | Method and Description
    --- | ---
    `TemporalField` | WeekFields.`dayOfWeek()` Returns a field to access the day of week based on this `WeekFields`.
    `TemporalField` | WeekFields.`weekBasedYear()` Returns a field to access the year of a week-based-year based on this `WeekFields`.
    `TemporalField` | WeekFields.`weekOfMonth()` Returns a field to access the week of month based on this `WeekFields`.
    `TemporalField` | WeekFields.`weekOfWeekBasedYear()` Returns a field to access the week of a week-based-year based on this `WeekFields`.
    `TemporalField` | WeekFields.`weekOfYear()` Returns a field to access the week of year based on this `WeekFields`.

    Methods in java.time.temporal with parameters of type TemporalField
    Modifier and Type | Method and Description
    --- | ---
    `int` | ValueRange.`checkValidIntValue(long value, TemporalField field)` Checks that the specified value is valid and fits in an `int`.
    `long` | ValueRange.`checkValidValue(long value, TemporalField field)` Checks that the specified value is valid.
    `default int` | TemporalAccessor.`get(TemporalField field)` Gets the value of the specified field as an `int`.
    `long` | TemporalAccessor.`getLong(TemporalField field)` Gets the value of the specified field as a `long`.
    `boolean` | TemporalAccessor.`isSupported(TemporalField field)` Checks if the specified field is supported.
    `default ValueRange` | TemporalAccessor.`range(TemporalField field)` Gets the range of valid values for the specified field.
    `Temporal` | Temporal.`with(TemporalField field, long newValue)` Returns an object of the same type as this object with the specified field altered.

    Method parameters in java.time.temporal with type arguments of type TemporalField
    Modifier and Type | Method and Description
    --- | ---
    `default TemporalAccessor` | TemporalField.`resolve(Map<TemporalField,Long> fieldValues, TemporalAccessor partialTemporal, ResolverStyle resolverStyle)` Resolves this field to provide a simpler alternative or a date.

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.