Datum und Uhrzeit formatieren

Formatiert einen TDateTime-Wert.

Aufbau

FormatDateTime(const Format: string; DateTime: TDateTime): string;

Parameter

Rückgabewert

Beschreibung

FormatDateTime formatiert den von DateTime übergebenen TDateTime-Wert anhand des durch Format angegebenen Formats. Die folgenden Formatbezeichner werden unterstützt:

Der Bezeichner „

“ gibt das Datum im Format der globalen Variablen „ShortDateFormat“ an, gefolgt von der Uhrzeit im Format der globalen Variablen „LongTimeFormat“. Die Uhrzeit wird nicht angezeigt, wenn der Bruchteil des DateTime-Werts Null ist.

d Zeigt den Tag als Zahl ohne führende Null an (1–31).

dd Zeigt den Tag als Zahl mit einer führenden Null an (01–31).

ddd Zeigt den Tag als Abkürzung (So–Sa) an, wobei die von der globalen Variablen „ShortDayNames“ vorgegebenen Zeichenfolgen verwendet werden.

dddd Zeigt den Tag als vollständigen Namen (Sonntag–Samstag) an, wobei die von der globalen Variablen „LongDayNames“

en Zeichenfolgen verwendet werden.

ddddd Zeigt das Datum in dem Format an, das durch die globale Variable „ShortDateFormat“ vorgegeben ist.

dddddd Zeigt das Datum in dem Format an, das durch die globale Variable „LongDateFormat“ vorgegeben ist.

m Zeigt den Monat als Zahl ohne führende Null an (1–12). Wenn der Bezeichner „m“ unmittelbar auf einen Bezeichner „h“ oder „hh“ folgt, wird die Minute anstelle des Monats angezeigt.

mm Zeigt den Monat als Zahl mit einer führenden Null an (01–12). Wenn der Bezeichner „mm“ unmittelbar auf einen Bezeichner „h“ oder „hh“ folgt, wird die Minute anstelle des Monats angezeigt.

mmm Zeigt den Monat als Abkürzung (Jan–Dez) an, wobei die von der globalen Variablen ShortMonthNames vorgegebenen Zeichenfolgen verwendet werden.

mmmm Zeigt den Monat als vollständigen Namen (Januar–Dezember) an, wobei die von der globalen Variablen LongMonthNames bereitgestellten Zeichenfolgen verwendet werden.

yy Zeigt das Jahr als zweistellige Zahl an (00–99).

yyyy Zeigt das Jahr als vierstellige Zahl an (0000–9999).

h Zeigt die Stunde ohne führende Null an (0–23).

hh Zeigt die Stunde mit einer führenden Null an (00–23).

n Zeigt die Minute ohne führende Null an (0–59).

nn Zeigt die Minuten mit einer führenden Null an (00–59).

Zeigt die Sekunden ohne führende Null an (0–59).

ss Zeigt die Sekunde mit einer führenden Null an (00–59).

z Zeigt die Millisekunden ohne führende Null an (0–999).

zzz Zeigt die Millisekunden mit einer führenden Null an (000–999).

t Zeigt die Uhrzeit in dem Format an, das durch die globale Variable ShortTimeFormat vorgegeben ist.

tt Zeigt die Uhrzeit in dem Format an, das durch die globale Variable LongTimeFormat vorgegeben ist.

am/pm Verwendet die 12-Stunden-Uhr für den vorangestellten Bezeichner „h“ oder „hh“ und zeigt für jede Stunde vor Mittag „am“ und für jede Stunde nach Mittag „pm“ an. Bei der Angabe von „am“ und „pm“ können Klein-, Groß- oder gemischte Buchstaben verwendet werden, und das Ergebnis wird entsprechend angezeigt.

a/p Verwendet das 12-Stunden-Format für den vorangestellten Bezeichner „h“ oder „hh“ und zeigt „a“ für jede Stunde vor Mittag und „p“ für jede Stunde nach Mittag an. Der Bezeichner „a/p“ kann in Klein-, Groß- oder gemischter Schreibweise verwendet werden, und das Ergebnis wird entsprechend angezeigt.

ampm verwendet für den vorangestellten Bezeichner „h“ oder „hh“ das 12-Stunden-Format und zeigt für alle Stunden vor Mittag den Inhalt der globalen Variablen „TimeAMString“ an, für alle Stunden nach Mittag hingegen den Inhalt der globalen Variablen „TimePMString“.

/ Zeigt das Trennzeichen für das Datum an, das durch die globale Variable „DateSeparator“ festgelegt ist.

: Zeigt das Trennzeichen für die Uhrzeit an, das durch die globale Variable TimeSeparator vorgegeben ist.

Zeichen, die in einfache oder doppelte Anführungszeichen gesetzt sind, werden unverändert angezeigt und haben keinen Einfluss auf die Formatierung.

Formatbezeichner können sowohl in Groß- als auch in Kleinbuchstaben geschrieben werden – beide führen zum gleichen Ergebnis.

Ist die durch den Parameter „Format“ angegebene Zeichenfolge leer, wird der TDateTime-Wert so formatiert, als wäre ein Formatbezeichner vom Typ „c“ angegeben worden. |