Метод plusYears

Метод plusYears класса LocalDate прибавляет указанное количество лет к дате и возвращает новый объект LocalDate. Исходный объект при этом не изменяется, так как LocalDate является неизменяемым классом. В параметр мы передаем количество лет, которое нужно прибавить к дате. Значение может быть отрицательным, тогда произойдет вычитание лет.

Синтаксис

localDate.plusYears(yearsToAdd)

Пример

Давайте прибавим 5 лет к дате:

import java.time.LocalDate;

public class Main
{
	public static void main(String[] args)
	{
		LocalDate date = LocalDate.of(2025, 3, 15);
		LocalDate res = date.plusYears(5);
		System.out.println(res);
	}
}

Результат выполнения кода:

2030-03-15

Пример

Давайте прибавим 1 год к 29 февраля високосного года. В невисокосном году дата скорректируется на 28 февраля:

import java.time.LocalDate;

public class Main
{
	public static void main(String[] args)
	{
		LocalDate date = LocalDate.of(2024, 2, 29);
		LocalDate res = date.plusYears(1);
		System.out.println(res);
	}
}

Результат выполнения кода:

2025-02-28

Пример

Если передать отрицательное значение, метод вычтет указанное количество лет:

import java.time.LocalDate;

public class Main
{
	public static void main(String[] args)
	{
		LocalDate date = LocalDate.of(2025, 6, 10);
		LocalDate res = date.plusYears(-3);
		System.out.println(res);
	}
}

Результат выполнения кода:

2022-06-10

Смотрите также

метод minusYears,
который вычитает годы из даты
метод plusMonths,
который прибавляет месяцы к дате
метод plusDays,
который прибавляет дни к дате
класс LocalDate,
который представляет дату без времени