Функция minusWeeks

Функция minusWeeks класса LocalDate вычитает указанное количество недель из текущей даты и возвращает новый объект LocalDate. Исходный объект LocalDate остается неизменным. В параметр мы передаем количество недель для вычитания.

Импорт

import java.time.LocalDate

Синтаксис

fun minusWeeks(weeksToSubtract: Long): LocalDate

Пример

Вычтем 2 недели из даты "2025-03-15":

val date = LocalDate.parse("2025-03-15")
val newDate = date.minusWeeks(2)
println(newDate)

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

String "2025-03-01"

Пример

Вычтем 1 неделю из текущей даты:

val currentDate = LocalDate.now()
val weekAgo = currentDate.minusWeeks(1)
println(weekAgo)

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

String "2025-09-03"

Пример

Вычтем несколько недель и получим компоненты новой даты:

val date = LocalDate.of(2025, 12, 31)
val resultDate = date.minusWeeks(4)

val year = resultDate.year
val month = resultDate.monthValue
val day = resultDate.dayOfMonth

println("Year: $year, Month: $month, Day: $day")

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

String "Year: 2025, Month: 12, Day: 3"

Пример

Вычтем 0 недель (дата останется неизменной):

val originalDate = LocalDate.parse("2025-06-20")
val sameDate = originalDate.minusWeeks(0)
println(sameDate)

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

String "2025-06-20"

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

функцию plusWeeks класса LocalDate,
которая прибавляет недели к дате
функцию minusDays класса LocalDate,
которая вычитает дни из даты
функцию minusMonths класса LocalDate,
которая вычитает месяцы из даты
функцию now класса LocalDate,
которая возвращает текущую дату