Data.DB.TAggregateField.DisplayFormat
Delphi
property DisplayFormat: string read FDisplayFormat write SetDisplayFormat;
C++
__property System::UnicodeString DisplayFormat = {read=FDisplayFormat, write=SetDisplayFormat};
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| property | published | Data.DB.pas Data.DB.hpp |
Data.DB | TAggregateField |
説明
数値と時刻の値をデータベース対応コントロールに表示する際の形式を決定します。
DisplayFormat プロパティを使用すると、ResultType が ftFloat、ftCurrency、ftDate、ftTime、または ftDateTime の際に、表示目的のフィールドの自動形式をオーバーライドすることができます。
ResultType が ftFloat または ftCurrency の場合、DisplayFormat の値は、次の表に示す指定子を使用してデータ形式が変更された文字列となります：
| 指定子 | 意味 |
|---|---|
| 0 | 数字を表すプレースホルダ。 書式を適用する値の、書式文字列の中で '0' が出現する位置に数字がある場合、その数字が、出力文字列にコピーされます。 それ以外の場合は、出力文字列のその位置には '0' が格納されます。 |
| # | 数字を表すプレースホルダ。 書式を適用する値の、書式文字列の中で '#' が出現する位置に数字がある場合、その数字が、出力文字列にコピーされます。 それ以外の場合は、出力文字列のその位置に何も格納されません。 |
| .（ピリオド） | 小数点。 書式文字列内の最初の "." 文字によって、書式指定対象の値の小数点位置が決定します。それ以降の "." 文字は無視されます。 出力文字列での小数点の区切りとして使われる実際の文字は、DecimalSeparator グローバル変数によって決まります。 DecimalSeparator のデフォルト値は、Windows の [コントロール パネル] の [地域] 設定セクションの [数値] タブで指定されています。 |
| ,（カンマ） | 桁区切り記号。 書式文字列に 1 つ以上 "," 文字が含まれている場合、出力には小数点の左側の 3 桁ごとの各グループの間に桁区切り記号が挿入されます。 書式文字列内の "," 文字の位置と数は、桁区切り記号の使用を指定するということ以外は、出力に影響しません。 出力で桁区切り記号として使われる実際の文字は、ThousandSeparator グローバル変数によって決まります。 ThousandSeparator のデフォルト値は、Windows の [コントロール パネル] の [地域] 設定セクションの [数値] タブで指定されています。 |
| E+ | 科学表記。 書式文字列内に、"E+"、"E-"、"e+"、"e-" のいずれかの文字列が含まれている場合、その数値は科学表記を使ってフォーマットされます。 最大 4 個の "0" 文字のグループを "E+"、"E-"、"e+"、または "e-" の直後に続けることで、指数内の最小桁数を決定できます。 "E+" と "e+" の形式では、正の指数にはプラス記号が出力され、負の指数にはマイナス記号が出力されます。 "E-" と "e-" を使用すると、負の指数の場合にのみマイナス記号が出力されます。 |
| 'xx' または "xx" | 一重引用符または二重引用符で囲まれた文字は、そのまま出力され、形式指定の影響を受けません。 |
| ;（セミコロン） | 書式文字列内で、正の数、負の数、0 のためのセクションを区切ります。 |
| 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）。 |
| 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 グローバル変数で指定される、時刻区切り文字。 |
書式文字列内の小数点より前にある左端の "0" と、書式文字列内の小数点より後の右端の "0" の位置によって、出力文字列に常に表示される桁数の範囲が決まります。
形式を適用する数値は常に、小数点より右側にある、数字を表すプレースホルダ（"0" または "#"）の数分の、少数位に丸められます。 書式文字列に小数点が含まれていない場合、書式指定対象の値は、それに最も近い整数に丸められます。
書式を適用する数値の小数点記号より左側の桁数が、書式文字列内の "." 文字の左側にある数字を表すプレースホルダの数より多い場合、最初の数字を表すプレースホルダの前に桁を追加して出力されます。
正の数、負の数、0 に対して異なる書式を指定するには、書式文字列を、セミコロンで区切られた 1 ～ 3 個のセクションで構成します。
セクションが 1 つの場合： 書式文字列はすべての値に適用されます。
セクションが 2 つの場合： 第 1 セクションを正の数とゼロに適用し、第 2 セクションを負の数に適用します。
セクションが 3 つの場合： 第 1 セクションは正の数に、第 2 セクションは負の数に、第 3 セクションは 0 に適用されます。
負の数用のセクション、または 0 用のセクションが空の場合（そのセクションを区切るセミコロンの間に何もない場合）、代わりに正の数用のセクションが適用されます。
正の数用のセクションが空の場合、または書式文字列全体が空の場合は、有効桁数が 15 桁の一般的な浮動小数点形式が使用されます。 一般的な浮動小数点形式は、小数点より左の桁数が 18 桁を超えていて、書式文字列に科学表記が指定されていない場合にも使用されます。
ResultType が ftDate、ftTime または ftDateTime の場合、DisplayFormat の値は、次の表に示す指定子を使用してデータ形式が変換された文字列となります：
| 指定子 | 表示内容 |
|---|---|
| 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）。 |
| 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" | 一重引用符または二重引用符で囲まれた文字は、そのまま表示され、形式は変更されません。 |