Метод minusYears

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

Синтаксис

localDate.minusYears(yearsToSubtract)

Пример

Давайте вычтем 5 лет из даты 2025-06-15:

import java.time.LocalDate;

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

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

2020-06-15

Пример

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

import java.time.LocalDate;

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

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

2028-06-15

Пример

Давайте проверим, что исходный объект не изменяется после вызова метода minusYears:

import java.time.LocalDate;

public class Main
{
	public static void main(String[] args)
	{
		LocalDate date = LocalDate.of(2025, 6, 15);
		LocalDate res = date.minusYears(10);
		System.out.println("Original: " + date);
		System.out.println("Modified: " + res);
	}
}

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

Original: 2025-06-15
Modified: 2015-06-15

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

метод plusYears,
который прибавляет годы к дате
метод minusMonths,
который вычитает месяцы из даты
метод minusDays,
который вычитает дни из даты
метод getYear,
который возвращает год из даты