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

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

テーマの適用

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

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

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

Visual Basic
C#
XAML

' 書式をクリアします
GcDateTime1.FieldSet.Fields.Clear()

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

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

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

<im:GcDateTime FieldSet="yyyy年 MM月 dd日" />

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

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

Visual Basic
C#
XAML

' 書式をクリアします
GcDateTime1.DisplayFieldSet.DisplayFields.Clear()

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

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

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

<im:GcDateTime DisplayFieldSet="ggg ee年 MM月 dd日" />

入力書式のキーワード

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

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