Close

Java Date Time - Period.between() Examples

[Last Updated: Nov 8, 2025]

Java Date Time Java Java API

Class:

java.time.Period

Method:

public static Period between(LocalDate startDateInclusive,
                             LocalDate endDateExclusive)

This method obtains a Period consisting of the number of years, months, and days between two provided LocalDates.

Examples

package com.logicbig.example.period;

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

public class BetweenExample {

    public static void main(String... args) {
        Period p = Period.between(LocalDate.now(), LocalDate.of(2020, 1, 1));
        System.out.println(p);
    }
}

Output

P-5Y-9M-28D

package com.logicbig.example.period;

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

public class BetweenExample2 {

    public static void main(String... args) {
        Period p = Period.between(LocalDate.of(2020, 1, 1), LocalDate.now());
        System.out.println(p);
    }
}

Output

P5Y9M28D

See Also