Data.DB.TAggregateField.DisplayFormat

Übergeordnet: TAggregateField

Delphi

property DisplayFormat: string read FDisplayFormat write SetDisplayFormat;

C++

__property System::UnicodeString DisplayFormat = {read=FDisplayFormat, write=SetDisplayFormat};

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
property	published	Data.DB.pas Data.DB.hpp	Data.DB	TAggregateField

Beschreibung

Steuert die Formatierung des Datums-/Zeitfeldes für Anzeigezwecke.

Mit der Eigenschaft DisplayFormat können Sie die automatische Feldformatierung für die Anzeige ändern, wenn ResultType ftFloat, ftCurrency, ftDate, ftTime oder ftDateTime ergibt.

Wenn ResultType ftFloat oder ftCurrency liefert, kann der Wert von DisplayFormat einen String zur Datenformatierung mit den folgenden Formatbezeichnern enthalten:

Bezeichner	Repräsentiert
0	Platzhalter für Ziffern. Wenn der formatierte Wert an der Stelle eine Ziffer enthält, an der im Format-String das Zeichen 0 (Null) steht, wird die betreffende Ziffer in den Ausgabe-String übernommen. Andernfalls erscheint im Ausgabe-String an dieser Position eine Null.
#	Platzhalter für Ziffern. Wenn der formatierte Wert an der Stelle eine Ziffer enthält, an der im Format-String das Zeichen # steht, dann wird diese Ziffer in den Ausgabe-String übernommen. Andernfalls wird an dieser Position kein Zeichen im Ausgabe-String gespeichert.
.	Dezimaltrennzeichen. Der erste Punkt im Format-String bestimmt die Position des Dezimaltrennzeichens im formatierten Wert. Alle weiteren Punktzeichen werden ignoriert. Das tatsächlich im Ausgabe-String verwendete Zeichen wird mit der globalen Variable DecimalSeparator festgelegt. Der Standardwert von DecimalSeparator wird in der Windows-Systemsteuerung unter Ländereinstellungen definiert (Register Eigenschaften von Ländereinstellungen, Registerkarte Zahlen).
,	Tausendertrennzeichen. Wenn der Format-String ein oder mehrere Kommazeichen enthält, werden im Ausgabe-String alle Stellen links vom Dezimaltrennzeichen in Dreiergruppen gegliedert, die jeweils durch ein Tausendertrennzeichen getrennt sind. Um zu kennzeichnen, dass ein Tausendertrennzeichen gewünscht wird, ist es nicht von Bedeutung, wie viele Kommas der Format-String enthält. Auch die Position ist beliebig. Das tatsächlich im Ausgabe-String verwendete Zeichen wird mit der globalen Variable ThousandSeparator festgelegt. Der Standardwert von ThousandSeparator wird in der Windows-Systemsteuerung unter Ländereinstellungen definiert (Register Eigenschaften von Ländereinstellungen, Registerkarte Zahlen).
E+	Wissenschaftliche Notation. Sobald der Format-String einen der Bezeichner "E+", "E-", "e+" oder "e-" enthält, wird die formatierte Zahl in wissenschaftlicher Notation dargestellt. Unmittelbar nach "E+", "E-", "e+" oder "e-" kann eine Gruppe von bis zu vier Nullen folgen, mit denen die minimale Stellenzahl im Exponenten festgelegt wird. Die beiden Kürzel "E+" und "e+" bewirken, dass sowohl positive als auch negative Exponenten mit einem Vorzeichen versehen werden. Die Kürzel "E-" und "e-" bewirken, dass nur negative Exponenten ein Vorzeichen erhalten.
'xx'/"xx"	In halbe oder ganze Anführungszeichen eingeschlossene Zeichen wirken sich nicht auf die Formatierung aus und werden wie eingegeben angezeigt.
;	Trennt Abschnitte für positive, negative und Nullwerte im Format-String.
c	Das Datum wird im Format der globalen Variable ShortDateFormat angezeigt, gefolgt von der Zeitangabe im Format von LongTimeFormat. Wenn der Zeitanteil 0 ist, wird keine Uhrzeit ausgegeben.
d	Der Tag wird als Zahl ohne führende Null dargestellt (1-31).
dd	Der Tag wird als Zahl mit führender Null dargestellt (01-31).
ddd	Der Name des Wochentags wird als verkürzter String ausgegeben (So bis Sa). Die Strings sind in der globalen Variable ShortDayNames hinterlegt.
dddd	Der Wochentag wird mit seinem vollständigen Namen ausgegeben (Sonntag bis Samstag). Die Strings sind in der globalen Variable LongDayNames definiert.
ddddd	Das Datum wird in dem Format dargestellt, das die globale Variable ShortDateFormat beschreibt.
dddddd	Das Datum wird in dem Format dargestellt, das die globale Variable LongDateFormat beschreibt.
m	Der Monat wird als Zahl ohne führende Null dargestellt (1 bis 12). Wenn auf den Bezeichner m unmittelbar der Bezeichner h oder hh folgt, werden an Stelle des Monats die Minuten angezeigt.
mm	Der Monat wird als Zahl mit führender Null dargestellt (01 bis 12). Wenn auf den Bezeichner mm unmittelbar der Bezeichner h oder hh folgt, werden an Stelle des Monats die Minuten angezeigt.
mmm	Der Name des Monats wird als Abkürzung dargestellt (Jan bis Dez). Die Strings sind in der globalen Variable ShortMonthNames hinterlegt.
mmmm	Der Monat wird mit seinem vollständigen Namen ausgegeben (Januar bis Dezember). Die Strings sind in der globalen Variable LongMonthNames definiert.
yy	Das Jahr wird als zweistellige Zahl dargestellt (00 bis 99).
yyyy	Das Jahr wird als vierstellige Zahl dargestellt (0000 bis 9999).
h	Die Stunde wird ohne führende Null dargestellt (0 bis 23).
hh	Die Stunde wird mit führender Null dargestellt (00 bis 23).
n	Die Minute wird ohne führende Null dargestellt (0 bis 59).
nn	Die Minute wird mit führender Null dargestellt (00 bis 59).
s	Die Sekunde wird ohne führende Null dargestellt (0 bis 59).
ss	Die Sekunde wird mit führender Null dargestellt (00 bis 59).
t	Die Zeit wird in dem Format ausgegeben, das in der globalen Variable ShortTimeFormat festgelegt ist.
tt	Die Zeit wird in dem Format ausgegeben, das in der globalen Variable LongTimeFormat festgelegt ist.
am/pm	Die Zeit wird im 12-Stunden-Format dargestellt, wenn der Bezeichner h oder hh vorangeht. Zeiten vor dem Mittag werden mit 'am', alle anderen Zeiten mit 'pm' gekennzeichnet. Der Bezeichner am/pm kann in Großbuchstaben, in Kleinbuchstaben oder in gemischter Schreibweise eingegeben werden. Die Ausgabe wird entsprechend angepasst.
a/p	Die Zeit wird im 12-Stunden-Format dargestellt, wenn der Bezeichner h oder hh vorangeht. Zeiten vor dem Mittag werden mit 'a', alle anderen Zeiten mit 'p' gekennzeichnet. Der Bezeichner a/p kann in Großbuchstaben, in Kleinbuchstaben oder in gemischter Schreibweise eingegeben werden. Die Ausgabe wird entsprechend angepasst.
ampm	Die Zeit wird im 12-Stunden-Format dargestellt, wenn der Bezeichner h oder hh vorangeht. Allen Zeitangaben vor dem Mittag wird der Inhalt der globalen Variablen TimeAMString hinzugefügt, allen übrigen Zeiten der Inhalt von TimePMString.
/	Als Trennzeichen für das Datum wird das Zeichen verwendet, das in der globalen Variable DateSeparator hinterlegt ist.
:	Als Trennzeichen für die Uhrzeit wird das Zeichen verwendet, das in der globalen Variable TimeSeparator hinterlegt ist.
'xx'/"xx"	Zeichen zwischen halben oder ganzen Anführungszeichen werden unverändert ausgegeben und haben keinen Einfluss auf die Formatierung.

