CKTIS / Java
ResolverStyle — strikte Datumsauflösung
ResolverStyle steuert, wie geparste Felder zu einem Datum oder einer Uhrzeit zusammengesetzt werden. Das Verhalten von ResolverStyle.STRICT hängt von den Feldern ab: Bei einem ISO-Kalenderdatum aus Jahr, Monat und Tag weist der Stil den 29. Februar in einem Nichtschaltjahr zurück.
Version: Java SE 21 (documentation scope); repository and production runtimes not attested
Syntax
DateTimeFormatter.ofPattern("uuuu-MM-dd", Locale.ROOT).withResolverStyle(ResolverStyle.STRICT)ResolverStyle ist ein Enum in java.time.format. Beim Parsen werden zunächst Felder aus dem Text gelesen und anschließend zu einem Datum oder einer Uhrzeit kombiniert. Der Stil steuert diese zweite Phase, nicht den anfänglichen Abgleich des Textes mit einem Muster oder die Formatierung der Ausgabe.
Beim Auflösen eines ISO-Kalenderdatums aus Jahr, Monat und Tag verlangt ResolverStyle.STRICT, dass der Tag im angegebenen Monat und Jahr existiert. Für dieselben Felder kann ResolverStyle.SMART eine zu hohe Tagesnummer durch den letzten Tag des Monats ersetzen, während ResolverStyle.LENIENT Überläufe zwischen Feldern zulässt. Die Regeln hängen von den aufzulösenden Feldern ab. In Java SE 21 können gebietsschemaabhängige WeekFields beispielsweise beim Auflösen eines wochenbasierten Datums die Woche 53 auf Woche 52 zurücksetzen, wenn das Wochenjahr nur 52 Wochen hat – selbst im Modus STRICT.
Lege den Stil mit withResolverStyle(ResolverStyle.STRICT) fest und verwende den zurückgegebenen Formatter weiter: Die Methode ändert das Original nicht. Ein mit ofPattern erstellter Formatter verwendet standardmäßig SMART. Verwende für ein Datumsformat ohne Ära uuuu-MM-dd: uuuu bedeutet Jahr, während yyyy das Jahr innerhalb einer Ära bezeichnet, das bei strikter Auflösung ohne Ära möglicherweise nicht ausreicht, um ein LocalDate zu erzeugen.
Das Beispiel akzeptiert 2024-02-29, fängt aber für 2023-02-29 eine DateTimeParseException ab. Es gibt eine feste Meldung statt eines implementierungsabhängigen Ausnahmetextes aus. Dokumentationsumfang: Java SE 21; die Laufzeitumgebungen des Repositorys und der Produktion wurden nicht bestätigt.
Beispiele
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);
}
}
}
}Ergebnis
2024-02-29 Rejected: 2023-02-29
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.