Formatierung von Daten
Nachdem die grundsätzliche Funktionsweise der Internationalisierung und die Isolierung von Daten betrachtet wurden, wird in diesem Abschnitt erklärt, wie Zahlen, Währungen, Datumsangaben, Zeitangaben und Text formatiert werden kann. Da derartige Datenelemente vom Endbenutzer verwendet werden, muss das jeweilige Format mit den verschiedenen kulturellen Konventionen konform sein.
Zahlen und Währungen
Programme operieren auf Zahlen in einer Art und Weise, die grundsätzlich unabhängig von einer Localen ist. Vor der Ausgabe einer Zahl muss daher ein Programmteil durchlaufen werden, der eine Zahl in einen String konvertiert, so dass ein Locale-sensitives Format erzeugt wird. Während bspw. im amerikanischen Raum das Zahlenformat mit Punkt (1234.56) verwendet wird, wird in Deutschland meist das Format mit Komma (1234,56) benutzt.
Indem man die Methoden aufruft, die von der Klasse NumberFormat zur Verfügung gestellt werden, können Zahlen, Währungen und Prozentangaben entsprechend einer Localen formatiert werden. Problematisch ist allerdings, dass das NumberFormat unter Umständen die selbst spezifizierte Locale nicht unterstützt. Es kann aber leicht festgestellt werden, welche Definition der Localen von der Klasse NumberFormat unterstützt wird, indem die Methode getAvailableLocales folgendermaßen aufgerufen wird:
Locale[] locales = NumberFormat.getAvailableLocales();
Wenn NumberFormat die jeweils benötigte Locale nicht unterstützt, kann ein eigenes Format definiert werden. Dies wird im Folgenden detailliert erläutert.
Die NumberFormat-Methoden können weiterhin dazu verwendet werden, primitive Zahlentypen, wie bspw. float oder double und ihre entsprechenden Objekttypen (Float und Double), zu formatieren. Das folgende Beispiel formatiert eine Double-Zahl entsprechend einer Localen. Indem die getNumberInstance-Methode aufgerufen wird, kann eine Locale-spezifische Instanz des NumberFormats erzeugt werden. Die Formatierungsmethode akzeptiert hierbei Double als Argument und gibt einen String zurück, der die formatierte Zahl enthält:
Double Preis = new Double(12.99);
NumberFormat zahlenFormatierer;
String PreisText;
zahlenFormatierer = NumberFormat.getNumberInstance(derzeitigeLocale);
PreisText = zahlenFormatierer.format(Preis);
System.out.println(PreisText + " " + derzeitigeLocale.toString());
Die Ausgabe dieses Beispiels illustriert, wie das Format mit der jeweiligen Localen variiert:
12,99 de_DE
12.99 en_US
Die Formatierung von Währungen erfolgt in ähnlicher Weise wie die von Zahlen. Hierzu ist die Methode getCurrencyInstance zu verwenden, die einen String zurückliefert, der die formatierte Zahl und eine Währungsangabe enthält. Das folgende Beispiel illustriert dies:
Double waehrung = new Double(12.99);
NumberFormat waehrungsFormatierer;
String waehrungsText;
waehrungsFormatierer = NumberFormat.getCurrencyInstance(derzeitigeLocale);
waehrungsText = waehrungsFormatierer.format(waehrung);
System.out.println(waehrungsText + " " + derzeitigeLocale.toString());
Nach dem Aufruf ergibt sich die folgende Ausgabe:
12,99 DM de_DE
$12.99 en_US
Die Formatierung von Prozentangaben erfolgt analog mittels der Methode getPercentInstance.
Selbstdefinierte Formate
Zur Formatierung von Dezimalzahlen und damit zu deren Umsetzung in Locale-spezifische Strings kann die Klasse DecimalFormat verwendet werden. Diese Klasse ermöglicht die Kontrolle der Anzeige führender und folgender Nullen, von Präfixen und Suffixen, von Gruppentrennzeichen (bspw. Punkt oder Komma in Tausenderangaben) und von Dezimaltrennzeichen. Wenn derartige Formatierungssymbole verändert werden sollen, muss DecimalFormatSymbols zusammen mit der Klasse DecimalFormat verwendet werden. Diese beiden Klassen bieten eine erhebliche Flexibilität hinsichtlich der Formatierung von Zahlen an, können aber Programme auch sehr komplex machen. Es empfiehlt sich daher, anstelle von DecimalFormat und DecimalFormatSymbols die Klasse NumberFormat so oft wie möglich einzusetzen.
Die Formateigenschaften von DecimalFormat werden stets mit einem Muster-String angegeben. Das Muster bestimmt hierbei, wie die formatierte Zahl aussehen soll. Das folgende Beispiel generiert eine Formatierung, indem ein Muster-String nach dem DecimalFormat-Konstruktor durchsucht wird. Die Methode erwartet einen Wert vom Typ double als Argument und erzeugt eine formatierte Zahl, die als String zurückgegeben wird. Mögliche Ausgaben dieses Beispiels sind in Tab. 6-3 dargestellt.
DecimalFormat formatierer= new DecimalFormat(muster);
String output = formatierer.format(wert);
System.out.println(wert + " " + muster + " " + output);
|
Wert |
Muster |
Ausgabe |
Erläuterung |
|
111111.111 |
###,###.### |
111,111.111 |
Das Doppelkreuz repräsentiert jeweils eine Stelle der Zahl, das Komma repräsentiert den Gruppenseparator und der Punkt den Dezimalseparator. |
|
111111.111 |
###.## |
111111.11 |
Ein Abschneiden von Nachkommastellen wird durch eine Rundung durchgeführt. |
|
111.11 |
000000.000 |
000111.110 |
Dieses Muster spezifiziert die Anzahl führender und folgender Nullen, da anstelle des Doppelkreuzes das Null-Symbol verwendet wird. |
|
111111.111 |
$###,###.### |
$111,111.111 |
Das erste Zeichen des Musters ist das Dollarzeichen. Dieses muss der ersten Ziffer unmittelbar vorangehen. |
Tab. 6.3: Selbstdefinierte Zahlenmuster
Ziel des vorangegangenen Beispiels ist die Generierung eines DecimalFormat-Objekts für eine Standard-Locale. Soll ein derartiges Objekt für eine Locale generiert werden, die keine Standard-Locale ist, so muss das Objekt als NumberFormat instantiiert und anschließend in den Typ DecimalFormat umgewandelt werden. Das so entstandene Objekt formatiert dann die Muster in einer Locale-sensitiven Art und Weise:
NumberFormat nf = NumberFormat.getNumberInstance(l);
DecimalFormat df = (DecimalFormat) nf;
df.applyPattern(muster);
String output = df.format(wert);
System.out.println(muster + " " + output + " " + l.toString());
Bisher wurden solche Muster betrachtet, die der US-amerikanischen Konvention folgten. Symbole, wie bspw. das Dezimaltrennzeichen, der Gruppenseparator und das Minuszeichen können mit der Klasse DecimalFormatSymbols verändert werden. Im nächsten Beispiel wird mittels DecimalFormatSymbols einer Zahl ein ungewöhnliches Format zugewiesen. Hierzu werden Aufrufe der Methoden setDecimalSeparator, setGroupingSeparator und setGroupingSize verwendet.
DecimalFormatSymbols neueSymbole= new DecimalFormatSymbols(derzeitigeLocale);
neueSymbole.setDecimalSeparator('*');
neueSymbole.setGroupingSeparator('#');
String muster = "#.#[],###";
DecimalFormat neuerFormatierer = new DecimalFormat(muster,neueSymbole);
neuerFormatierer.setGroupingSize(4);
String komisch= neuerFormatierer.format(11111.111);
System.out.println(komisch);
Als Ausgabe ergibt sich in diesem Fall 1#1111*111.
Formatierung von Datum und Zeit
Date-Objekte werden in Java dazu verwendet, Datums- und Zeitangaben zu repräsentieren. Wie in den vorangegangenen Beispielen muss ein Datumsobjekt vor der Ausgabe in einen String konvertiert werden. Die Formatierung ist hierbei in großem Maße kulturabhängig.
In Java wird die DateFormat-Klasse dazu verwendet, Datums- und Zeitangaben in einer Locale-sensitiven Art und Weise zu formatieren. Wie bisher auch unterstützt DateFormat nicht alle Locale-Definitionen. Zur Feststellung, welche Localen unterstützt werden, kann die bereits beschriebene Methode getAvailableLocales verwendet werden.
Die Formatierung von Datumsangaben mittels der Klasse DateFormat erfolgt in zwei Schritten. Zuerst wird ein Formatierer mittels der Methode getDateInstance generiert. Anschließend wird die Formatierungsmethode aufgerufen, die einen String mit dem formatierten Datum zurückliefert. Das folgende Beispiel illustriert dieses Vorgehen:
Date heutigesDatum;
String datumText;
DateFormat datumsFormatierer;
datumsFormatierer = DateFormat.getDateInstance(DateFormat.DEFAULT, derzeitigeLocale);
heutigesDatum= new Date();
datumText = datumsFormatierer.format(heutigesDatum);
System.out.println(datumText + " " + derzeitigeLocale.toString());
Die Ausgabe, die hier erzeugt wird, variiert mit der Localen:
1.2.1999 de_DE
01-Feb-99 en_US
Dieses Beispiel wurde mit dem DEFAULT-Formatierungsstil ausgeführt, der einer der Stile ist, die in der Klasse DateFormat vordefiniert sind. Weitere Stile sind SHORT, MEDIUM, LONG und FULL. Tab. 6-4 zeigt, wie sich die Datumsangaben in Abhängigkeit vom gewählten Stil verändern.
|
Stil |
Deutsche Locale |
US-Locale |
|
DEFAULT |
10. Feb 99 |
10-Feb-99 |
|
SHORT |
10/02/99 |
02/10/99 |
|
MEDIUM |
10. Feb 99 |
10-Feb-99 |
|
LONG |
10. Februar 1999 |
February 10, 1999 |
|
FULL |
Mittwoch, 10. Februar 1999 |
Wednesday, February 10, 1999 |
Tab. 6.4: Datumsstile in Java
Da Date-Objekte sowohl Datums- als auch Zeitangaben repräsentieren, ist die Formatierung von Zeitangaben analog. Es muss allerdings die Methode getTimeInstance verwendet werden. Tab. 6-5 zeigt die Stile, die in Java für Zeitangaben zur Verfügung stehen.
|
Stil |
Deutsche Locale |
US-Locale |
|
DEFAULT |
15:58:45 |
3:58:45 PM |
|
SHORT |
15:58 |
3:58 PM |
|
MEDIUM |
15:58:45 |
3:58:45 PM |
|
LONG |
3:58:45 GMT+02:00 |
3:58:45 PM PDT |
|
FULL |
15.58 Uhr GMT+02:00 |
3:58:45 o'clock PM PDT |
Tab. 6.5: Zeitangaben in Java
Zur simultanen Darstellung von Datum und Zeit in einem String kann wie folgt vorgegangen werden:
DateFormat formatierer = DateFormat.getDateTimeInstance(DateFormat.LONG, DateFormat.LONG, derzeitigeLocale);
Meist reichen die in Java vordefinierten Formate für Datums- und Zeitangaben aus. Soll dennoch eine Veränderung erfolgen, so kann mit Hilfe von SimpleDateFormat wie folgt vorgegangen werden: Zur Formatierung muss ein SimpleDateFormat-Objekt generiert werden, indem ein Muster-String angegeben wird. Dieses Vorgehen ist analog zur Formatierung von Zahlen und Währungen. Der Inhalt des Muster-Strings bestimmt dann das Format von Datum und Zeit.
Das folgende Beispiel formatiert eine Datums- und eine Zeitangabe mit Hilfe eines Muster-Strings, der an den SimpleDateFormat-Konstruktor übergeben wird. Der zurückgegebene String enthält dann Datum und Zeit im gewünschten Format.
Date heute;
String output;
SimpleDateFormat formatierer;
formatierer = new SimpleDateFormat(muster, derzeitigeLocale);
heute = new Date();
output = formatierer.format(heute);
System.out.println(muster + " " + output);
