16.6 Ausgabeformatierung

Zur Formatierung einer Ausgabe stehen Ihnen zwei Möglichkeiten zur Verfügung:

• die statische Methode Format der Klasse String
• die Methode ToString der Schnittstelle IFormatable

16.6.1 Formatierung mit der Methode »String.Format«

Rufen wir uns zuerst in Erinnerung, wie die Ausgabe der Methode DateTime.Now an der Konsole lautet:

Console.WriteLine(DateTime.Now.ToString());

Es wird das Datum einschließlich der Uhrzeit angezeigt:

17.09.2003 20:51:56

Mit der Format-Methode können wir eine andere, individuell passendere Ausgabe erzwingen:

Console.WriteLine(String.Format("{0:F}", DateTime.Now));

Damit würde die Anzeige lauten:

Mittwoch, 17. September 2003 20:51:56

Es bietet sich auch die Möglichkeit an, mit

Console.WriteLine(String.Format("{0:D}", DateTime.Now));

auf die Zeitangabe ganz zu verzichten.

Formatierungsvarianten

Die einfachsten Varianten der überladenen Format-Methode lauten:

public static string Format(string format, object arg);
public static string Format(string format, params object[] args);

Der erste Parameter beschreibt eine Zeichenfolge mit einem oder mehreren Formatierungsausdrücken, die in geschweiften Klammern angegeben werden. Dem zweiten Parameter werden die zu formatierenden Objekte übergeben. Die Syntax erinnert sofort an die Formatierungen der Methode Console.WriteLine, die sich tatsächlich intern der Format-Methode bedient.

Unter den weiteren vier Überladungen ist eine besonders hervorzuheben, mit der festgelegt werden kann, welche Sprache bzw. Kultur für die Formatierung verwendet werden soll:

public static string Format(IFormatProvider provider,
                            string format, params object[] args);

Im ersten Parameter erwartet die Methode String.Format nun ein Objekt, das die Schnittstelle IFormatProvider implementiert. Im .NET Framework sind das drei Klassen:

• CultureInfo
• DateTimeFormatInfo
• NumberFormatInfo

Diese Klassen gehören alle zum Namespace System.Globalization. Die Klasse CultureInfo stellt Informationen über eine bestimmte Kultur bereit, einschließlich des Schriftsystems sowie des verwendeten Kalenders. DateTimeFormatInfo definiert die Anzeige von Datum und Uhrzeit und NumberFormatInfo die Darstellung numerischer Werte – immer abhängig von der jeweiligen Kultur.

Um beispielsweise das aktuelle Systemdatum in italienischer Sprache auszugeben, müssen Sie nur ein entsprechendes CultureInfo-Objekt bereitstellen, das die italienische Kultur beschreibt:

CultureInfo culture = new CultureInfo("it-IT");
// Ausgabe: sabato 20 settembre 2003
Console.WriteLine(String.Format(culture, "{0:D}", DateTime.Now));

Listing 16.30 Datumsausgabe in Italienisch

Mit den Eigenschaften DateTimeFormat und NumberFormat der Klasse CultureInfo kann das Ausgabeformat der spezifischen Kultur abgefragt und sogar neu festgelegt werden. Dazu veröffentlichen die beiden Klassen DateTimeFormatInfo und NumberFormatInfo eine größere Anzahl Eigenschaften. Wie Sie das Dezimaltrennzeichen einer gegebenen Kultur abweichend vom Standard spezifisch festlegen können, zeigt das folgende Codefragment:

double dbl = 12.25;
CultureInfo culture = new CultureInfo("de-DE");
NumberFormatInfo nfi = culture.NumberFormat;
nfi.NumberDecimalSeparator = "*";
Console.WriteLine(String.Format(culture, "{0}", dbl));

Listing 16.31 Individuelles Dezimaltrennzeichen festlegen

Es wird zuerst ein CultureInfo-Objekt erzeugt, das mit de-DE die deutsche Kultur beschreibt. Über dessen Eigenschaft NumberFormat wird die dazu entsprechende Referenz auf NumberFormatInfo ermittelt. Der Eigenschaft NumberDecimalSeparator wird anschließend das Zeichen »*« als neues Dezimaltrennzeichen zugewiesen.

Es kann sich als nützlich erweisen, ein kulturunabhängiges Format zur Verfügung zu stellen. Dieses erhalten Sie mit der statischen Eigenschaft InvariantCulture der Klasse CultureInfo. Das zurückgegebene CultureInfo-Objekt ist der englischen Sprache zugeordnet, ohne dabei landesspezifische Unterschiede zu berücksichtigen.

