## 14.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 ### 14.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 wie folgt 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");
    Console.WriteLine(String.Format(culture, "{0:D}", DateTime.Now));
    // Ausgabe: sabato 20 settembre 2003
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));
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 14.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.

Tabelle 14.8 Formatzeichen der Methode »String.Format«

Formatzeichen | Beschreibung
C oder c | Ausgabe im Währungsformat (einschließlich des Währungssymbols der aktuellen Ländereinstellung)
D oder d | Wird nur von ganzzahligen Datentypen unterstützt. Durch das Anhängen einer Zahl kann spezifiziert werden, wie viele Stellen die auszugebende Zahlenfolge aufweisen soll. Fehlende Ziffern werden mit Nullen aufgefüllt.
E oder e | Ausgabe im Exponentialformat
F oder f | Hängt an das Ende einer Zahl Dezimalstellen an. Die Anzahl der Nachkommastellen kann hinter dem Formatspezifizierer angegeben werden. Der Standard sind zwei Stellen.
G oder g | Allgemein formatierte Ausgabe
N oder n | Die Ausgabe erfolgt im Format ddd.ddd.ddd,dd.
P oder p | Ausgabe als Prozentzahl
R oder r | Roundtrip-Format. Es wird sichergestellt, dass ein Zurückkonvertieren nicht zu Genauigkeitsverlusten führt.
X oder x | Ausgabe als Hexadezimalzahl (ausschließlich für Ganzzahlenformate)
#### Standardformatzeichen der Klasse »DateTimeFormatInfo« In Tabelle 14.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 die Standardformatmuster der Klasse NumberFormatInfo können Sie über Eigenschaften einige der Standardmuster nach eigenen Vorstellungen ändern. Weitere Informationen entnehmen Sie auch hier der .NET-Dokumentation.

Tabelle 14.9 Formatcodes für Datum und Uhrzeit

Formatzeichen | Beschreibung
d | Kurzes Datum (22.09.2003)
D | Langes Datum (Montag, 22. September 2003)
f | Langes Datum, inklusive Zeitangabe (Montag, 22. September 2003 22:30)
F | Langes Datum, inklusive langer Zeitangabe (Montag, 22. September 2003 22:30:45)
g | Kurzes Datum, inklusive Zeitangabe (22.09.2003 22:30)
G | Kurzes Datum, inklusive langer Zeitangabe (22.09.2003 22:30:45)
M oder m | Tag und Monat (22 September)
R oder r | Datum nach dem Muster des RFC 1123 (Mon, 22 Sep 2003 22:30:45 GMT)
t | Kurze Zeitangabe (22:30)
T | Lange Zeitangabe (22:30:45)
Y oder y | Monat und Jahr (September 2003)
Dazu zwei Beispiele:
    string str;
    str = String.Format("{0:F}", DateTime.Now)
    // Ausgabe: Dienstag, 23. September 2003 12:12:55
    str = String.Format("{0:M}", DateTime.Now)
    // Ausgabe: 23 September
### 14.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 die float-Zahl zum Beispiel mit
    float d = 0.01985F;
    Console.WriteLine(d.ToString("P"));
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 12.9 und 12.10 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. ### 14.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.

Tabelle 14.10 Formatzeichen für benutzerdefinierte Zahlen- und Zeichenformate

Formatzeichen | Beschreibung
0 | Die Zahl 0 dient als Platzhalter für eine Zahl. Nichtsignifikante Nullen werden durch die Zahl 0 dargestellt.
# | Die Zahl 0 dient als Platzhalter für eine Zahl. Nichtsignifikante Nullen werden durch Leerzeichen dargestellt.
. | Das erste .-Zeichen in der Formatzeichenfolge bestimmt die Position des Dezimaltrennzeichens im formatierten Wert.
, | Dient als Tausendertrennung. Jedes Auftreten des Zeichens bewirkt eine Division durch 1000.
% | Das Zeichen bewirkt die Multiplikation mit 100. Das Prozentzeichen wird angehängt.
E0, E+0, E-0, e0, e+0, e-0 | Die Codes bewirken die Exponentialdarstellung einer Zahl. Mit E+0 und e+0 wird das positive Vorzeichen immer angezeigt, mit allen anderen immer nur das negative. Die Anzahl der Nullen bestimmt die Mindestanzahl von Ziffern des Exponenten.
\ | Das folgende Zeichen in der Formatzeichenfolge wird als Escape-Sequenz interpretiert.
ABC | Die in Anführungszeichen stehenden Zeichen werden direkt in die Ergebniszeichenfolge kopiert.
Nachfolgend wird an einigen Beispielen gezeigt, wie die Formatzeichen eingesetzt werden und zu welchem Ergebnis die Anweisungen führen:
    double d = 12345.67890;
    string str = d.ToString("000");    // Ausgabe: 12346
    str = d.ToString("0000000");       // Ausgabe: 00123456
    str = d.ToString("###");           // Ausgabe: 12346
    str = d.ToString("#,#####");       // Ausgabe: 12.346
    str = d.ToString("#.##");          // Ausgabe: 12345,68
    str = d.ToString("#.#####");       // Ausgabe: 12345,6789
    str = d.ToString("000e+000");      // Ausgabe: 123e+002
    str = d.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.
    str = DateTime.Now.ToString("MMM/yyyy/dd");
    // Ausgabe: Sep.2004.12
    str = DateTime.Now.ToString("HH:mm:ss");
    // Ausgabe: 09:22:30

Tabelle 14.11 Formatzeichen für benutzerdefinierte Datums- und Zeitformate

Formatmuster | Beschreibung
d | Monatstag ohne führende Null (1–31)
dd | Monatstag mit führender Null (01–31)
ddd | Abkürzung des Wochentags (Mon)
dddd | Vollständiger Name des Wochentags (Montag)
M | Monat ohne führende Null (1–12)
MM | Monat mit führender Null (01–12)
MMM | Abkürzung des Monatsnamens (Jan)
MMMM | Vollständiger Monatsname (Januar)
y | Zweistellige Jahreszahl ohne führende Null (3)
yy | Zweistellige Jahreszahl mit führender Null (03)
yyyy | Vollständige Jahreszahl (2003)
gg | Angabe der Zeitära
h | Stundenangabe in 12-Stunden-Schreibweise ohne führende Null
hh | Stundenangabe in 12-Stunden-Schreibweise mit führender Null
H | Stundenangabe in 24-Stunden-Schreibweise ohne führende Null
HH | Stundenangabe in 24-Stunden-Schreibweise mit führender Null
m | Minutenangabe ohne führende Null (0–59)
mm | Minutenangabe mit führender Null (00–59)
s | Sekundenangabe ohne führende Null (0–59)
ss | Sekundenangabe mit führender Null (0–59)
f–ffffff | Angabe von Sekundenbruchteilen
t | Das erste Zeichen des AM/PM-Kennzeichners (A entspricht AM, P entspricht PM.)
tt | AM oder PM
z | Zeitzonenangabe (+ oder –, gefolgt von der Stundenangabe; ohne führende Null)
zz | Zeitzonenangabe (+ oder –, gefolgt von der Stundenangabe; mit führender Null)
zzz | Vierstellige Zeitzonenangabe
/ | Es wird das Standardtrennzeichen für Datumsangaben eingesetzt.
: | Es wird das Standardtrennzeichen für Zeitangaben eingesetzt.