CKTIS / Java
DateTimeFormatter — datums opmaken en parseren
DateTimeFormatter zet datums en tijden om in tekst en parseert tekst. Lees over patronen, expliciete Locale-selectie, strikte validatie en de verschillen tussen MM en mm en tussen uuuu en yyyy.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
DateTimeFormatter.ofPattern("uuuu-MM-dd HH:mm").withLocale(Locale.ROOT).withResolverStyle(ResolverStyle.STRICT)DateTimeFormatter is onveranderlijk en thread-safe. DateTimeFormatter.ofPattern maakt een formatter op basis van een patroon; je kunt die hergebruiken voor het opmaken en parseren van datums.
Bij MM en mm staat MM voor de maand met twee cijfers, terwijl mm staat voor minuten met twee cijfers. Bij uuuu en yyyy staat uuuu voor het proleptische jaar, terwijl yyyy staat voor het jaar binnen een tijdperk. Gebruik voor het strikt parseren van ISO-datums zonder tijdperk uuuu; yyyy alleen is niet voldoende om de datum op te lossen.
DateTimeFormatter.withLocale geeft een formatter terug met de gekozen Locale, die bijvoorbeeld invloed heeft op maandnamen. Ook DateTimeFormatter.withResolverStyle laat het oorspronkelijke object ongewijzigd. Kies ResolverStyle.STRICT om ongeldige datums af te wijzen. De standaardmodus van ofPattern, SMART, kan de dag aanpassen naar het einde van de maand, bijvoorbeeld 2023-02-29 naar 2023-02-28.
Het voorbeeld accepteert 2024-02-29 09:07, maar wijst 2023-02-29 09:07 af. STRICT bepaalt de resolutie van velden tijdens het parseren, niet het opmaken.
Voorbeelden
import java.time.LocalDateTime;
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 HH:mm")
.withLocale(Locale.ROOT)
.withResolverStyle(ResolverStyle.STRICT);
LocalDateTime value = LocalDateTime.parse("2024-02-29 09:07", formatter);
System.out.println(value.format(formatter));
try {
LocalDateTime.parse("2023-02-29 09:07", formatter);
throw new AssertionError("Expected rejection");
} catch (DateTimeParseException ex) {
System.out.println("Invalid date rejected");
}
}
}Resultaat
2024-02-29 09:07 Invalid date rejected
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.