Функция plusWeeks

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

Импорт

import java.time.LocalDateTime

Синтаксис

fun plusWeeks(weeksToAdd: Long): LocalDateTime

Пример

Добавим 2 недели к дате и времени "2025-03-10T12:30:00":

val dateTime = LocalDateTime.parse("2025-03-10T12:30:00")
val newDateTime = dateTime.plusWeeks(2)
println(newDateTime)

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

String "2025-03-24T12:30:00"

Пример

Добавим 1 неделю и выведем отдельные компоненты даты и времени:

val dateTime = LocalDateTime.of(2025, 6, 15, 14, 45)
val newDateTime = dateTime.plusWeeks(1)

val year = newDateTime.year
val month = newDateTime.monthValue
val day = newDateTime.dayOfMonth
val hour = newDateTime.hour

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

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

String "Year: 2025, Month: 6, Day: 22, Hour: 14"

Пример

Добавим отрицательное количество недель (вычтем недели):

val dateTime = LocalDateTime.parse("2025-12-25T10:00:00")
val newDateTime = dateTime.plusWeeks(-3)
println(newDateTime)

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

String "2025-12-04T10:00:00"

Пример

Добавим 0 недель и убедимся, что объект не изменился:

val originalDateTime = LocalDateTime.of(2025, 8, 20, 9, 30)
val sameDateTime = originalDateTime.plusWeeks(0)

println("Original: $originalDateTime")
println("Result: $sameDateTime")
println("Are equal: ${originalDateTime == sameDateTime}")

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

String "Original: 2025-08-20T09:30"
String "Result: 2025-08-20T09:30"
String "Are equal: true"

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

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