Método ZonedDateTime plusHours() en Java con ejemplos

método plusHours() de una clase ZonedDateTime utilizada para agregar la cantidad de horas en esta ZonedDateTime y devolver una copia de ZonedDateTime después de la adición. Esto opera en la línea de tiempo instantánea, de modo que agregar una hora siempre tendrá una duración de una hora más tarde . Agregar una hora puede causar que la fecha y hora local cambie en una cantidad diferente a una hora.
Por ejemplo, considere una zona horaria, como ‘Europa/París’, donde el cambio de horario de verano de otoño significa que las horas locales 02:00 a 02:59 ocurren dos veces cambiando de compensación +02:00 en verano a +01:00 en invierno.

• Agregar una hora a 01:30+02:00 dará como resultado 02:30+02:00 (ambos en horario de verano)
• Agregar una hora a 02:30+02:00 dará como resultado 02:30+01:00 (pasando del horario de verano al de invierno)
• Agregar una hora a 02:30+01:00 dará como resultado 03:30+01:00 (ambos en horario de invierno)
• Agregar tres horas a 01:30+02:00 dará como resultado 03:30+01:00 (pasando del horario de verano al de invierno)

Esta instancia es inmutable y no se ve afectada por esta llamada de método.

Sintaxis:

public ZonedDateTime plusHours(long hours)

Parámetros: Este método acepta un único parámetro horas que representa las horas a sumar, puede ser negativo.

Valor devuelto: este método devuelve un ZonedDateTime basado en esta fecha y hora con las horas añadidas, no nulas.

Excepción: este método lanza DateTimeException si el resultado excede el rango de fechas admitido.

Los siguientes programas ilustran el método plusHours():
Programa 1:

// Java program to demonstrate
// ZonedDateTime.plusHours() 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 hours: "
                           + zoneddatetime);
  
        // add 3 hours
        ZonedDateTime returnvalue
            = zoneddatetime.plusHours(3);
  
        // print result
        System.out.println("ZonedDateTime after "
                           + " adding hours: "
                           + returnvalue);
    }
}

Programa 2:

// Java program to demonstrate
// ZonedDateTime.plusHours() 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 hours: "
                           + zoneddatetime);
  
        // add 20 hours
        ZonedDateTime returnvalue
            = zoneddatetime.plusHours(20);
  
        // print result
        System.out.println("ZonedDateTime after "
                           + " adding hours: "
                           + returnvalue);
    }
}

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