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.