Period normalized() method in Java with Examples

The normalized() method of Period class in Java is used to return a new instance of Period after normalizing years and months.

Syntax:

public Period normalized()

Parameters: This function does not accepts any parameter.

Return Value: This function returns a new instance of Period after normalizing year and month of the period.

Exceptions: It throws an ArithmeticException. This exception is caught if numeric overflow occurs.

Below program illustrates the above method:

Program 1:

// Java code to show the function to normalize
// months and years of the period
import java.time.Period;
import java.time.temporal.ChronoUnit;

public class PeriodClass {

    // Function to normalize given periods
    static void toNormalize(Period p1)
    {

        System.out.println(p1.normalized());
    }

    // Driver Code
    public static void main(String[] args)
    {
        // Defining period
        int year = 4;
        int months = 15;
        int days = 10;
        Period p1 = Period.of(year, months, days);

        toNormalize(p1);
    }
}

Output:

P5Y3M10D

Program 2: This will not normalize the number of days.

// Java code to show the function to normalize
// months and years of the period
import java.time.Period;
import java.time.temporal.ChronoUnit;

public class PeriodClass {

    // Function to normalize given periods
    static void toNormalize(Period p1)
    {

        System.out.println(p1.normalized());
    }

    // Driver Code
    public static void main(String[] args)
    {
        // Defining period
        int year = 10;
        int months = 25;
        int days = 366;
        Period p1 = Period.of(year, months, days);

        toNormalize(p1);
    }
}

Output:

P12Y1M366D

Reference: https://docs.oracle.com/javase/8/docs/api/java/time/Period.html#normalized–