リサイズはクリックかドラッグ

キーワードによる書式設定

このセクションでは、キーワードによる書式設定について説明します。

概要

日付コントロールでは、入力書式および表示書式をキーワード文字列にて設定することができます。キーワード文字列は、１つあるいは複数のキーワードの組み合わせで構成された文字列です。キーワードを使用して書式設定を行うと、コントロールはその内容に基づいてフィールドを自動的に作成します。

入力書式を設定するには、XAML 上では FieldSet プロパティ、コード上では DateFieldSetFields プロパティが参照する DateFieldCollection の AddRange メソッドのオーバーロードの１つを使用してキーワード文字列を指定します。入力書式に使用できるキーワードについては「入力書式のキーワード」を参照してください。

以下のサンプルコードは、キーワードを使用して入力書式を設定します。

コピー
// 書式をクリアします
GcDateTime1.FieldSet.Fields.Clear();

// キーワードにて入力書式を設定します。 
GcDateTime1.FieldSet.Fields.AddRange("yyyy年 MM月 dd日");

また、表示書式を設定するには、XAML 上では DisplayFieldSet プロパティ、コード上では DateDisplayFieldSetDisplayFields プロパティが参照する DateDisplayFieldCollection の AddRange メソッドのオーバーロードの１つを使用してキーワード文字列を指定します。入力書式に使用できるキーワードについては「表示書式のキーワード」を参照してください。

以下のサンプルコードは、キーワードを使用して表示書式を設定します。

コピー
// 書式をクリアします
GcDateTime1.DisplayFieldSet.DisplayFields.Clear();

// キーワードにて表示書式を設定します。 
GcDateTime1.DisplayFieldSet.DisplayFields.AddRange("ggg ee年 MM月 dd日");
入力書式のキーワード

入力書式として使用可能なキーワードは以下のとおりです。

キーワード説明
g年号の頭文字をアルファベットで表示（M、T、S、H、R）
gg年号の頭文字を漢字で表示（明、大、昭、平、令）
ggg年号の正式名称を漢字で表示（明治、大正、昭和、平成、令和）
e和暦年を２桁で表示（先頭に０を付けない）
ee和暦年を２桁で表示（先頭に０を付ける）
yy年を２桁で表示（先頭に０を付ける）
yyyy年を４桁で表示（先頭に０を付ける）
MM月を２桁の数字で表示（先頭に０を付ける）
MMM月を省略形で表示（DateTimeFormatInfoAbbreviatedMonthNames で指定された形式）
MMMM月を正式名称で表示（DateTimeFormatInfoMonthNames で指定された形式）
dd日を２桁で表示（先頭に０を付ける）
t12 時間制で時刻を表示するときに午前（AMDesignator プロパティで設定）または午後（PMDesignator プロパティで設定）を表す文字列の最初の１文字を表示
tt12 時間制で時刻を表示するときに午前（AMDesignator プロパティで設定）または午後（PMDesignator プロパティで設定）を表す文字列を表示
hh時を 12 時間制で表示（先頭に０を付ける）
HH時を 24 時間制で表示（先頭に０を付ける）
mm分を表示（先頭に０を付ける）
ss秒を表示（先頭に０を付ける）
\（Chr(92)）キーワードをリテラル文字として表示
表示書式のキーワード

表示書式として使用可能なキーワードは以下のとおりです。

キーワード説明
A紀元後を表す"A.D.（Anno Domini）"を表示
g年号の頭文字をアルファベットで表示（M、T、S、H、R）
gg年号の頭文字を漢字で表示（明、大、昭、平、令）
ggg年号の正式名称を漢字で表示（明治、大正、昭和、平成、令和）
e和暦年を２桁で表示（先頭に０を付けない）
ee和暦年を２桁で表示し開始年を元と表示（先頭に０を付ける）（例：平成元年）
E和暦年を２桁で表示し開始年を元と表示（先頭に０を付けない）（例：平成元年）
EE和暦年を２桁で表示（先頭に０を付ける）
y年を２桁で表示（先頭に０を付けない）
yy年を２桁で表示（先頭に０を付ける）
yyy年を４桁で表示（先頭に０を付けない）
yyyy年を４桁で表示（先頭に０を付ける）
M月を２桁の数字で表示（先頭に０を付けない）
MM月を２桁の数字で表示（先頭に０を付ける）
MMM月を省略形で表示（AbbreviatedMonthNames プロパティで指定された形式）
MMMM月を正式名称で表示（MonthNames プロパティで指定された形式）
d日を表示（先頭に０を付けない）
dd日を表示（先頭に０を付ける）
ddd曜日を省略形で表示（AbbreviatedDayNames プロパティで指定された形式）
dddd曜日を正式名称で表示（DayNames プロパティで指定された形式）
t12 時間制で時刻を表示するときに午前（AMDesignator プロパティで設定）または午後（PMDesignator プロパティで設定）を表す文字列の最初の１文字を表示
tt12 時間制で時刻を表示するときに午前（AMDesignator プロパティで設定）または午後（PMDesignator プロパティで設定）を表す文字列を表示
h時を 12 時間制で表示（先頭に０を付けない）
hh時を 12 時間制で表示（先頭に０を付ける）
H時を 24 時間制で表示（先頭に０を付けない）
HH時を 24 時間制で表示（先頭に０を付ける）
m分を表示（先頭に０を付けない）
mm分を表示（先頭に０を付ける）
s秒を表示（先頭に０を付けない）
ss秒を表示（先頭に０を付ける）
\（Chr(92)）キーワードをリテラル文字として表示
参照