Функция plusDays

Функция plusDays класса LocalDateTime добавляет указанное количество дней к текущей дате и времени и возвращает новый объект LocalDateTime. Исходный объект остается неизменным, так как все классы из пакета java.time являются иммутабельными. В параметр мы передаем количество дней для добавления (может быть отрицательным для вычитания).

Импорт

import java.time.LocalDateTime

Синтаксис

fun plusDays(days: Long): LocalDateTime

Пример

Добавим 5 дней к дате и времени "2025-03-15T10:30:00":

val dateTime = LocalDateTime.parse("2025-03-15T10:30:00")
val newDateTime = dateTime.plusDays(5)
println(newDateTime)

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

String "2025-03-20T10:30:00"

Пример

Вычтем 10 дней из даты и времени "2025-12-25T15:45:00":

val dateTime = LocalDateTime.parse("2025-12-25T15:45:00")
val newDateTime = dateTime.plusDays(-10)
println(newDateTime)

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

String "2025-12-15T15:45:00"

Пример

Добавим дни к текущей дате и времени:

val currentDateTime = LocalDateTime.now()
val futureDateTime = currentDateTime.plusDays(30)
println("Current: $currentDateTime")
println("After 30 days: $futureDateTime")

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

String "Current: 2025-09-10T14:25:30.123456789, After 30 days: 2025-10-10T14:25:30.123456789"

Пример

Проверим корректность обработки перехода через месяц:

val dateTime = LocalDateTime.of(2025, 1, 28, 12, 0)
val newDateTime = dateTime.plusDays(5)
println(newDateTime)

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

String "2025-02-02T12:00:00"

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

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