CKTIS / Java
DateTimeFormatter: patronen, locale en strikt parsen
Kies een patroon en locale voor de tekst en een resolutiestijl voor de datumcontrole. Leer het verschil tussen `MM` en `mm` en tussen `uuuu` en `yyyy`.
Versie: Java SE 21
Syntax
java.time.format.DateTimeFormatter (Java SE 21)
static DateTimeFormatter ofPattern(String pattern)
static DateTimeFormatter ofPattern(String pattern, Locale locale)
DateTimeFormatter withLocale(Locale locale)
DateTimeFormatter withResolverStyle(ResolverStyle resolverStyle)
Locale: java.util.Locale
ResolverStyle: java.time.format.ResolverStyleDe statische methode DateTimeFormatter.ofPattern maakt een formatter op basis van een patroon. De overload ofPattern(String) gebruikt de standaardlocale voor de categorie FORMAT; ofPattern(String, Locale) gebruikt de opgegeven locale. Beide beginnen met SMART. Een ongeldig patroon veroorzaakt bij het maken van de formatter een IllegalArgumentException.
Patroonletters zijn hoofdlettergevoelig: dd is de dag van de maand, MM is het maandnummer en mm staat voor minuten. dd-MM-uuuu, dd/MM/uuuu en uuuu-MM-dd bepalen de volgorde van de velden en de scheidingstekens. uuuu is het proleptische jaar (inclusief jaar nul); yyyy is het jaartal binnen een jaartelling. Bij strikt ISO-parsen zijn yyyy, maand en dag niet genoeg voor een LocalDate, omdat er geen jaartelling wordt aangenomen. Gebruik uuuu voor datums zonder aanduiding van de jaartelling.
DateTimeFormatter.withLocale stelt de Locale van de geretourneerde formatter in. Die beïnvloedt tekst zoals volledige maandnamen (MMMM) bij zowel formatteren als parsen, maar verandert de veldvolgorde of de scheidingstekens van een expliciet patroon niet. Formatters zijn onveranderlijk en thread-safe: bewaar de retourwaarde van withLocale of withResolverStyle, want het origineel verandert niet.
DateTimeFormatter.withResolverStyle bepaalt de tweede fase van het parsen: nadat de velden volgens het patroon zijn gelezen, combineert de formatter ze tot een datum. Deze instelling verandert de uitvoer bij formatteren niet. Voor ISO-datums verwerpt STRICT onmogelijke datums, kan SMART een dag van 1–31 terugbrengen tot de laatste dag van de maand en kan LENIENT overtollige dagen naar de volgende maand doorschuiven. LocalDate.parse(text, formatter) gooit een DateTimeParseException als de tekst niet past of niet tot een datum kan worden verwerkt.
Voorbeelden
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) {
LocalDate date = LocalDate.of(2024, 1, 5);
DateTimeFormatter english = DateTimeFormatter.ofPattern("dd MMMM uuuu", Locale.US);
DateTimeFormatter french = english.withLocale(Locale.FRANCE);
System.out.println(date.format(english));
System.out.println(date.format(french));
DateTimeFormatter smart = DateTimeFormatter.ofPattern("dd-MM-uuuu", Locale.ROOT);
DateTimeFormatter strict = smart.withResolverStyle(ResolverStyle.STRICT);
String invalid = "31-02-2024";
System.out.println("SMART: " + LocalDate.parse(invalid, smart));
try {
System.out.println("STRICT: " + LocalDate.parse(invalid, strict));
} catch (DateTimeParseException e) {
System.out.println("STRICT: rejected");
}
}
}
Resultaat
05 January 2024 05 janvier 2024 SMART: 2024-02-29 STRICT: rejected
De locale verandert de naam van de maand, niet de indeling van de datum. De namen hangen af van de localegegevens van de runtime. Voor `31-02-2024` geeft `SMART` de datum `2024-02-29` terug, terwijl `STRICT` de invoer afwijst.
Gerelateerde lessen
- Java · Les 61 · Gevorderd · Versie: 2