Функция between

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

Импорт

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

Синтаксис

public static Period between(LocalDate startDateInclusive, LocalDate endDateExclusive)

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

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

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

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

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

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