System.TDateTime.FormatString
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 指定子が、h や hh 指定子のすぐ後に続いている場合、月ではなく分が表示されます。 |
mm | 月、頭に 0 を付けた数字(01-12)で表示。 この mm 指定子が、h や hh 指定子のすぐ後に続いている場合、月ではなく分が表示されます。 |
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