/**
* Returns a copy of this {@code OffsetDateTime} with the year altered.
* <p>
* The time and offset do not affect the calculation and will be the same in the result.
* If the day-of-month is invalid for the year, it will be changed to the last valid day of the month.
* <p>
* This instance is immutable and unaffected by this method call.
*
* @param int $year the year to set in the result, from MIN_YEAR to MAX_YEAR
* @return OffsetDateTime an {@code OffsetDateTime} based on this date-time with the requested year, not null
* @throws DateTimeException if the year value is invalid
*/
public function withYear($year)
{
return $this->_with($this->dateTime->withYear($year), $this->offset);
}
/**
* Returns a copy of this {@code ZonedDateTime} with the year altered.
* <p>
* This operates on the local time-line,
* {@link LocalDateTime#withYear(int) changing the year} of the local date-time.
* This is then converted back to a {@code ZonedDateTime}, using the zone ID
* to obtain the offset.
* <p>
* When converting back to {@code ZonedDateTime}, if the local date-time is in an overlap,
* then the offset will be retained if possible, otherwise the earlier offset will be used.
* If in a gap, the local date-time will be adjusted forward by the length of the gap.
* <p>
* This instance is immutable and unaffected by this method call.
*
* @param int $year the year to set in the result, from MIN_YEAR to MAX_YEAR
* @return ZonedDateTime a {@code ZonedDateTime} based on this date-time with the requested year, not null
* @throws DateTimeException if the year value is invalid
*/
public function withYear($year)
{
return $this->resolveLocal($this->dateTime->withYear($year));
}
