Método GregorianCalendar getLeastMaximum() en Java

El método java.util.GregorianCalendar.getLeastMaximum() es una función integrada en Java que devuelve el valor máximo más bajo para un campo de calendario, pasado como parámetro a la función, de esta instancia de GregorianCalendar. El valor máximo más bajo para cualquier valor de tiempo posible se define como el valor más grande devuelto por el método get con los valores actuales de los métodos getFirstDayOfWeek , getMinimalDaysInFirstWeek , getGregorianChange y getTimeZone , todos tomados en consideración.
Sintaxis: 
 

public int getMaximum(int calendarfield)

Parámetros: esta función acepta un parámetro obligatorio calendarfield de tipo entero que hace referencia al campo de calendario cuyo valor máximo más bajo devolverá la función.
Valor devuelto: este método devuelve un valor entero que es igual al valor máximo más bajo para el campo de calendario especificado.
Ejemplos: 
 

Input : DAY_OF_MONTH
Output : 28

Input : WEEK_OF_MONTH
Output : 3

Los siguientes programas ilustran el funcionamiento de la función java.util.GregorianCalendar.getMaximum() :
Programa 1:
 

// Java program to illustrate getLeastMaximum()
 
import java.io.*;
import java.util.*;
 
class GFG {
     public static void main(String[] args) {
     
      // Create a new calendar
      GregorianCalendar cal = (GregorianCalendar)
                  GregorianCalendar.getInstance();
 
      // Display the current date and time
      System.out.println("Current Date and Time : "
                                   + cal.getTime());
 
      // Get lowest maximum for WEEK_OF_MONTH
      int maxm = cal.getLeastMaximum(
                   GregorianCalendar.WEEK_OF_MONTH);
      System.out.println("Lowest Maximum for"+
                   " WEEK_OF_MONTH field :" + maxm);
 
      // Get lowest maximum for DAY_OF_MONTH
      maxm = cal.getLeastMaximum(
                    GregorianCalendar.DAY_OF_MONTH);
      System.out.println("Lowest Maximum for"+
                     " DAY_OF_MONTH field:" + maxm);
   }
}

Current Date and Time : Wed Aug 01 06:48:43 UTC 2018
Lowest Maximum for WEEK_OF_MONTH field :3
Lowest Maximum for DAY_OF_MONTH field:28

Programa 2:
 

// Java program to illustrate getLeastMaximum()
 
import java.io.*;
import java.util.*;
 
class GFG {
     public static void main(String[] args) {
     
      // Create a new calendar
      GregorianCalendar cal = (GregorianCalendar)
                  GregorianCalendar.getInstance();
 
      // Display the current date and time
      System.out.println("Current Date and Time : "
                                  + cal.getTime());
 
      // Get lowest maximum for YEAR
      int maxm = cal.getLeastMaximum(
                           GregorianCalendar.YEAR);
      System.out.println("Lowest Maximum for"+
                           " YEAR field :" + maxm);
 
      // Get lowest maximum for HOUR_OF_DAY
      maxm = cal.getLeastMaximum(
                    GregorianCalendar.HOUR_OF_DAY);
      System.out.println("Lowest Maximum for"+
                     " HOUR_OF_DAY field:" + maxm);
   }
}

Current Date and Time : Wed Aug 01 06:48:45 UTC 2018
Lowest Maximum for YEAR field :292269054
Lowest Maximum for HOUR_OF_DAY field:23

Referencia: https://docs.oracle.com/javase/7/docs/api/java/util/GregorianCalendar.html#getLeastMaximum()