Delphi 7 Help page

Format (Eigenschaft vonTDateTimePicker)

Die Eigenschaft Format legt das Format für einen Datums-/Zeitstring fest.

Delphi-Syntax:

property Format: String;


Beschreibung

Format legt einen benutzerdefinierten Formatstring für die Anzeige von Datums-/Zeitwerten fest und setzt damit die entsprechenden Strings in der Systemsteuerung außer Kraft. Ein benutzerdefiniertes Format kann Datums- und Zeitfelder enthalten. Zeitfelder können aber nur bearbeitet werden, wenn die Eigenschaft Kind den Wert dtkTime hat. Die folgende Tabelle enthält die Formatzeichen, die akzeptiert werden.

Element	Beschreibung
d	Ein- oder zweistellige Tagesangabe. 
dd	Zweistellige Tagesangabe. Einstelligen Tageswerten wird eine Null vorangestellt. 
ddd	Dreistellige Abkürzung für den Wochentag. 
dddd	Vollständigerer Name des Wochentags. 
h	Ein- oder zweistellige Stundenangabe im 12-Stunden-Format. 
hh	Zweistellige Stundenangabe im 12-Stunden-Format. Einstelligen Werten wird eine Null vorangestellt. 
H	Ein- oder zweistellige Stundenangabe im 24-Stunden-Format. 

HH	Zweistellige Stundenangabe im 24-Stunden-Format. Einstelligen Werten wird eine Null vorangestellt. 
m	Ein- oder zweistellige Minutenangabe. 
mm	Zweistellige Minutenangabe. Einstelligen Werten wird eine Null vorangestellt. 
M	Ein- oder zweistellige Monatsnummer. 
MM	Zweistellige Monatsnummer. Einstelligen Werten wird eine Null vorangestellt. 
MMM	Dreistellige Abkürzung für den Monat. 
MMMM	Vollständiger Name des Monats. 
t	Einstellige AM/PM-Abkürzung (AM wird als "A" angezeigt). 

tt	Zweistellige AM/PM-Abkürzung (AM wird als "AM" angezeigt). 
yy	Die beiden letzten Stellen des Jahres (2001 wird als "01" angezeigt). 
yyyy	Vollständige Jahresangabe (2001 wird als "2001" angezeigt).

Literale Strings in der Formatangabe müssen in einfache Anführungszeichen eingeschlossen werden, da es andernfalls zu unvorhersehbaren Ergebnissen kommen kann. Dies gilt auch dann, wenn der String keine Formatcodes enthält. Wenn ein einfaches Anführungszeichen in einem literalen String angezeigt werden soll, muss ihm ein weiteres einfaches Anführungszeichen vorangestellt werden. Um beispielsweise die Ausgabe "Müller's Büro: 01. April 2001" zu erhalten, müßten sie folgenden String verwenden:

'Müller''s Büro:' dd. MMMM yyyy

Beim programmgesteuerten Setzen von Format in Delphi-Quelltext müssen einfach Anführungszeichnen nochmals verdoppelt werden.

DateTimePicker1.Format := '''Müller''''s Büro:'' MMM dd, yyyy';