Innerhalb des Format-Strings bestimmt die Position des am weitesten links stehenden Nullzeichens zusammen mit der Position des am weitesten rechts stehenden Nullzeichens (bezogen auf das Dezimaltrennzeichen) die Anzahl der Stellen, die immer im Ausgabe-String angezeigt werden.

Die darzustellende Zahl wird bei der Formatierung stets auf die Anzahl von Nachkommastellen gerundet, die durch die Anzahl der Ziffern-Platzhalter ("0" oder "#") rechts vom Dezimaltrennzeichen vorgegeben ist. Fehlt im Format-String ein Dezimaltrennzeichen, wird der formatierte Wert auf die nächste ganze Zahl gerundet.

Wenn die festgelegte Anzahl von Vorkommastellen nicht ausreicht, um eine Zahl darzustellen, werden vor dem ersten Ziffern-Platzhalter zusätzliche Stellen eingefügt.

Das Semikolon gliedert den Format-String in bis zu drei Abschnitte, in denen jeweils eine eigene Formatierung für positive und negative Zahlen sowie für Nullen definiert werden kann.

Ein Abschnitt: Der Format-String wird für alle Werte verwendet.

Zwei Abschnitte: Der erste Abschnitt wird für positive und Nullwerte, der zweite Abschnitt für negative Werte verwendet.

Drei Abschnitte: Der erste Abschnitt wird für positive, der zweite für negative und der dritte Abschnitt für Nullwerte verwendet.

Wenn der Abschnitt für negative Werte oder der Abschnitt für Nullen leer ist, wenn also zwischen den Semikolons nichts steht, wird stattdessen der Abschnitt für positive Werte verwendet.

