Data.DB.TDateTimeField.DisplayFormat

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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 TDateTimeField

Beschreibung

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

In DisplayFormat können Sie einen String angeben, der als Formatierungsanweisung für Datums-/Zeitwerte dient, wenn diese als String angezeigt werden. Wenn DisplayFormat kein String zugewiesen wurde, wird der Wert entsprechend den Datums-/Zeiteinstellungen in der Windows-Systemsteuerung formatiert.

Anmerkung:  DisplayFormat hat keinen Einfluss auf den Wert der Eigenschaft AsString.

Aus folgenden Formatbezeichnern können Sie einen DisplayFormat-String zusammensetzen:

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.

Als Formatbezeichner können Sie sowohl Groß- als auch Kleinbuchstaben verwenden. Das Ergebnis ist in beiden Fällen dasselbe.

Wenn der Parameter Format einen leeren String enthält, wird der Wert so formatiert, als wäre der Bezeichner c angegeben.

Siehe auch