System.TDateTime.FormatString

• Übergeordnet: TDateTime

C++

System::String __fastcall FormatString(const System::String& format) const;

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	systdate.h	System	TDateTime

Beschreibung

Formatiert das TDateTime-Objekt in dem durch format angegebenen Format.

Die folgende Tabelle enthält die unterstützen Formatbezeichner:

Bezeichner	Anzeige
c	Zeigt das Datum in dem in der globalen Variable ShortDateFormat angegebenen Format an. Dahinter wird die Uhrzeit, in dem in der globalen Variable LongTimeFormat festgelegten Format dargestellt. Wenn der Zeitanteil des DateTime-Werts 0 ist, wird keine Uhrzeit ausgegeben.
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 Variable ShortDayNames festgelegten Strings an.
dddd	Zeigt den ausgeschriebenen Wochentag (Sonntag-Samstag) in den in der globalen Variable LongDayNames festgelegten Strings an.
ddddd	Zeigt das Datum in dem in der globalen Variable ShortDateFormat angegebenen Format an.
dddddd	Zeigt das Datum in dem in der globalen Variable LongDateFormat angegebenen Format an.
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 Variable ShortMonthNames festgelegten Strings an.
mmmm	Zeigt den ausgeschriebenen Monatsnamen (Januar-Dezember) in den in der globalen Variable 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).
zzz	Zeigt die Milisekunden an (000-999).
t	Zeigt die Uhrzeit in dem in der globalen Variable ShortDateFormat angegebenen Format an.
tt	Zeigt die Uhrzeit in dem in der globalen Variable LongDateFormat 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 Variable TimeAMString und alle Stunden nach Mittag mit dem String aus der globalen Variable TimePMString an.
/	Zeigt als Datumstrennzeichen das in der globalen Variable DateSeparator angegebene Zeichen an.
:	Zeigt als Uhrzeittrennzeichen das in der globalen Variable TimeSeparator angegebene Zeichen an.
'xx'/"xx"	Zeichen, die in einfache oder doppelte Anführungszeichen eingeschlossen sind, werden ohne spezielle Formatierung übernommen.

Wenn der Parameter format einen leeren String enthält, wird der TDateTime-Wert so formatiert, als wäre der Formatbezeichner c angegeben.

Codebeispiele

#include <tchar.h>
#include <stdio.h>
#include <System.hpp>

int _tmain(int argc, _TCHAR* argv[])
{
        //Initialize a new instance of TDateTime with the current time.
	TDateTime* myTime = new TDateTime(Now());
	String S = "The current date is: " + myTime->FormatString("dddd mmmm d, yyyy\n") +  "The current time is: " +  myTime->FormatString("hh:mm:zz AM/PM");
	printf("%ls\n", S.c_str()); 
        /* ShowMessage(S); // FireMonkey, VCL applications and Unicode characters */
	return 0;
}

Beispielausgabe

 The current date is: Wednesday October 9, 2013
 The current time is: 02:09:511 PM

Siehe auch

• System.SysUtils.FormatDateTime
• Formatbezeichner in C/C++