Wenn der Abschnitt für positive Zahlen leer ist oder der gesamte Format-String leer ist, erfolgt eine standardisierte Gleitkommaformatierung mit 15 signifikanten Stellen. Die allgemeine Formatierung für Gleitkommawerte wird auch verwendet, wenn der Wert mehr als 18 Ziffern links neben dem Dezimalzeichen enthält und im Format-String keine wissenschaftliche Schreibweise festgelegt wurde.

Wenn ResultType ftDate, ftTime oder ftDateTime ergibt, kann der Wert von DisplayFormat einen String zur Datenformatierung mit den folgenden Formatbezeichnern enthalten:

Bezeichner	Anzeige
c	Das Datum wird im Format der globalen Variable ShortDateFormat angezeigt, gefolgt von der Zeitangabe im Format von LongTimeFormat. Wenn der Zeitanteil 0 ist, wird keine Uhrzeit ausgegeben.
d	Der Tag wird als Zahl ohne führende Null dargestellt (1-31).
dd	Der Tag wird als Zahl mit führender Null dargestellt (01-31).
ddd	Der Name des Wochentags wird als verkürzter String ausgegeben (So bis Sa). Die Strings sind in der globalen Variable ShortDayNames hinterlegt.
dddd	Der Wochentag wird mit seinem vollständigen Namen ausgegeben (Sonntag bis Samstag). Die Strings sind in der globalen Variable LongDayNames definiert.
ddddd	Das Datum wird in dem Format dargestellt, das die globale Variable ShortDateFormat beschreibt.
dddddd	Das Datum wird in dem Format dargestellt, das die globale Variable LongDateFormat beschreibt.
m	Der Monat wird als Zahl ohne führende Null dargestellt (1 bis 12). Wenn auf den Bezeichner m unmittelbar der Bezeichner h oder hh folgt, werden an Stelle des Monats die Minuten angezeigt.
mm	Der Monat wird als Zahl mit führender Null dargestellt (01 bis 12). Wenn auf den Bezeichner mm unmittelbar der Bezeichner h oder hh folgt, werden an Stelle des Monats die Minuten angezeigt.
mmm	Der Name des Monats wird als Abkürzung dargestellt (Jan bis Dez). Die Strings sind in der globalen Variable ShortMonthNames hinterlegt.
mmmm	Der Monat wird mit seinem vollständigen Namen ausgegeben (Januar bis Dezember). Die Strings sind in der globalen Variable LongMonthNames definiert.
yy	Das Jahr wird als zweistellige Zahl dargestellt (00 bis 99).
yyyy	Das Jahr wird als vierstellige Zahl dargestellt (0000 bis 9999).
h	Die Stunde wird ohne führende Null dargestellt (0 bis 23).
hh	Die Stunde wird mit führender Null dargestellt (00 bis 23).
n	Die Minute wird ohne führende Null dargestellt (0 bis 59).
nn	Die Minute wird mit führender Null dargestellt (00 bis 59).
s	Die Sekunde wird ohne führende Null dargestellt (0 bis 59).
ss	Die Sekunde wird mit führender Null dargestellt (00 bis 59).
t	Die Zeit wird in dem Format ausgegeben, das in der globalen Variable ShortTimeFormat festgelegt ist.
tt	Die Zeit wird in dem Format ausgegeben, das in der globalen Variable LongTimeFormat festgelegt ist.
am/pm	Die Zeit wird im 12-Stunden-Format dargestellt, wenn der Bezeichner h oder hh vorangeht. Zeiten vor dem Mittag werden mit 'am', alle anderen Zeiten mit 'pm' gekennzeichnet. Der Bezeichner am/pm kann in Großbuchstaben, in Kleinbuchstaben oder in gemischter Schreibweise eingegeben werden. Die Ausgabe wird entsprechend angepasst.
a/p	Die Zeit wird im 12-Stunden-Format dargestellt, wenn der Bezeichner h oder hh vorangeht. Zeiten vor dem Mittag werden mit 'a', alle anderen Zeiten mit 'p' gekennzeichnet. Der Bezeichner a/p kann in Großbuchstaben, in Kleinbuchstaben oder in gemischter Schreibweise eingegeben werden. Die Ausgabe wird entsprechend angepasst.
ampm	Die Zeit wird im 12-Stunden-Format dargestellt, wenn der Bezeichner h oder hh vorangeht. Allen Zeitangaben vor dem Mittag wird der Inhalt der globalen Variablen TimeAMString hinzugefügt, allen übrigen Zeiten der Inhalt von TimePMString.
/	Als Trennzeichen für das Datum wird das Zeichen verwendet, das in der globalen Variable DateSeparator hinterlegt ist.
:	Als Trennzeichen für die Uhrzeit wird das Zeichen verwendet, das in der globalen Variable TimeSeparator hinterlegt ist.
'xx'/"xx"	Zeichen zwischen halben oder ganzen Anführungszeichen werden unverändert ausgegeben und haben keinen Einfluss auf die Formatierung.