Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

ResolverStyle — resolución estricta de fechas

ResolverStyle controla cómo se convierten los campos analizados en una fecha o una hora. El comportamiento de ResolverStyle.STRICT depende de los campos: en una fecha del calendario ISO indicada mediante año, mes y día, este estilo rechaza el 29 de febrero de un año no bisiesto.

Versión: Java SE 21 (documentation scope); repository and production runtimes not attested

Sintaxis

DateTimeFormatter.ofPattern("uuuu-MM-dd", Locale.ROOT).withResolverStyle(ResolverStyle.STRICT)

ResolverStyle es un tipo enum de java.time.format. El análisis primero lee los campos del texto y después los combina en una fecha o una hora. El estilo controla esa segunda fase, no la correspondencia inicial del texto con un patrón ni el formato de la salida.

Al resolver una fecha del calendario ISO a partir del año, el mes y el día, ResolverStyle.STRICT exige que el día exista en el mes y el año indicados. Para esos mismos campos, ResolverStyle.SMART puede sustituir un número de día demasiado alto por el último día del mes, mientras que ResolverStyle.LENIENT permite trasladar el exceso de un campo a otro. Las reglas dependen de los campos que se resuelven. Por ejemplo, en Java SE 21, al resolver una fecha expresada en semanas, los campos de WeekFields dependientes de la configuración regional pueden reducir la semana 53 a la 52 si el año basado en semanas solo tiene 52 semanas, incluso en modo STRICT.

Establece el estilo con withResolverStyle(ResolverStyle.STRICT) y conserva el formateador devuelto: el método no modifica el original. Un formateador creado con ofPattern usa SMART de forma predeterminada. Para un patrón de fecha sin era, usa uuuu-MM-dd: uuuu significa año, mientras que yyyy significa año de la era, que puede no bastar para crear un LocalDate con resolución estricta y sin era.

El ejemplo acepta 2024-02-29, pero captura DateTimeParseException para 2023-02-29. Imprime un mensaje fijo en lugar de un texto de excepción que depende de la implementación. Alcance de la documentación: Java SE 21; no se han confirmado los entornos de ejecución del repositorio ni de producción.

Ejemplos

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.time.format.ResolverStyle;
import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        DateTimeFormatter formatter = DateTimeFormatter
                .ofPattern("uuuu-MM-dd", Locale.ROOT)
                .withResolverStyle(ResolverStyle.STRICT);

        for (String text : new String[] {"2024-02-29", "2023-02-29"}) {
            try {
                System.out.println(LocalDate.parse(text, formatter));
            } catch (DateTimeParseException ex) {
                System.out.println("Rejected: " + text);
            }
        }
    }
}

Resultado

2024-02-29
Rejected: 2023-02-29

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes