El método range() de una interfaz ChronoLocalDateTime se utiliza para obtener el rango de valores válidos para los pases de campo como parámetro. Este método devuelve un objeto ValueRange que contiene los valores válidos mínimo y máximo para un campo. Este ChronoLocalDateTime es útil para mejorar la precisión del rango devuelto. Cuando el campo no es compatible y el método no puede devolver valores de rango, se lanza una excepción.
Sintaxis:
default ValueRange range(TemporalField field)
Parámetros: este método acepta un solo campo de parámetro que es el campo para obtener el rango de valores.
Valor de retorno: este método devuelve ValueRange, que es el rango de valores válidos para el campo, no nulo.
Excepción: este método arroja las siguientes excepciones:
- DateTimeException : si no se puede obtener el rango del campo.
- UnsupportedTemporalTypeException : si el campo no es compatible.
Los siguientes programas ilustran el método range():
Programa 1:
// Java program to demonstrate // ChronoLocalDateTime.range() method import java.time.*; import java.time.chrono.*; import java.time.temporal.ChronoField; import java.time.temporal.ValueRange; public class GFG { public static void main(String[] args) { // create a ChronoLocalDateTime object ChronoLocalDateTime localDT = LocalDateTime .parse("2018-10-25T23:12:31.123"); // print ChronoLocalDateTime System.out.println("ChronoLocalDateTime of Calcutta: " + localDT); // get range of MILLI_OF_SECOND field // from ChronoLocalDateTime using range method ValueRange range = localDT.range(ChronoField.MILLI_OF_SECOND); // print range of MILLI_OF_SECOND System.out.println("Range of MILLI_OF_SECOND: " + range); } }
ChronoLocalDateTime of Calcutta: 2018-10-25T23:12:31.123 Range of MILLI_OF_SECOND: 0 - 999
Programa 2:
// Java program to demonstrate // ChronoLocalDateTime.range() method import java.time.*; import java.time.chrono.*; import java.time.temporal.ChronoField; import java.time.temporal.ValueRange; public class GFG { public static void main(String[] args) { // create a ChronoLocalDateTime object ChronoLocalDateTime localDT = LocalDateTime .parse("2019-12-31T19:15:30"); // print ChronoLocalDateTime System.out.println("ChronoLocalDateTime of Calcutta: " + localDT); // get range of NANO_OF_SECOND field // from localDateTime using range method ValueRange range = localDT.range(ChronoField.NANO_OF_SECOND); // print range of NANO_OF_SECOND System.out.println("Range of NANO_OF_SECOND: " + range); } }
ChronoLocalDateTime of Calcutta: 2019-12-31T19:15:30 Range of NANO_OF_SECOND: 0 - 999999999