CKTIS / Java
DateTimeFormatter.ofPattern: Datums- und Zeitmuster mit Locale.ENGLISH
Erstelle einen Formatierer für `yyyy-MM-dd HH:mm z` mit explizitem `Locale.ENGLISH` und finde heraus, woher die Zeitzone in der Ausgabe stammt.
Version: Java SE 21
Syntax
import java.time.format.DateTimeFormatter;
import java.util.Locale;
DateTimeFormatter.ofPattern(String pattern)
DateTimeFormatter.ofPattern(String pattern, Locale locale)
DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm z", Locale.ENGLISH)Die statische Methode DateTimeFormatter.ofPattern aus java.time.format erzeugt einen unveränderlichen, threadsicheren Formatierer, den du zum Formatieren und Parsen wiederverwenden kannst. ofPattern(String) übernimmt das Standardgebietsschema für Locale.Category.FORMAT; ofPattern(String, Locale) verwendet das übergebene Gebietsschema, etwa Locale.ENGLISH. Bei einem ungültigen Muster lösen beide Überladungen schon beim Erstellen eine IllegalArgumentException aus. Beim Parsen verwenden beide standardmäßig den Auflösungsmodus SMART.
Bei Musterbuchstaben kommt es auf Groß- und Kleinschreibung an. In yyyy-MM-dd HH:mm z steht yyyy für das Jahr innerhalb der Ära mit mindestens vier Stellen. MM und dd stehen für Monat und Tag des Monats, HH und mm für Stunde (00–23) und Minute. Diese vier Felder werden bei Bedarf mit einer führenden Null auf zwei Stellen ergänzt. uuuu steht dagegen für das proleptische Jahr, bei dem es ein Jahr 0 gibt.
Beim Formatieren gibt ein einzelnes z den kurzen Zeitzonennamen aus und berücksichtigt die Sommerzeit, sofern sich feststellen lässt, ob sie gilt. Locale.ENGLISH legt die Sprache dieses Textes fest, nicht die Zeitzone. Keine Überladung erzwingt eine Zeitzone: Ein ZonedDateTime liefert sie, ein LocalDateTime allein nicht. Regionale Zeitzonennamen können je nach Gebietsschemadaten der Laufzeit variieren und sind nicht unbedingt eindeutig. Bei einem festen ZoneOffset gibt z statt eines Namens die Offset-ID aus.
Beispiele
import java.time.ZoneOffset;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;
import java.util.Locale;
public class Main {
public static void main(String[] args) {
DateTimeFormatter formatter =
DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm z", Locale.ENGLISH);
ZonedDateTime dateTime =
ZonedDateTime.of(2024, 2, 9, 7, 5, 0, 0, ZoneOffset.ofHours(2));
System.out.println(formatter.format(dateTime));
}
}
Ergebnis
2024-02-09 07:05 +02:00
Die Ausgabe `2024-02-09 07:05 +02:00` ergibt sich aus dem ausdrücklich angegebenen Datum, der Uhrzeit und dem festen Offset. `+02:00` ist die Offset-ID, kein englischer Zeitzonenname. Das Beispiel verwendet weder die Systemuhr noch die Standardzeitzone oder das Standardgebietsschema.
Zugehörige Lektionen
- Java · Lektion 59 · Mittlere Stufe · Version: 2
Quellen
- DateTimeFormatter (Java SE 21 & JDK 21) — overloads, pattern letters, and resolver style
- DateTimeFormatterBuilder (Java SE 21 & JDK 21) — formatting and parsing zone text
- ZonedDateTime (Java SE 21 & JDK 21) — constructing a zoned date-time
- ZoneOffset (Java SE 21 & JDK 21) — offset ID
- LocaleServiceProvider (Java SE 21 & JDK 21) — locale data providers