5.9Formatieren und Parsen von Datumsangaben 

Nachdem wir die Calendar-Exemplare dazu benutzt haben, Datumswerte zu verwalten, wollen wir nun untersuchen, wie Formatierungsklassen dazu landestypische Ausgaben erzeugen. Unsere eigenen Ausgaben haben wir ja schon gemacht, doch geht es noch besser, weil die Java-Bibliothek für viele Länder selbstständig die richtigen Ausgaben durchführt.

 

5.9.1Ausgaben mit printf(…) 

Die format(…)- bzw. printf(…)-Methoden sind in Java sehr flexibel und können auch Datumswerte ausgeben. Das können sie allerdings nicht so gut wie Klassen rund um DateFormat, doch kann es ausreichen, wenn Datumswerte nicht lokalisiert behandelt werden müssen:

Listing 5.12com/tutego/insel/date/DateFormatWithPrintf.java, main()

Das Ergebnis ist zweistellig, daher nicht ganz Jahr-2000-fest.[ 65 ](Im November 1999 wurde ein Algorithmus zur Lösung des Jahr-2000-Problems patentiert, der einfach aussagt, dass zweistellige Jahreszahlen unter 30 zu 20XX und alle Jahreszahlen >30 zu 19XX zu ergänzen sind. Das Patent konnte allerdings erfolgreich angefochten werden.) Besonders beim letzten Beispiel ist abzulesen, dass die Locale-Angabe für Datumswerte generell nicht funktioniert (chinesische Datumsangaben beginnen mit dem Jahr). Die Abkürzungen %tR, %tT, %tD und %tF sind mit festen Reihenfolgen definiert, die die API-Dokumentation zeigt. So ist %tD nichts anderes als eine Abkürzung für %tm/%td/%ty. Die Zeitwerte können auch von den neuen Klassen der Date-Time-API stammen.

 

5.9.2Ausgaben mit Calendar-Methoden getDisplayName(…) * 

Die Calendar-Klasse liefert mit getDisplayName(int field, int style, Locale locale) einen String für einen Feldwert zurück. Der style ist eine Konstante, und deklariert sind folgende Konstanten: SHORT_FORMAT (SHORT), SHORT_STANDALONE, LONG_FORMAT (LONG), LONG_STANDALONE, NARROW_FORMAT, NARROW_STANDALONE, einige neu seit Java 8. Eine weitere Methode getDisplayNames(int field, int style, Locale locale) liefert ein Map<String,Integer> mit allen String-Repräsentationen für ein Feld.

 

5.9.3Mit DateFormat und SimpleDateFormat formatieren 

Eine Klasse, die die Ausgabe und das Einlesen der Datum-Felder übernimmt, ist DateFormat. Da DateFormat abstrakt ist, ist erst eine implementierende Unterklasse einsatzbereit. Natürlich liegt eine solche Klasse auch vor: SimpleDateFormat. Die Klasse bietet reichhaltige Methoden zur Zerlegung von Datum-Zeichenketten sowie Methoden zur Ausgabe unter verschiedenen Sprachen und Formatierungen an.

Um das Datum zu formatieren, müssen wir zunächst ein Exemplar von SimpleDateFormat erzeugen. Dieses bekommt dann eventuell Formatierungsanweisungen (über eine andere Methode oder über einen weiteren Konstruktor) und formatiert mit der format(…)-Methode das Datum.

Abbildung 5.2Vererbungsbeziehungen von DateFormat und SimpleDateFormat

• SimpleDateFormat()
  Erzeugt ein neues SimpleDateFormat-Objekt in der voreingestellten Sprache.

• final String format(Date date)
  Formatiert das Datum date in einen Datum-/Zeit-String. Ein Calendar-Objekt ist bisher nicht erlaubt. Wer es dennoch versucht, wird eine »java.lang.IllegalArgumentException: Cannot format given Object as a Date« ernten. Zur Erinnerung: cal.getTime() liefert vom Calendar-Objekt cal ein passendes Date-Objekt.

