Método ZonedDateTime plus() en Java con ejemplos

En la clase ZonedDateTime, hay dos tipos de método plus() según los parámetros que se le pasan.

más (cantidad larga para agregar, unidad TemporalUnit)

plus() de una clase ZonedDateTime que se usa para devolver una copia de esta fecha y hora con la cantidad especificada de unidad agregada. Si no es posible agregar la cantidad, porque la unidad no es compatible o por alguna otra razón, una excepción es aventado.

Sintaxis:

public ZonedDateTime plus(long amountToAdd,
                          TemporalUnit unit)

Parámetros: Este método acepta dos parámetros:

• amountToAdd: que es la cantidad de la unidad a sumar al resultado, puede ser negativo
• unidad: que es la unidad de la cantidad a sumar.

Valor de retorno: este método devuelve ZonedDateTime en función de esta fecha y hora con la cantidad especificada agregada.

Excepción: este método arroja las siguientes excepciones:

• DateTimeException : si no se puede realizar la adición.
• UnsupportedTemporalTypeException : si la unidad no es compatible.
• ArithmeticException : si se produce un desbordamiento numérico.

Los siguientes programas ilustran el método plus():

Programa 1:

// Java program to demonstrate
// ZonedDateTime.plus() method
  
import java.time.*;
import java.time.temporal.ChronoUnit;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a ZonedDateTime object
        ZonedDateTime zonedlt
            = ZonedDateTime
                  .parse(
                      "2018-12-06T19:21:12.123+05:30[Asia/Calcutta]");
  
        // add 30 Months to ZonedDateTime
        ZonedDateTime value
            = zonedlt.plus(30, ChronoUnit.MONTHS);
  
        // print result
        System.out.println("ZonedDateTime after"
                           + " adding Months: \n"
                           + value);
    }
}

ZonedDateTime after adding Months: 
2021-06-06T19:21:12.123+05:30[Asia/Calcutta]

plus(TemporalAmount cantidad a agregar)

plus() de una clase ZonedDateTime que se usa para devolver una copia de esta fecha y hora con la cantidad especificada agregada a la fecha y hora. La cantidad suele ser Período o Duración, pero puede ser cualquier otro tipo que implemente la interfaz TemporalAmount.

Sintaxis:

public ZonedDateTime plus(TemporalAmount amountToAdd)

Parámetros: este método acepta un solo parámetro , cantidad para agregar , que es la cantidad a agregar, no debe ser nulo.

Valor de retorno: este método devuelve ZonedDateTime en función de esta fecha y hora con la adición realizada.

Excepción: este método arroja las siguientes excepciones:

• DateTimeException : si no se puede realizar la adición.
• ArithmeticException : si se produce un desbordamiento numérico.

Los siguientes programas ilustran el método plus():

Programa 1:

// Java program to demonstrate
// ZonedDateTime.plus() method
  
import java.time.*;
public class GFG {
    public static void main(String[] args)
    {
  
        // create a ZonedDateTime object
        ZonedDateTime zonedlt
            = ZonedDateTime
                  .parse(
                      "2018-12-06T19:21:12.123+05:30[Asia/Calcutta]");
  
        // add 100 Days to ZonedDateTime
        ZonedDateTime value
            = zonedlt.plus(Period.ofDays(100));
  
        // print result
        System.out.println("ZonedDateTime after"
                           + " adding Days: \n"
                           + value);
    }
}

ZonedDateTime after adding Days: 
2019-03-16T19:21:12.123+05:30[Asia/Calcutta]

Referencia:

• https://docs.oracle.com/javase/10/docs/api/java/time/ZonedDateTime.html#plus(java.time.temporal.TemporalAmount)
• https://docs.oracle.com/javase/10/docs/api/java/time/ZonedDateTime.html#plus(long, java.time.temporal.TemporalUnit)