Formatierung
Format
| Funktion | Parameter | Rückgabewert |
|---|---|---|
Format |
string format, params object[] args |
string |
Ersetzt das formatierte Element in einer bestimmen format-Zeichenfolge mit dem Wert eines korrespondierenden Objektinstanz in einer bestimmten args Array.
Zum Beispiel beinhaltet der folgende Funktionsaufruf:
Format("Name = {0}, hours = {1:hh}", myName, DateTime.Now)
die folgenden formatierten Elemente: {0} and {1:hh}. Diese werden durch Werte der myName und DateTime.Now ersetzt. Die Ergebnisse können folgendermaßen aussehen:
Name = Alex, hours = 12
Jedes formatierte Element nimmt die folgende Form an:
{index[,alignment][:formatString]}
index- ein nullbasierter Integer der anzeigt welches Element in einer Liste von Objekten formatiert werden soll;alignment- ein optionaler Integer, der die minimale Weite des Bereichs anzeigt, der den formatierten Wert beinhaltet. Ist die Länge des formatierten Wertes geringer als die Ausrichtung, wird der Bereich mit Leerzeichen aufgefüllt. Ist die Ausrichtung negativ wird der formatierte Wert nach links im Bereich ausgerichtet; ist die Ausrichtung positiv wird der formatierte Wert nach rechts ausgerichtet;formatString- eine optionale Zeichenfolge für Spezifizierer der Formatierung.
Die folgende Tabelle beschreibt die standardmäßigen, numerischen Zeichenfolgen zur Formatierung.
| Spezifizierer der Formatierung | Name | Beschreibung |
|---|---|---|
| C or c | Währung | Die Zahl wird in eine Zeichenfolge umgewandelt, die den Währungsbetrag repräsentiert.Format("{0:C}", 10) = "10,00 €" |
| D or d | Dezimalwert | Diese Format unterstützt lediglich Ganzzahltypen. Die Zahl wird in eine Zeichenfolge von Dezimalzahlen (0-9) umgewandelt.Format("{0:D}", 10) = "10" |
| E oder e | Wissenschaftlich | Die Zahl wird in eine Zeichenfolge der folgenden Art umgewandelt: -d.ddd…E+ddd oder -d.ddd…e+ddd. Jede Ziffer d steht für eine Ziffer (0-9).Format("{0:E}", 10) = "1,000000E+001" |
| F oder f | Fester Punkt | Die Zahl wird in eine Zeichenfolge des Formats -ddd.ddd… umgewandelt, wobei d eine Ziffer anzeigt (0-9).Format("{0:F}", 10) = "10,00" |
| G oder g | Allgemein | Die Zahl wird in die komprimierteste Notation umgewandelt.Format("{0:G}", 10) = "10" |
| N oder n | Zahl | Die Zahl wird in eine Zeichenfolge des Formats -d,ddd,ddd.ddd umgewandelt, wobei d eine Ziffer anzeigt (0-9).Format("{0:N}", 1234.56) = "1.234,56" |
| P oder p | Prozentsatz | Die Zahl wird in eine Zeichenfolge umgewandelt, den Prozentsatz repräsentiert. Zur Darstellung des Prozentsatzes, wird die konvertierte Zahl wird mit 100 multipliziert.Format("{0:P}", 0.15) = "15,00%" |
| X oder x | Hexadezimal | Die Zahl wird in eine Zeichenfolge von hexadezimalen Ziffern konvertiert. Der Fall der Spezifizierer des Formats zeigt an, ob Klein-, oder Großbuchstaben für die hexadezimalen Ziffern größer als 9 angezeigt werden. Beispielsweise wird X zur Erstellung von ABCDEF und x zur Erstellung von abcdef genutzt.Format("{0:X}", 26) = "1A" |
Bei der Formatierung der Gleitkommata kann eine Anzahl an Dezimalstellen nach der Zeichenfolge angezeigt werden:
Format("{0:C1}", 12.23) = "12,2 €"
Bietet der standardmäßige numerische Spezifizierer des Formats nicht die gewünschte Formatierungsart, kann eine benutzerdefinierte Zeichenfolge zur Formatierung eingegeben werden:
| Format Zeichen | Beschreibung |
|---|---|
| 0 | Platzhalter Null Hat der formatierte Wert in der Zeichenfolge eine Ziffer in der Position an der die 0 erscheint, wird diese Ziffer in die Ergebniszeichenfolge kopiert. Die Position der am weitesten Links positionierten 0 vor der Dezimalstelle und der am weitesten rechts positionieren 0 nach der Dezimalstelle bestimmt den Ziffernbereich der stets in der Ergebniszeichenfolge vorhanden ist. |
| # | Platzhalter Ziffer Hat der formatierte Wert in der Zeichenfolge eine Ziffer in der Position an der das # erscheint, wird diese Ziffer in die Ergebniszeichenfolge kopiert. Anderweitig wird nichts in diese Position des Ergebniszeichenfolge kopiert. |
| . | Dezimalstelle Das erste .-Symbol im Formatierungszeichenfolge bestimmt die Positionierung der Dezimalstelle in dem formatierten Wert. |
| , | Tausendertrennzeichen. Beinhaltet die Zeichenfolge einen ,-Symbol dann hat wird die Ausgabe ein Tausendertrennzeichen zwischen Gruppen von drei Ziffern zur linken der Dezimalstelle anzeigen. |
| % | Platzhalter Prozent Die Anwesenheit eines %-Symbols in einer Zeichenfolge resultiert in einer Zahl multipliziert mit 100 vor der Formatierung. |
| ; | Abschnittszeichen Das ;-Symbol wird zur Trennung von Abschnitten für positive, negative und Null-Zahlen in einer Zeichenfolge genutzt. |
Anwendungsbeispiele:
Format("{0:#,##0.00 €}", 1024.25) = "1.024,25 €"
Format("{0:00%}", 0.25) = "25%"
Format("{0:#,##0.00 €;(#,##0.00 €);Zero}", 1024.25) = "1.024,25 €"
Format("{0:#,##0.00 €;(#,##0.00 €);Zero}", -1024.25) = "(1.024,25 €)"
Format("{0:#,##0.00 €;(#,##0.00 €);Zero}", 0) = "Zero"
Die folgende Tabelle gibt einen Überblick über die standardmäßigen Spezifizierer des Formats der DateTime-Werte:
| Spezifizierer der Formatierung | Name | Beispiel |
|---|---|---|
| d | Kurzes Datenmuster | "02.04.2024" |
| D | Langes Datenmuster | "Dienstag, 2. April 2024" |
| f | Komplettes Datum-,/Zeit-Muster (Kurzes Zeitformat) | "Dienstag, 2. April 2024 20:41" |
| F | Komplettes Datum-,/Zeit-Muster (langes Zeitformat) | "Dienstag, 2. April 2024 20:41:00" |
| g | Allgemeines Datum-,/Zeit-Muster (kurzes Zeitformat) | "02.04.2024 20:41" |
| G | Allgemeines Datum-,/Zeit-Muster (langes Zeitformat) | "02.04.2024 20:41:00" |
| t | Kurzes Zeitmuster | "20:41" |
| T | Langes Zeitmuster | "20:41:00" |
In der folgenden Tabelle werden die benutzerdefinierten Datum/Zeit Spezifizierer für das Format beschrieben und deren produziertes Ergebnis.
| Spezifizierer der Formatierung | Beschreibung |
|---|---|
| d | Zeigt den aktuellen Tag des Monats, gemessen als Zahl zwischen 1 und 31 (einschließlich), an. Ist der Tag nur einstellig (1-9) wird er entsprechend als einzelne Ziffer angezeigt. |
| dd | Zeigt den aktuellen Tag des Monats, gemessen als Zahl zwischen 1 und 31 (einschließlich), an. Ist der aktuelle Tag einstellig (1-9) wird er mit einer vorangehenden 0 (01-09) formatiert. |
| ddd | Zeigt den abgekürzten Namen des Tages an. |
| dddd | Zeigt den vollständigen Namen des Tages an. |
| f or F | Zeigt die wichtigste Ziffer des zweiten Bruchs an. |
| h | Zeigt die Stunde im Bereich 1-12 an. Ist die Stunde einstellig (1-9) wird sie entsprechend als einzelne Ziffer angezeigt. |
| hh | Zeigt die Stunde im Bereich 1-12 an. Ist die Stunde einstellig (1-9) wird sie mit einer vorangehenden 0 (01-09) formatiert. |
| H | Zeigt die Stunde im Bereich 0-23 an. Ist die Stunde einstellig (1-9) wird sie entsprechend als einzelne Ziffer angezeigt. |
| HH | Zeigt die Stunde im Bereich 0-23 an. Ist die Stunde einstellig (1-9) wird sie mit einer vorangehenden 0 (01-09) formatiert. |
| m | DZeigt die Minute im Bereich 0-59 an. Ist die Minute einstellig (0-9) wird sie entsprechend als einzelne Ziffer angezeigt. |
| mm | Zeigt die Minute im Bereich 0-59 an. Ist die Minute einstellig (0-9) wird sie mit einer vorangehenden 0 (01-09) formatiert. |
| M | Zeigt den Monat, gemessen als Zahl zwischen 1 und 12 (einschließlich), an. Ist der Monat einstellig (1-9) wird er mit einer vorangehenden 0 (01-09) formatiert. |
| MM | Zeigt den Monat, gemessen als Zahl zwischen 1 und 12 (einschließlich), an. Ist der Monat einstellig (1-9) wird er mit einer vorangehenden 0 (01-09) formatiert. |
| MMM | Zeigt den abgekürzten Namen des Monats an. |
| MMMM | Zeigt den vollständigen Namen des Monats an. |
| s | Zeigt die Sekunden im Bereich 0-59 an. Ist die Sekunde einstellig (0-9) wird sie entsprechend als einzelne Ziffer angezeigt. |
| ss | Zeigt die Sekunden im Bereich 0-59 an. Ist die Sekunde einstellig (0-9) wird sie mit einer vorangehenden 0 (01-09) formatiert. |
| t | Zeigt das ersten Zeichen des A.M./P.M. Kennzeichners an. |
| tt | Zeigt den A.M./P.M. Kennzeichner an. |
| y | Zeigt das Jahr maximal als zweistellige Zahl an. Die beiden ersten Ziffern des Jahres werden ausgelassen. Ist das Jahr einstellig (1-9) wird es entsprechend als einzelne Ziffer angezeigt. |
| yy | Zeigt das Jahr maximal als zweistellige Zahl an. Die beiden ersten Ziffern des Jahres werden ausgelassen. Ist das Jahr einstellig (1-9) wird es mit einer vorangehenden 0 (01-09) formatiert. |
| yyyy | Zeigt das Jahr, einschließlich des Jahrhunderts an. Ist das Jahr kürzer als vier Ziffern werden, falls notwendig, vorangehende Nullen hinzugefügt, um das angezeigte Jahr auf vier Stellen zu erweitern. |
| z | Zeigt die Zeitzone für die aktuelle Zeitzone des Systems in ausschließlich ganzen Stunden an. Die zeitliche Verschiebung wird stets mit dem führenden Symbol (Null wird als "+0" angezeigt) zur Greenwich Mean Time, als vor (+) oder nach (-) angezeigt. Der Wertebereich liegt zwischen -12 und +13. Ist die Verschiebung einstellig (0-9) wird sie entsprechend als einzelne Ziffer mit dem entsprechenden Führungssymbol angezeigt. |
| zz | Zeigt die Verschiebung der Zeitzone für die aktuelle Zeitzone des Systems in ausschließlich ganzen Stunden an. Die zeitliche Verschiebung wird stets mit einem Führungs-, oder Spätsymbol (null wird als "+00" angezeigt), die den Unterschied zur Greenwich Mean Time, als vor (+) oder nach (-) anzeigen, dargestellt. Der Wertebereich liegt zwischen -12 und +13. Ist die Verschiebung einstellig (0-9) wird sie entsprechend mit einer vorangehenden 0 (01-09) und dem entsprechenden Führungszeichen angezeigt. |
| zzz | Zeigt die Verschiebung der Zeitzone für die aktuelle Zeitzone des Systems in Stunden und Minuten an. Die zeitliche Verschiebung wird stets mit einem Führungs-, oder Spätsymbol (null wird als "00:00" angezeigt), die den Unterschied zur Greenwich Mean Time, als vor (+) oder nach (-) anzeigen, dargestellt. Der Wertebereich liegt zwischen -12:00 und +13:00. Ist die Verschiebung einstellig (0-9) wird sie entsprechend mit einer vorangehenden 0 (01-09) und dem entsprechenden Führungszeichen angezeigt. |
| : | Das Trennzeichen für die Zeit |
| / | Das Trennzeichen für das Datum. |
Anwendungsbeispiele:
Format("{0:d MMM yyyy}", DateTime.Now) = "2 Apr 2024"
Format("{0:dd/MM/yyyy}", DateTime.Now) = "02.04.2024"
Format("{0:MMMM, d}", DateTime.Now) = "April, 2"
Format("{0:HH:mm}", DateTime.Now) = "20:41"
Format("{0:dd/MM/yyyy hh:mm tt}", DateTime.Now) = "02.04.2024 20:41"
FormatCurrency
| Funktion | Parameter | Rückgabewert |
|---|---|---|
FormatCurrency |
object value |
string |
Formatiert den bestimmten Wert in eine Währung mittels der Ländereinstellungen.
Beispiel:
FormatCurrency(1.25) = "1,25 €"
| Funktion | Parameter | Rückgabewert |
|---|---|---|
FormatCurrency |
object value, int decimalDigits |
string |
Formatiert den bestimmten Wert in eine Währung. Der Parameter decimalDigits zeigt an, wie viele Stellen zur rechten der Dezimalstelle angezeigt werden.
Beispiel:
FormatCurrency(1.25, 1) = "1,3 €"
FormatDateTime
| Funktion | Parameter | Rückgabewert |
|---|---|---|
FormatDateTime |
DateTime value |
string |
Formatiert den bestimmten Wert in eine Datums-,/Zeitangabe mittels der Ländereinstellungen. Diese Funktion beinhaltet keine neutralen Werte in der resultierenden Zeichenfolge.
Beispiel:
FormatDateTime(new DateTime(2024,4,2)) = "02.04.2024"
FormatDateTime(new DateTime(2024,4,2,1,30,0)) = "02.04.2024 01:30:00"
FormatDateTime(new DateTime(1,1,1,1,30,1)) = "01:30:01"
| Funktion | Parameter | Rückgabewert |
|---|---|---|
FormatDateTime |
DateTime value, string format |
string |
Formatiert den bestimmten Wert in eine Datums-,/Zeitangabe mittels der in dem format Parameter benannten Spezifizierer für das Format. Die gültigen Werte für diesen Parameter sind:
- Long Date;
- Short Date;
- Long Time;
- Short Time.
Beispiel:
FormatDateTime(new DateTime(2024,4,2,1,30,0), "Long Date") = "Dienstag, 2. April 2024"
FormatDateTime(new DateTime(2024,4,2), "Short Date") = "02.04.2024"
FormatDateTime(new DateTime(1,1,1,1,30,1), "Long Time") = "01:30:01"
FormatDateTime(new DateTime(1,1,1,1,30,1), "Short Time") = "01:30"
FormatNumber
| Funktion | Parameter | Rückgabewert |
|---|---|---|
FormatNumber |
object value |
string |
Formatiert, mittels der Ländereinstellungen von Windows, den bestimmten Wert in eine Zahl.
Beispiel:
FormatNumber(1234.56) = "1.234,56"
| Funktion | Parameter | Rückgabewert |
|---|---|---|
FormatNumber |
object value, int decimalDigits |
string |
Formatiert den bestimmten Wert in eine Zahl. Der Parameter decimalDigits zeigt an, wie viele Stellen zur rechten der Dezimalstelle angezeigt werden.
Beispiel:
FormatNumber(1234.56, 1) = "1.234,6"
FormatPercent
| Funktion | Parameter | Rückgabewert |
|---|---|---|
FormatPercent |
object value |
string |
Formatiert, mittels der Ländereinstellungen von Windows, den bestimmten Wert in Prozent.
Beispiel:
FormatPercent(0.15) = "15,00%"
| Funktion | Parameter | Rückgabewert |
|---|---|---|
FormatPercent |
object value, int decimalDigits |
string |
Formatiert den bestimmten Wert in Prozent. Der Parameter decimalDigits zeigt an, wie viele Stellen zur rechten der Dezimalstelle angezeigt werden.
Beispiel:
FormatPercent(0.15, 0) = "15%"