## Uses of Class
java.time.Period

- Packages that use Period
  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.

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

    Fields in java.time declared as Period
    Modifier and Type | Field | Description
    --- | --- | ---
    `static Period` | Period.`ZERO` | A constant for a period of zero.

    Methods in java.time that return Period
    Modifier and Type | Method | Description
    --- | --- | ---
    `static Period` | Period.`between​(LocalDate startDateInclusive, LocalDate endDateExclusive)` | Obtains a `Period` consisting of the number of years, months, and days between two dates.
    `static Period` | Period.`from​(TemporalAmount amount)` | Obtains an instance of `Period` from a temporal amount.
    `Period` | Period.`minus​(TemporalAmount amountToSubtract)` | Returns a copy of this period with the specified period subtracted.
    `Period` | Period.`minusDays​(long daysToSubtract)` | Returns a copy of this period with the specified days subtracted.
    `Period` | Period.`minusMonths​(long monthsToSubtract)` | Returns a copy of this period with the specified months subtracted.
    `Period` | Period.`minusYears​(long yearsToSubtract)` | Returns a copy of this period with the specified years subtracted.
    `Period` | Period.`multipliedBy​(int scalar)` | Returns a new instance with each element in this period multiplied by the specified scalar.
    `Period` | Period.`negated()` | Returns a new instance with each amount in this period negated.
    `Period` | Period.`normalized()` | Returns a copy of this period with the years and months normalized.
    `static Period` | Period.`of​(int years, int months, int days)` | Obtains a `Period` representing a number of years, months and days.
    `static Period` | Period.`ofDays​(int days)` | Obtains a `Period` representing a number of days.
    `static Period` | Period.`ofMonths​(int months)` | Obtains a `Period` representing a number of months.
    `static Period` | Period.`ofWeeks​(int weeks)` | Obtains a `Period` representing a number of weeks.
    `static Period` | Period.`ofYears​(int years)` | Obtains a `Period` representing a number of years.
    `static Period` | Period.`parse​(CharSequence text)` | Obtains a `Period` from a text string such as `PnYnMnD`.
    `Period` | Period.`plus​(TemporalAmount amountToAdd)` | Returns a copy of this period with the specified period added.
    `Period` | Period.`plusDays​(long daysToAdd)` | Returns a copy of this period with the specified days added.
    `Period` | Period.`plusMonths​(long monthsToAdd)` | Returns a copy of this period with the specified months added.
    `Period` | Period.`plusYears​(long yearsToAdd)` | Returns a copy of this period with the specified years added.
    `Period` | LocalDate.`until​(ChronoLocalDate endDateExclusive)` | Calculates the period between this date and another date as a `Period`.
    `Period` | Period.`withDays​(int days)` | Returns a copy of this period with the specified amount of days.
    `Period` | Period.`withMonths​(int months)` | Returns a copy of this period with the specified amount of months.
    `Period` | Period.`withYears​(int years)` | Returns a copy of this period with the specified amount of years.

    Methods in java.time with parameters of type Period
    Modifier and Type | Method | Description
    --- | --- | ---
    `Stream<LocalDate>` | LocalDate.`datesUntil​(LocalDate endExclusive, Period step)` | Returns a sequential ordered stream of dates by given incremental step.

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

    Methods in java.time.chrono that return Period
    Modifier and Type | Method | Description
    --- | --- | ---
    `Period` | IsoChronology.`period​(int years, int months, int days)` | Obtains a period for this chronology based on years, months and days.

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

    Methods in java.time.format that return types with arguments of type Period
    Modifier and Type | Method | Description
    --- | --- | ---
    `static TemporalQuery<Period>` | DateTimeFormatter.`parsedExcessDays()` | A query that provides access to the excess days that were parsed.