Функция between

Функция between класса Period вычисляет разницу между двумя датами и возвращает её в виде объекта Period, содержащего количество лет, месяцев и дней между ними. В первый параметр мы передаем начальную дату, во второй параметр - конечную дату.

Импорт

kotlinimport java.time.LocalDate
import java.time.Period

Синтаксис

kotlinpublic static Period between(LocalDate startDateInclusive, LocalDate endDateExclusive)

Пример

Вычислим период между двумя датами:

kotlinval startDate = LocalDate.of(2025, 1, 15)
val endDate = LocalDate.of(2025, 12, 31)
val period = Period.between(startDate, endDate)

println("Years: ${period.years}, Months: ${period.months}, Days: ${period.days}")

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

kotlinString "Years: 0, Months: 11, Days: 16"

Пример

Вычислим период между датами с разницей в несколько лет:

kotlinval startDate = LocalDate.of(2020, 5, 10)
val endDate = LocalDate.of(2025, 3, 25)
val period = Period.between(startDate, endDate)

println("Years: ${period.years}, Months: ${period.months}, Days: ${period.days}")

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

kotlinString "Years: 4, Months: 10, Days: 15"

Пример

Проверим период между датами, где конечная дата раньше начальной:

kotlinval startDate = LocalDate.of(2025, 8, 20)
val endDate = LocalDate.of(2025, 5, 15)
val period = Period.between(startDate, endDate)

println("Years: ${period.years}, Months: ${period.months}, Days: ${period.days}")

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

kotlinString "Years: 0, Months: -3, Days: -5"

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

  • функцию of класса Period,
    которая создает период из указанных лет, месяцев и дней
  • функцию between класса Duration,
    которая вычисляет длительность между двумя моментами времени
  • функцию until класса LocalDate,
    которая вычисляет период между двумя датами
  • класс Period,
    который представляет период времени в годах, месяцах и днях