Vorgefertigte Formatierungen

Wir haben im vorigen Beispiel gesehen, dass das Ausgabeformat auf Monat, Tag, Jahr, Leerzeichen, Stunde, Minute festgelegt ist. Nun bietet die DateFormat-Klasse drei statische Fabrikmethoden für vorgefertigte Formatierungen:

• DateFormat getDateInstance(): Formatierung nur für Datum

• DateFormat getTimeInstance(): Formatierung nur für Zeit

• DateFormat getDateTimeInstance(): Formatierung für Datum und Zeit

Optional lassen sich den Methoden Argumente für Präzisionen mitgeben, und zwar DateFormat.SHORT, DateFormat.MEDIUM, DateFormat.LONG oder DateFormat.FULL. Diese ermöglichen es, dass sich die Zeit bzw. das Datum auf vier Arten formatieren lässt:

Tabelle 5.3Konstanten aus DateFormat und ihre Wirkung

Den statischen Methoden lässt sich weiterhin ein Locale-Objekt übergeben, sodass sie für eine bestimmte Landessprache formatieren:

Listing 5.13com/tutego/insel/date/DateTimeInstance.java, main()

Die statischen Methoden, die das vordefinierte DateFormat erzeugen, sind:

• static final DateFormat getDateInstance()

• static final DateFormat getTimeInstance()

• static final DateFormat getDateTimeInstance()
  Liefert einen Datum-/Zeit-Formatierer mit dem vorgegebenen Stil aus der Standardumgebung.

• static final DateFormat getDateInstance(int dateStyle)

• static final DateFormat getTimeInstance(int style)
  Liefert einen Datum-/Zeit-Formatierer mit dem Stil style und der Standardsprache.

• static final DateFormat getDateInstance(int style, Locale aLocale)

• static final DateFormat getTimeInstance(int style, Locale aLocale)
  Liefert einen Datum-/Zeit-Formatierer mit dem Stil style und der Sprache aLocale.

• static final DateFormat getDateTimeInstance(int dateStyle, int timeStyle)
  Gibt einen Datum-/Zeit-Formatierer für die gesetzte Sprache im angegebenen Formatierungsstil zurück.

• static final DateFormat getDateTimeInstance(int dateStyle, inttimeStyle, LocaleaLocale)
  Gibt einen Datum-/Zeit-Formatierer für die Sprache aLocale im angegebenen Formatierungsstil zurück.

Eine noch individuellere Ausgabe *

Um das Ausgabeformat zu individualisieren, kann ein Formatierungs-String die Ausgabe anpassen. Diese Formatierungsanweisung, in der alle ASCII-Zeichen eine bestimmte Bedeutung haben, wird entweder dem Konstruktor der Klasse SimpleDateFormat übergeben oder kann mit der applyPattern(String)-Methode geändert werden:

Listing 5.14com/tutego/insel/date/SimpleDateFormatPattern.java, main()

Tabelle 5.3 zeigt die erlaubten Symbole mit ihren Sonderbedeutungen. Mehrfach wiederholte Zeichen werden, wenn möglich, durch die Langform der jeweiligen Angabe ersetzt. Diese Symbole sind sprachunabhängig.

Tabelle 5.4Symbole im Formatierungs-String zur Steuerung der Ausgabe bei SimpleDateFormat

Tabelle 5.5Beispiele für Symbole bei SimpleDateFormat

• SimpleDateFormat()
  Erzeugt ein neues SimpleDateFormat-Objekt in der eingestellten Sprache.

• SimpleDateFormat(String pattern)
  Erzeugt ein SimpleDateFormat-Objekt mit dem vorgegebenen Formatierungs-String in der voreingestellten Sprache.

• SimpleDateFormat(String pattern, Locale locale)
  Erzeugt ein SimpleDateFormat-Objekt mit dem vorgegebenen Formatierungs-String in der Sprache locale.

