System.SysUtils.FormatDateTime

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function FormatDateTime(const Format: string; DateTime: TDateTime): string;
function FormatDateTime(const Format: string; DateTime: TDateTime;
const AFormatSettings: TFormatSettings): string;

C++

extern DELPHI_PACKAGE System::UnicodeString __fastcall FormatDateTime(const System::UnicodeString Format, System::TDateTime DateTime)/* overload */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils

Beschreibung

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.

Die erste Form von FormatDateTime ist nicht Thread-sicher, da die landesspezifischen Informationen der globalen Variablen verwendet werden. Der Thread-sicheren zweiten Form werden die landesspezifischen Informationen im Parameter AFormatSettings übergeben. Bevor Sie diese Form von FormatDateTime aufrufen, müssen Sie die Informationen in den Parameter AFormatSettings aufnehmen. Um AFormatSettings mit einer Menge von landesspezifischen Standardinformationen aufzunehmen, rufen Sie TFormatSettings.Create auf.

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 Anzeige

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.


Siehe auch

Codebeispiele