Функция minusWeeks

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

Импорт

import java.time.LocalDateTime

Синтаксис

fun minusWeeks(weeks: Long): LocalDateTime

Пример

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

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

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

String "2025-03-01T10:30"

Пример

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

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

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

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

Пример

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

val 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")

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

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

Пример

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

val 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")

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

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

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

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