Formatierung von Datenfeldern #

Im Berichtsdesigner, in den Eingabemasken und an anderen Stellen wird eine Formatmaske (“DisplayFormat”) für die Darstellung der Datums- und Zahlenwerte verwendet. Die einzelnen Angaben werden im folgenden erklärt.

Formatierung von Zahlenfeldern #

Angabe	Beschreibung
`0`	Dient als Platzhalter für eine einzelne Ziffer. Die Stelle wird mit “0” in der Ausgabe erzeugt, wenn die Stelle im eigentlichen Zahlenwert nicht vorkommt. Hierdurch ist es möglich eine Zahl vorzunullen oder eine feste Anzahl von Nachkommastellen zu erzeugen.
`#`	Platzhalter für eine optionale Ziffer. Die Stelle wird nur ausgegeben, wenn sie einen relevanten Wert hat.
`.`	Der Dezimaltrenner trennt die Vorkomma- von den Nachkommastellen. Damit die Formatmaske allgemeingültig ist, wird die englische Schreibweise, also ein einzelner Punkt verwendet. Bei der Ausgabe wird dann jeweils wieder die landesübliche Darstellung verwendet - in Deutschland z.B. das Komma (`,`).
`,`	Tausender-Unterteilung - Die Ausgabe wird in Dreierblöcken mit den jeweils üblichen Zeichen für die Tausender-Unterteilung ausgegeben - in Deutschland z.B. dem Punkt (`.`). In der Format-Maske muss jedoch immer die englische Schreibweise, also das Komma, verwendet werden. Das Komma muss nur einmal irgendwo in der Maske vorkommen – die genaue Position ist unwichtig. Es ist unbedeutend, wo es vorkommt oder wie oft.
`E+`	Ausgabe in der wissenschaftlichen Notation (Exponentialschreibweise).
`'xx'`/`"xx"`	Es können auch beliebige feste Zeichen mit ausgegeben werden. Diese müssen dann in einfache oder doppelte Anführungszeichen gesetzt werden.
`;`	Es ist möglich unterschiedliche Formate für negative Zahlen auszugeben. Die Formate werden dann durch ein Semikolon getrennt. Auf diese Weise kann sogar ein drittes Format hinterlegt werden. Das dritte Format wird speziell für den Wert Null (0) verwendet.

Beispiele #

Zahl / Maske	#,##0.00	#,##0.####	000000
10000,148	10.000,15	10.000,148	010000
10	10,00	10	000010
500,1	500,10	500,1	000500

Weitere Infos (externer Link, englisch): System.SysUtils.FormatFloat - RAD Studio API Documentation (embarcadero.com)

Formatierung von Datumsfeldern #

Angabe	Beschreibung
`c`	Ausgabe im Standardformat für kurzes Datum gefolgt von Standardformat für ausführliche Uhrzeit.
`d`	gibt den Tag (im Monat) als Zahl (1-31) und ohne führende Null aus.
`dd`	gibt den Tag (im Monat) als Zahl (01-31) mit führender Null aus.
`ddd`	Gibt den Wochentag in abgekürzter Form aus - typischerweise Mo. - So.
`dddd`	Gibt den ausgeschriebenen Wochentag zurück - “Montag”, “Samstag”
`ddddd`	Gibt das Datum im Standardformat für kurze Datumsdarstellung aus
`dddddd`	Gibt das Datum im Standardformat für lange Datumsdarstellung aus
`e`	Gibt das Jahr in der jeweiligen Periode/Ära aus - dies wird in japanischen, koreanischen oder taiwanesischen Kulturen verwendet
`ee`	wie “e” nur mit führenden Nullen
`g`	Abkürzung der Periode/Ära
`gg`	Volle Darstellung der Periode/Ära
`m`	Der jeweilige Monat als Zahl (1-12) ohne führende Null.
`mm`	Der jeweilige Monat als Zahl (01-12) mit führender Null.
`mmm`	Kurzform des Monatsnamen
`mmmm`	ausgeschriebener Monatsname
`yy`	Das zweistellige Jahr (00-99).
`yyyy`	Das vierstellige Jahr (0000-9999).
`h`	Die Stunde ohne führende Null (0-23).
`hh`	Die Stunde mit führender Null (00-23).
`n`	Die Minuten ohne führende Null (0-59).
`nn`	Die Minuten mit führender Null (00-59).
`s`	Sekunden ohne führende Null (0-59).
`ss`	Sekunden ohne führender Null (00-59).
`z`	Millisekunden ohne führende Null (0-999).
`zzz`	Millisekunden ohne führenden Nullen (000-999).
`t`	Die Zeit im Standardformat für die kurze Darstellung aus
`tt`	Die Zeit im Standardformat für die lange Darstellung aus
`am/pm`	für die amerikanische am/pm-Darstellung
`a/p`	für die amerikanische am/pm-Darstellung. Hierbei wird aber jeweils nur ein “a” oder “p” ausgegeben
`ampm`	nicht unterstützt
`/`	Zeigt das länderspezifische Zeichen für die Trennung der einzelnen Datumswerte (In Österreich und Deutschland z.B. der Punkt)
`:`	gibt das Trennzeichen für die Uhrzeit aus.
`'xx'`/`"xx"`	Es können auch beliebige feste Zeichen mit ausgegeben werden. Diese müssen dann in einfache oder doppelte Anführungszeichen gesetzt werden.

Siehe auch (externer Link in Englisch): System.SysUtils.FormatDateTime - RAD Studio API Documentation (embarcadero.com)