Функция plusWeeks

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

Импорт

import java.time.LocalDate

Синтаксис

fun plusWeeks(weeksToAdd: Long): LocalDate

Пример

Добавим 2 недели к дате "2025-01-15":

val date = LocalDate.parse("2025-01-15")
val newDate = date.plusWeeks(2)
println(newDate)

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

String "2025-01-29"

Пример

Вычтем 3 недели из даты "2025-12-25":

val date = LocalDate.parse("2025-12-25")
val newDate = date.plusWeeks(-3)
println(newDate)

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

String "2025-12-04"

Пример

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

val originalDate = LocalDate.of(2025, 3, 10)
val updatedDate = originalDate.plusWeeks(5)

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

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

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

String "Year: 2025, Month: 4, Day: 14"

Пример

Добавим 0 недель к дате (проверка неизменности исходной даты):

val date = LocalDate.parse("2025-06-20")
val sameDate = date.plusWeeks(0)
println("Original: $date")
println("Result: $sameDate")
println("Are equal: ${date == sameDate}")

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

String "Original: 2025-06-20"
String "Result: 2025-06-20"
String "Are equal: true"

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

функцию plusDays класса LocalDate,
которая добавляет дни к дате
функцию plusMonths класса LocalDate,
которая добавляет месяцы к дате
функцию plusYears класса LocalDate,
которая добавляет годы к дате
функцию minusWeeks класса LocalDate,
которая вычитает недели из даты