• SimpleDateFormat(String pattern, DateFormatSymbols formatSymbols)
  Erzeugt ein SimpleDateFormat-Objekt mit dem vorgegebenen Formatierungs-String und einem Objekt formatSymbols, das die formatierungstypischen Informationen sammelt.

• void applyPattern(String pattern)
  Setzt den Formatierungs-String.

• String toPattern()
  Liefert den aktuell eingestellten Formatierungs-String.

• String toLocalizedPattern()
  Liefert einen übersetzten Formatierungs-String. Substituiert einige Formatierungssymbole.

 

5.9.4Parsen von Datumswerten 

Mit der Klasse DateFormat zerlegt parse(String) Strings, die ein Datum darstellen. Die Methode liefert ein Date-Objekt zurück und kann so zum Beispiel den Zeit-String »Wed Jul 11 09:35:27 CEST 2012« parsen und ein Datumsobjekt liefern, was new Date(1341992127435) gleichkommt. Da parse(…) allzu leicht schiefgehen kann, muss der Aufruf entweder in einen try-Block gesetzt werden, oder der Fehler muss anderweitig weitergeleitet werden.

Die Methode parse() ist sehr empfindlich, wenn einige Felder nicht angegeben werden. Nach der Dokumentation sollte zwar ein Fehlen der Stunden nichts ausmachen, aber leider ist uns dann doch immer eine ParseException sicher, auch wenn nur die Sekunden fehlen. Wegen dieser Unzulänglichkeiten ist die Klasse SimpleDateFormat sehr komplex und nicht leicht zu durchschauen.

Jetzt haben wir ein Datum in ein Date-Objekt umgewandelt. Es taucht aber wieder das Problem auf, dass Date an kein spezielles Land und an keine Zeitzone angepasst ist, sondern die GMT in Englisch repräsentiert.

• Date parse(String source) throws ParseException
  Zerlegt einen Datums- oder einen Zeit-String.

parse(…) – die Nachsichtige

Die Methode parse(…) beschwert sich standardmäßig nicht über unsinnige Werte. Um für eine Ausnahme zu sorgen, bietet DateFormat eine Methode setLenient(boolean), die den »Mildmodus« mit setLenient(false) ausschaltet. Das zeigen die folgenden Zeilen:

Listing 5.16com/tutego/insel/date/ParseLenient.java, main()

try {
DateFormat formatter1 = new SimpleDateFormat( "dd-MM-yyyy" );
System.out.printf( "%tF%n", formatter1.parse( "29-02-2008" ) ); // 2008-02-29
System.out.printf( "%tF%n", formatter1.parse( "29-02-2007" ) ); // 2007-03-01
System.out.printf( "%tF%n", formatter1.parse( "33-02-2008" ) ); // 2008-03-04

formatter1.setLenient( false );
System.out.println( formatter1.parse( "29-02-2007" ) ); //
}
catch ( ParseException e ) {
e.printStackTrace();
}

Am zweiten und dritten Beispiel lässt sich ablesen, dass das Datum auf den nächsten Monat »rollt«. Mit setLenient(false) gibt es für den 29.02.2007 eine ParseException:

Der 29.02.2008 ist in Ordnung, weil 2008 ein Schaltjahr war.

Parsen und Formatieren ab bestimmten Positionen *

Von den Methoden format(…) und parse(…) gibt es zwei Varianten, mit denen Teile eines Strings ausgegeben oder formatiert werden können. Zur Kapselung der Position dient ein neues Objekt, ParsePosition. Diese Klasse nutzt format(…) intern, um beim Parse-Prozess die aktuelle Position zu verwalten.

• abstract Date parse(String source, ParsePosition pos) throws ParseException
  Zerlegt einen Datums- oder einen Zeit-String und beginnt beim Parsen ab einer vorgegebenen Position.