Formatmaske
Zuletzt geändert: 12.03.2024 12:02

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. Sie 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 lediglich in der Maske vorkommen. 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. dieses wird dann 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

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

Formatierung von Datumsfeldern #

Angabe Beschreibung
c Ausgabe im Standrformat 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 Perionde/Ära
gg Volle Darstellung der Periode/Ära
m Der jeweilige Monat als Zahl (1-12) ohn führende Null.
mm Der jeweilige Monat als Zahl (01-12) mit führender Null.
mmm Kurzform des Monatsnamen
mmmm Ausgeschriebenr 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)