Close

Java Date Time - Period.minusMonths() Examples

[Last Updated: Nov 8, 2025]

Java Date Time Java Java API

Class:

java.time.Period

Method:

public Period minusMonths(long monthsToSubtract)

This method returns a copy of this period with the specified months subtracted.

Examples

package com.logicbig.example.period;

import java.time.Period;

public class MinusMonthsExample {

    public static void main(String... args) {
        Period p = Period.of(100, 10, 20);
        System.out.println(p);

        Period p2 = p.minusMonths(6);
        System.out.println(p2);

        Period p3 = p.minusMonths(-500);
        System.out.println(p3);
    }
}

Output

P100Y10M20D
P100Y4M20D
P100Y510M20D

See Also