El método compareTo(ZoneOffset) de ZoneOffset Class en el paquete java.time se usa para comparar otra instancia de ZoneOffset pasada como parámetro a esta instancia de ZoneOffset. Este método devuelve un valor entero que es el valor del comparador.
Sintaxis:
public int compareTo(ZoneOffset anotherZoneOffset)
Parámetros: este método acepta un parámetro anotherZoneOffset que se comparará con esta instancia de ZoneOffset.
Valor devuelto: este método devuelve un valor entero de la siguiente manera:
- si esta instancia es mayor que la instancia pasada como parámetro, se devuelve un valor positivo
- si esta instancia es igual a la instancia pasada como parámetro, se devuelve un cero (0)
- si esta instancia es menor que la instancia pasada como parámetro, se devuelve un valor negativo.
Excepciones: este método arroja una NullPointerException si otroZoneOffset pasado como parámetro es nulo.
Los siguientes ejemplos ilustran el método ZoneOffset.compareTo():
Ejemplo 1:
// Java code to illustrate compareTo() method import java.time.*; public class GFG { public static void main(String[] args) { // Get the ZoneOffset instance ZoneOffset zoneOffset1 = ZoneOffset.ofHours( 5 ); System.out.println( "ZoneOffset 1: " + zoneOffset1); // Get the ZoneOffset instance ZoneOffset zoneOffset2 = ZoneOffset.ofHours( 5 ); System.out.println( "ZoneOffset 2: " + zoneOffset2); // Get the ZoneOffset instance ZoneOffset zoneOffset3 = ZoneOffset.ofHours( 3 ); System.out.println( "ZoneOffset 3: " + zoneOffset3); // Using compareTo() method System.out.println( "ZoneOffset 1 " + "compared to ZoneOffset 2: " + zoneOffset1.compareTo(zoneOffset2)); // Using compareTo() method System.out.println( "ZoneOffset 1 " + "compared to ZoneOffset 3: " + zoneOffset1.compareTo(zoneOffset3)); // Using compareTo() method System.out.println( "ZoneOffset 3 " + "compared to ZoneOffset 1: " + zoneOffset3.compareTo(zoneOffset1)); } } |
Producción:
ZoneOffset 1: +05:00 ZoneOffset 2: +05:00 ZoneOffset 3: +03:00 ZoneOffset 1 compared to ZoneOffset 2: 0 ZoneOffset 1 compared to ZoneOffset 3: -7200 ZoneOffset 3 compared to ZoneOffset 1: 7200
Ejemplo 2: Para mostrar NullPointerException
// Java code to illustrate compareTo() method import java.time.*; public class GFG { public static void main(String[] args) { try { // Get the ZoneOffset instance ZoneOffset zoneOffset = ZoneOffset.ofHours( 3 ); System.out.println( "ZoneOffset: " + zoneOffset); // Using compareTo() method System.out.println( "ZoneOffset " + "compared to null: " ); zoneOffset.compareTo( null ); } catch (Exception e) { System.out.println(e); } } } |
Producción:
ZoneOffset: +03:00 ZoneOffset compared to null: java.lang.NullPointerException
Referencia: documento de Oracle