ZonedDateTime plusMinutes() method in Java with Examples

0 0 1 minute read

plusMinutes() method of a ZonedDateTime class used to add the number of minutes in this ZonedDateTime and return a copy of ZonedDateTime after addition.This method operates on the instant time-line, such that adding one minute will always be a duration of one minute later. This instance is immutable and unaffected by this method call.

Syntax:

public ZonedDateTime plusMinutes(long minutes)

Parameters: This method accepts a single parameter minutes which represents the minutes to add, It can be negative.

Return value: This method returns a ZonedDateTime based on this date-time with the minutes added, not null.

Exception: This method throws DateTimeException if the result exceeds the supported date range.

Below programs illustrate the plusMinutes() method:
Program 1:

// Java program to demonstrate
// ZonedDateTime.plusMinutes() method
  
import java.time.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a ZonedDateTime object
        ZonedDateTime zoneddatetime
            = ZonedDateTime.parse(
                "2018-12-06T19:21:12.123+05:30[Asia/Calcutta]");
  
        // print instance
        System.out.println("ZonedDateTime before"
                           + " adding minutes: "
                           + zoneddatetime);
  
        // add 3 minutes
        ZonedDateTime returnvalue
            = zoneddatetime.plusMinutes(3);
  
        // print result
        System.out.println("ZonedDateTime after "
                           + " adding minutes: "
                           + returnvalue);
    }
}

Output:

ZonedDateTime before adding minutes: 2018-12-06T19:21:12.123+05:30[Asia/Calcutta]ZonedDateTime after adding minutes: 2018-12-06T19:24:12.123+05:30[Asia/Calcutta]

Program 2:

// Java program to demonstrate
// ZonedDateTime.plusMinutes() method
  
import java.time.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a ZonedDateTime object
        ZonedDateTime zoneddatetime
            = ZonedDateTime.parse(
                "2018-10-25T23:12:31.123+02:00[Europe/Paris]");
  
        // print instance
        System.out.println("ZonedDateTime before"
                           + " adding minutes: "
                           + zoneddatetime);
  
        // add 20 minutes
        ZonedDateTime returnvalue
            = zoneddatetime.plusMinutes(20);
  
        // print result
        System.out.println("ZonedDateTime after "
                           + " adding minutes: "
                           + returnvalue);
    }
}

Output:

ZonedDateTime before adding minutes: 2018-10-25T23:12:31.123+02:00[Europe/Paris]ZonedDateTime after adding minutes: 2018-10-25T23:32:31.123+02:00[Europe/Paris]

Reference: https://docs.oracle.com/javase/10/docs/api/java/time/ZonedDateTime.html#plusMinutes(long)