CKTIS / Java
DateTimeFormatter — formátování a parsování dat
DateTimeFormatter převádí data a časy na text a text parsuje. Seznamte se se vzory, výslovným výběrem Locale, striktní validací a rozdíly mezi MM a mm i mezi uuuu a yyyy.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
DateTimeFormatter.ofPattern("uuuu-MM-dd HH:mm").withLocale(Locale.ROOT).withResolverStyle(ResolverStyle.STRICT)DateTimeFormatter je neměnný a bezpečný pro použití ve více vláknech. DateTimeFormatter.ofPattern vytvoří formátovač podle vzoru; lze jej opakovaně používat k formátování i parsování.
Rozdíl MM a mm: MM označuje měsíc se dvěma číslicemi, zatímco mm označuje minuty se dvěma číslicemi. Rozdíl uuuu a yyyy: uuuu označuje proleptický rok, zatímco yyyy označuje rok letopočtu. Pro striktní parsování dat ISO bez letopočtu použijte uuuu; samotné yyyy k určení data nestačí.
DateTimeFormatter.withLocale vrací formátovač se zvoleným Locale, který ovlivňuje například názvy měsíců. Ani DateTimeFormatter.withResolverStyle nemění původní objekt. Zvolte ResolverStyle.STRICT, chcete-li odmítat neplatná data. Výchozí režim ofPattern, SMART, může upravit den na konec měsíce, například 2023-02-29 na 2023-02-28.
Příklad přijme 2024-02-29 09:07, ale odmítne 2023-02-29 09:07. STRICT řídí rozlišení polí při parsování, nikoli formátování.
Příklady
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");
}
}
}Výsledek
2024-02-29 09:07 Invalid date rejected
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.