FormatDateTime

Diese Funktion gehört zur Unit SysUtils und steht global zur Verfügung. Der Funktionstyp ist Funktion. Der Rückgabetyp ist vom Typ String.

Die Funktion verlangt folgende Parameter:

Parameter	Typ	Beschreibung
`Format`	`String`	Legt das Format für die Datumsformatierung fest.
`DateTime`	`TDateTime`	Das zu formatierende Datum.

Formatiert einen Wert des Typs TDateTime.

FormatDateTime formatiert den TDateTime-Wert, der von DateTime angegeben wurde. Dabei wird das von Format angegebene Format verwendet. Informationen über die unterstützten Format-Strings finden Sie in der Tabelle weiter unten.

Wird im Parameter Format ein leerer String übergeben, wird der Wert des Typs TDateTime entsprechend dem Formatbezeichner 'c' formatiert.

Format-Strings für Datums- und Time-Werte setzen sich aus Formatbezeichnern zusammen, die für die in den formatierten String einzufügende Werte stehen. Einige Formatbezeichner (wie z.B. "d") formatieren nur Zahlen oder Strings. Andere (wie z.B. "/") referenzieren länderspezifische Strings in den globalen Variablen.

Die folgende Tabelle enthält die Formatbezeichner in Kleinbuchstaben. Die Groß-/Kleinschreibung in Formaten wird nur bei den Bezeichnern "am/pm" und "a/p" berücksichtigt.

Bezeichner	Ausgabe
c	Zeigt das Datum in dem in der globalen Variablen ShortDateFormat angegebenen Format an. Dahinter wird die Uhrzeit, in dem in der globalen Variablen LongTimeFormat festgelegten Format dargestellt. Die Uhrzeit erscheint nicht, wenn der Datums-/Zeitwert exakt Mitternacht ergibt.
d	Zeigt den Tag als Zahl ohne führende Null an (1-31).
dd	Zeigt den Tag als Zahl mit führender Null an (01-31).
ddd	Zeigt den Wochentag als Abkürzung (Son-Sam) in den in der globalen Variablen ShortDayNames festgelegten Strings an.
dddd	Zeigt den ausgeschriebenen Wochentag (Sonntag-Samstag) in den in der globalen Variablen LongDayNames festgelegten Strings an.
ddddd	Zeigt das Datum in dem in der globalen Variablen ShortDateFormat angegebenen Format an.
dddddd	Zeigt das Datum in dem in der globalen Variablen LongDateFormat angegebenen Format an.
e	(Nur Windows) Zeigt das Jahr in der aktuellen Datums-/Zeitangabe als Zahl ohne führende Null an (gilt nur für die japanische, koreanische und taiwanesische Ländereinstellung).
ee	(Nur Windows) Zeigt das Jahr in der aktuellen Datums-/Zeitangabe als Zahl mit führender Null an (gilt nur für die japanische, koreanische und taiwanesische Ländereinstellung).
g	(Nur Windows) Zeigt die Datums-/Zeitangabe als Abkürzung an (gilt nur für die japanische und taiwanesische Ländereinstellung).
gg	(Nur Windows) Zeigt die Datums-/Zeitangabe in ausgeschriebener Form an (gilt nur für die japanische und taiwanesische Ländereinstellung).
m	Zeigt den Monat als Zahl ohne führende Null an (1-12). Wenn auf den Bezeichner m unmittelbar der Bezeichner h oder hh folgt, werden an Stelle des Monats die Minuten angezeigt.
mm	Zeigt den Monat als Zahl mit führender Null an (01-12). Wenn auf den Bezeichner mm unmittelbar der Bezeichner h oder hh folgt, werden an Stelle des Monats die Minuten angezeigt.
mmm	Zeigt den Monatsnamen als Abkürzung (Jan-Dez) in den in der globalen Variablen ShortMonthNames festgelegten Strings an.
mmmm	Zeigt den ausgeschriebenen Monatsnamen (Januar-Dezember) in den in der globalen Variablen LongMonthNames festgelegten Strings an.
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 führender Null an (00-23).
n	Zeigt die Minute ohne führende Null an (0-59).
nn	Zeigt die Minute mit führender Null an (00-59).
s	Zeigt die Sekunde ohne führende Null an (0-59).
ss	Zeigt die Sekunde mit führender Null an (00-59).
z	Zeigt die Millisekunde ohne führende Null an (0-999).
zzz	Zeigt die Millisekunde mit führender Null an (000-999).
t	Zeigt die Uhrzeit in dem in der globalen Variablen ShortTimeFormat angegebenen Format an.
tt\	Zeigt die Uhrzeit in dem in der globalen Variablen LongTimeFormat angegebenen Format an.
am/pm	Verwendet die 12-Stunden-Zeitanzeige für den vorhergehenden Bezeichner h oder hh und zeigt alle Stunden vor Mittag mit dem String 'am' und alle Stunden nach Mittag mit dem String 'pm' an. Der Bezeichner am/pm kann in Großbuchstaben, in Kleinbuchstaben oder in gemischter Schreibweise eingegeben werden. Die Ausgabe wird entsprechend angepasst.
a/p	Verwendet die 12-Stunden-Zeitanzeige für den vorhergehenden Bezeichner h oder hh und zeigt alle Stunden vor Mittag mit dem Zeichen 'a' und alle Stunden nach Mittag mit dem Zeichen 'p' an. Der Bezeichner a/p kann in Großbuchstaben, in Kleinbuchstaben oder in gemischter Schreibweise eingegeben werden. Die Ausgabe wird entsprechend angepasst.
ampm	Verwendet die 12-Stunden-Zeitanzeige für den vorhergehenden Bezeichner h oder hh und zeigt alle Stunden vor Mittag mit dem String aus der globalen Variablen TimeAMString und alle Stunden nach Mittag mit dem String aus der globalen Variable TimePMString an.
/	Zeigt als Datumstrennzeichen das in der globalen Variablen DateSeparator angegebene Zeichen an.
:	Zeigt als Uhrzeittrennzeichen das in der globalen Variablen TimeSeparator angegebene Zeichen an.
'xx'/"xx"	In halbe oder ganze Anführungszeichen eingeschlossene Zeichen wirken sich nicht auf die Formatierung aus und werden wie eingegeben angezeigt.