java.time.Period Class in Java

The Period class in the java.time package, introduced in Java 8, represents a date-based amount of time in terms of years, months, and days. It is commonly used to calculate the difference between two dates or to add and subtract date-based values from a date.

• Represents a period using years, months, and days.
• Immutable and thread-safe.
• Useful for date calculations such as age, subscription duration, and project timelines.

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

public class Geeks {

    public static void main(String[] args) {

        LocalDate start = LocalDate.of(2022, 1, 1);
        LocalDate end = LocalDate.of(2025, 7, 9);

        Period period = Period.between(start, end);

        System.out.println("Years : " + period.getYears());
        System.out.println("Months: " + period.getMonths());
        System.out.println("Days  : " + period.getDays());
    }
}

Years : 3
Months: 6
Days  : 8

Explanation: The between() method calculates the difference between two dates and returns it as a Period object containing years, months, and days.

Syntax

public final class Period extends Object implements ChronoPeriod, Serializable

Below all the methods with the action performed by them are as follows in the tabular format are as follows:

Approach

• Import the java.time.Period and java.time.LocalDate classes.
• Create a Period object using methods such as of(), ofDays(), or between().
• Perform date calculations or modify existing periods.
• Display the resulting period or updated date.

Example 1: Using ofMonths() and minus()

import java.time.Period;

public class Geeks {

    public static void main(String[] args) {

        // Create a period of 6 months
        Period p1 = Period.ofMonths(6);

        // Subtract 2 months
        Period p2 = p1.minus(Period.ofMonths(2));

        System.out.println(p2);
    }
}

P4M

Explanation: The ofMonths(6) method creates a period of 6 months. The minus() method subtracts 2 months, resulting in a period of 4 months (P4M).

Example 2: Using ofDays() and addTo()

import java.time.*;
import java.time.temporal.Temporal;

public class Geeks {

    public static void main(String[] args) {

        // Create a period of 24 days
        Period period = Period.ofDays(24);

        // Add the period to the current date
        Temporal result = period.addTo(LocalDate.now());

        System.out.println(result);
    }
}

2026-08-02

Explanation: The ofDays(24) method creates a period of 24 days. The addTo() method adds this period to the current date and returns the updated date.

Advantages of Period Class

• Represents date-based durations using years, months, and days.
• Simplifies date calculations between two dates.
• Immutable and thread-safe.
• Provides convenient methods for adding and subtracting date-based values.
• Integrates seamlessly with other classes in the java.time API.