java/time/Year.java

18  * 2 along with this work; if not, write to the Free Software Foundation,
36  * Redistribution and use in source and binary forms, with or without
44  *    and/or other materials provided with the distribution.
105  * <b>Note that years in the ISO chronology only align with years in the
108  * As such, historical years must be treated with caution.</b>
302      * remainder. However, years divisible by 100, are not leap years, with
347      * {@link #get(TemporalField) get} and {@link #with(TemporalField, long)}
515      * remainder. However, years divisible by 100, are not leap years, with
557      * This returns a {@code Year}, based on this one, with the year adjusted.
568      * @return a {@code Year} based on {@code this} with the adjustment made, not null
573     public Year with(TemporalAdjuster adjuster) {
578      * Returns a copy of this year with the specified field set to a new value.
580      * This returns a {@code Year}, based on this one, with the value
589      *  Returns a {@code Year} with the specified year-of-era
592      *  Returns a {@code Year} with the specified year.
595      *  Returns a {@code Year} with the specified era.
613      * @return a {@code Year} based on {@code this} with the specified field set, not null
619     public Year with(TemporalField field, long newValue) {
635      * Returns a copy of this year with the specified amount added.
637      * This returns a {@code Year}, based on this one, with the specified amount added.
650      * @return a {@code Year} based on this year with the addition made, not null
660      * Returns a copy of this year with the specified amount added.
662      * This returns a {@code Year}, based on this one, with the amount
670      *  Returns a {@code Year} with the specified number of years added.
673      *  Returns a {@code Year} with the specified number of decades added.
674      *  This is equivalent to calling {@link #plusYears(long)} with the amount
677      *  Returns a {@code Year} with the specified number of centuries added.
678      *  This is equivalent to calling {@link #plusYears(long)} with the amount
681      *  Returns a {@code Year} with the specified number of millennia added.
682      *  This is equivalent to calling {@link #plusYears(long)} with the amount
685      *  Returns a {@code Year} with the specified number of eras added.
702      * @return a {@code Year} based on this year with the specified amount added, not null
715                 case ERAS: return with(ERA, Math.addExact(getLong(ERA), amountToAdd));
723      * Returns a copy of this {@code Year} with the specified number of years added.
728      * @return a {@code Year} based on this year with the years added, not null
740      * Returns a copy of this year with the specified amount subtracted.
742      * This returns a {@code Year}, based on this one, with the specified amount subtracted.
755      * @return a {@code Year} based on this year with the subtraction made, not null
765      * Returns a copy of this year with the specified amount subtracted.
767      * This returns a {@code Year}, based on this one, with the amount
771      * This method is equivalent to {@link #plus(long, TemporalUnit)} with the amount negated.
778      * @return a {@code Year} based on this year with the specified amount subtracted, not null
789      * Returns a copy of this {@code Year} with the specified number of years subtracted.
794      * @return a {@code Year} based on this year with the year subtracted, not null
835      * with the year changed to be the same as this.
837      * The adjustment is equivalent to using {@link Temporal#with(TemporalField, long)}
843      * {@link Temporal#with(TemporalAdjuster)}:
847      *   temporal = temporal.with(thisYear);
862         return temporal.with(YEAR, year);
945      * Combines this year with a day-of-year to create a {@code LocalDate}.
961      * Combines this year with a month to create a {@code YearMonth}.
979      * Combines this year with a month to create a {@code YearMonth}.
998      * Combines this year with a month-day to create a {@code LocalDate}.
1017      * It is "consistent with equals", as defined by {@link Comparable}.