System.TDateTime.FormatString

提供: RAD Studio API Documentation
移動先: 案内検索

C++

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

プロパティ

種類 可視性 ソース ユニット
function public systdate.h System TDateTime


説明

format で指定された書式を使用して、TDateTime オブジェクトを整形します。

次の書式指定子がサポートされています。

指定子 表示内容
c ShortDateFormat グローバル変数で指定された形式で日付、それに続いて LongTimeFormat グローバル変数で指定された時刻が表示されます。 時刻は、DateTime 値の小数部分が 0 の場合は表示されません。
d 日付、頭に 0 を付けない数字(1-31)で表示。
dd 日付、頭に 0 を付けた数字(01-31)で表示。
ddd ShortDayNames グローバル変数で指定された文字列を使った、省略形で表される曜日(Sun-Sat)。
dddd LongDayNames グローバル変数で指定された文字列を使った、完全名で表される曜日(Sunday-Saturday)。
ddddd ShortDateFormat グローバル変数で指定された形式を使用する日付。
dddddd LongDateFormat グローバル変数で指定された形式を使用する日付。
m 月、頭に 0 を付けない数字(1-12)で表示。 この m 指定子が、hhh 指定子のすぐ後に続いている場合、月ではなく分が表示されます。
mm 月、頭に 0 を付けた数字(01-12)で表示。 この mm 指定子が、hhh 指定子のすぐ後に続いている場合、月ではなく分が表示されます。
mmm ShortMonthNames グローバル変数で指定された文字列を使った、省略形で表される月名(Jan-Dec)。
mmmm LongMonthNames グローバル変数で指定された文字列を使った、完全名で表される月名(January-December)。
yy 年、2 桁で表示(00-99)。
yyyy 年、4 桁で表示(0000-9999)。
h 時間、頭に 0 を付けないで表示(0-23)。
hh 時間、頭に 0 を付けて表示(00-23)。
n 分、頭に 0 を付けないで表示(0-59)。
nn 分、頭に 0 を付けて表示(00-59)。
s 秒、頭に 0 を付けないで表示(0-59)。
ss 秒、頭に 0 を付けて表示(00-59)。
zzz ミリ秒を表示(000-999)。
t ShortTimeFormat グローバル変数で指定された形式を使用する時間。
tt LongTimeFormat グローバル変数で指定された形式を使用する時間。
am/pm 前にくる h または hh 指定子に 12 時間時計を使用する時間。午前の場合には「am」、午後の場合には「pm」が続きます。 am/pm 指定子には、小文字、大文字、またはその混合を使用でき、それに従って結果が表示されます。
a/p 前にくる h または hh 指定子に 12 時間時計を使用する時間。午前の場合には「a」、午後の場合には「p」が続きます。 a/p 指定子には、小文字、大文字、またはその混合を使用でき、それに従って結果が表示されます。
ampm 前にくる h または hh 指定子に 12 時間時計を使用する時間。午前の場合には TimeAMString グローバル変数の内容、午後の場合には TimePMString グローバル変数の内容が続きます。
/ DateSeparator グローバル変数で指定される、日付区切り文字。
: TimeSeparator グローバル変数で指定される、時刻区切り文字。
'xx' または "xx" 一重引用符または二重引用符で囲まれた文字は、そのまま表示され、形式指定の影響を受けません。

format パラメータで与えられる文字列が空の場合、TDateTime の値は、書式指定子 c が与えられたものとして整形されます。

コード サンプル

#include <tchar.h>
#include <stdio.h>
#include <System.hpp>
int _tmain(int argc, _TCHAR* argv[])
{
        // TDateTime の新しいインスタンスを現在時刻で初期化
	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 アプリケーションおよび Unicode 文字 */
	return 0;
}

サンプル出力

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

関連項目