Standardformatzeichen der Klasse »NumberFormatInfo«

In Tabelle 16.8 sind die Standardformatzeichen für die einzelnen Standardmuster der NumberFormatInfo-Klasse aufgeführt. Teilweise können die Standardmuster auch durch Eigenschaften verändert werden. Genauere Informationen dazu entnehmen Sie bitte der .NET-Dokumentation zu der Klasse.

Standardformatzeichen der Klasse »DateTimeFormatInfo«

In Tabelle 16.9 sind die wichtigsten Standardmuster zur Formatierung von Datum und Uhrzeit aufgezählt. Maßgeblich sind auch hier die Einstellungen unter Ländereinstellung. Wie schon bei den Standardformatmustern der Klasse NumberFormatInfo können Sie über Eigenschaften einige der Standardmuster nach eigenen Vorstellungen ändern. Weitere Informationen entnehmen Sie auch hier der .NET-Dokumentation.

Dazu zwei Beispiele:

// Ausgabe: Dienstag, 23. September 2003 12:12:55
string date = String.Format("{0:F}", DateTime.Now) 
// Ausgabe: 23 September
string date = String.Format("{0:M}", DateTime.Now) 

16.6.2 Formatierung mit der Methode »ToString«

Von der Klasse Object erbt jede .NET-Klasse die parameterlose Methode ToString. Darüber hinaus werden sowohl von den numerischen Typen als auch von der Klasse String Überladungen angeboten, die direkt auf dem zu formatierenden Wert aufgerufen werden. Sie können sich zum Beispiel mit

float d = 0.01985F;
Console.WriteLine(d.ToString("P"));

die float-Zahl als Prozentzahl oder mit

float d = 123.505F;
Console.WriteLine(d.ToString("E"));

im Exponentialformat ausgeben lassen. Auch hier wird die Einstellung der aktuellen Kultur berücksichtigt. Sie können als Formatierungszeichenfolge alle Formatzeichen angeben, die in den Tabellen 16.8 und 16.9 aufgeführt sind. Die geschweiften Klammern sind nicht erforderlich. Um landesspezifische Ausgaben zu ermöglichen, können Sie auch ein IFormatProvider-Objekt übergeben.

public virtual string ToString(IFormatProvider);

Beachten Sie, dass die verschiedenen Datentypen unterschiedlich viele Überladungen von ToString zur Verfügung stellen.

16.6.3 Benutzerdefinierte Formatierung

Zahlen und Zeichenfolgen

Über die vordefinierten Formate hinaus können Sie auch eigene Formatierungen festlegen. Dazu wird Ihnen von .NET eine Reihe von Formatzeichen bereitgestellt, um die Ausgabe von Ganz- und Dezimalzahlen sowie Zeichenfolgen nach eigenen Vorstellungen zu beeinflussen.

Nachfolgend wird an einigen Beispielen gezeigt, wie die Formatzeichen eingesetzt werden und zu welchem Ergebnis die Anweisungen führen:

double value = 12345.67890;
string text = value.ToString("000");    // Ausgabe: 12346
text = value.ToString("0000000");       // Ausgabe: 00123456
text = value.ToString("###");           // Ausgabe: 12346
text = value.ToString("#,#####");       // Ausgabe: 12.346
text = value.ToString("#.##");          // Ausgabe: 12345,68
text = value.ToString("#.#####");       // Ausgabe: 12345,6789
text = value.ToString("000e+000");      // Ausgabe: 123e+002
text = value.ToString("0%");            // Ausgabe: 1234568%

Datums- und Zeitangaben

Wenn Sie wollen, können Sie mit vordefinierten Codes eigene Mustervorgaben zur Darstellung des Datums und der Uhrzeit festlegen. Die Codes werden von der Klasse DateTimeFormatInfo bereitgestellt.

// Ausgabe: Sep.2004.12
string text = DateTime.Now.ToString("MMM/yyyy/dd"); 
// Ausgabe: 09:22:30
string text = DateTime.Now.ToString("HH:mm:ss");

Ihre Meinung

Wie hat Ihnen das Openbook gefallen? Wir freuen uns immer über Ihre Rückmeldung. Schreiben Sie uns gerne Ihr Feedback als E-Mail an kommunikation@rheinwerk-verlag.de.