Функция minusWeeks

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

Импорт

kotlinimport java.time.LocalDateTime

Синтаксис

kotlinfun minusWeeks(weeks: Long): LocalDateTime

Пример

Вычтем 2 недели из даты и времени "2025-03-15T10:30:00":

kotlinval dateTime = LocalDateTime.parse("2025-03-15T10:30:00")
val result = dateTime.minusWeeks(2)
println(result)

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

kotlinString "2025-03-01T10:30"

Пример

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

kotlinval currentDateTime = LocalDateTime.now()
val result = currentDateTime.minusWeeks(1)
println(result)

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

kotlinString "2025-03-03T14:25:30.123456789"

Пример

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

kotlinval dateTime = LocalDateTime.of(2025, 12, 31, 15, 45)
val newDateTime = dateTime.minusWeeks(4)

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

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

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

kotlinString "Year: 2025, Month: 12, Day: 3, Time: 15:45"

Пример

Вычтем 0 недель и убедимся, что дата не изменилась:

kotlinval originalDateTime = LocalDateTime.parse("2025-06-20T08:00:00")
val resultDateTime = originalDateTime.minusWeeks(0)
val isEqual = originalDateTime.isEqual(resultDateTime)

println("Original: $originalDateTime")
println("Result: $resultDateTime")
println("Are equal: $isEqual")

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

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

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

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