ヘッダの書式設定

GcCalendarCellのヘッダに表示できる書式の設定について解説します。

月-日カレンダーの書式設定

CalendarTypeプロパティがCalendarType.MonthDayのとき（月-日カレンダー）のヘッダの表示書式はHeaderFormatプロパティで設定します。HeaderFormatプロパティに以下のキーワードとリテラル文字を設定することで、書式を作成します。

キーワード	説明
g	年号の頭文字をアルファベットで表示（M、T、S、H、R）
gg	年号の頭文字を漢字で表示（明、大、昭、平、令）
ggg	年号の正式名称を漢字で表示（明治、大正、昭和、平成、令和）
e	和暦年を２桁で表示（先頭に0を付けない）
ee	和暦年を２桁で表示（先頭に0を付ける）
E	和暦年を２桁で表示し開始年を元と表示（先頭に0を付けない）（例：平成元年）
EE	和暦年を２桁で表示し開始年を元と表示（先頭に0を付ける）（例：平成元年）
y	年を２桁で表示（先頭に0を付けない）
yy	年を２桁で表示（先頭に0を付ける）
yyy	年を４桁で表示（先頭に0を付けない）
yyyy	年を４桁で表示（先頭に0を付ける）
M	月を２桁の数字で表示（先頭に0を付けない）
MM	月を２桁の数字で表示（先頭に0を付ける）
MMM	月を省略形で表示（DateTimeFormatInfo.AbbreviatedMonthNames() で指定された形式）
MMMM	月を正式名称で表示（DateTimeFormatInfo.MonthNames()で指定された形式）
\（Chr(92)）	キーワードをリテラル文字として表示

キーワード"e"、"ee"、"E"、または"EE"を使用する場合は、元号を表すキーワード"g"、"gg"、または"ggg"を必ず併用してください。
和暦表示が可能な日付の範囲は、1868年9月1日～2087年12月31日です。この範囲を超えた場合は、西暦で表示されます。

次のサンプルコードはヘッダの書式を設定する例です。

Visual Basic
C#

GcCalendarCell1.ShowHeader = True
GcCalendarCell1.HeaderHeight = 25
GcCalendarCell1.HeaderFormat = "ggg e年 M月"

gcCalendarCell1.ShowHeader = true;
gcCalendarCell1.HeaderHeight = 25;
gcCalendarCell1.HeaderFormat = "ggg e年 M月";

年-月カレンダーの書式設定

CalendarTypeプロパティがCalendarType.YearMonth（年-月カレンダー）のときの書式設定には、YearMonthFormatプロパティが参照するYearMonthFormatオブジェクトを使用します。

YearMonthFormatオブジェクトのMonthFormatおよびYearFormatプロパティにキーワードとリテラル文字を設定することで、月の書式、年の書式をそれぞれ作成します。

月の設定に関するキーワード

キーワード	説明
M	月を２桁の数字で表示（先頭に0を付けない）
MM	月を２桁の数字で表示（先頭に0を付ける）
MMM	月を省略形で表示（DateTimeFormatInfo.AbbreviatedMonthNames() で指定された形式）
MMMM	月を正式名称で表示（DateTimeFormatInfo.MonthNames()で指定された形式）

年の設定に関するキーワード

キーワード	説明
g	年号の頭文字をアルファベットで表示（M、T、S、H、R）
gg	年号の頭文字を漢字で表示（明、大、昭、平、令）
ggg	年号の正式名称を漢字で表示（明治、大正、昭和、平成、令和）
e	和暦年を２桁で表示（先頭に0を付けない）
ee	和暦年を２桁で表示（先頭に0を付ける）
E	和暦年を２桁で表示し開始年を元と表示（先頭に0を付けない）（例：平成元年）
EE	和暦年を２桁で表示し開始年を元と表示（先頭に0を付ける）（例：平成元年）
y	年を２桁で表示（先頭に0を付けない）
yy	年を２桁で表示（先頭に0を付ける）
yyy	年を４桁で表示（先頭に0を付けない）
yyyy	年を４桁で表示（先頭に0を付ける）

キーワード"e"、"ee"、"E"、または"EE"を使用する場合は、元号を表すキーワード"g"、"gg"、または"ggg"を必ず併用してください。
和暦表示が可能な日付の範囲は、1868年9月1日～2087年12月31日です。この範囲を超えた場合は、西暦で表示されます。

次のサンプルコードは、年-月カレンダーの表示書式を設定する方法を示します。

Visual Basic
C#

GcCalendarCell1.CalendarType = GrapeCity.Win.Calendar.CalendarType.YearMonth
GcCalendarCell1.YearMonthFormat.YearFormat = "ggg e年"
GcCalendarCell1.YearMonthFormat.MonthFormat = "MM月"

gcCalendarCell1.CalendarType = GrapeCity.Win.Calendar.CalendarType.YearMonth;
gcCalendarCell1.YearMonthFormat.YearFormat = "ggg e年";
gcCalendarCell1.YearMonthFormat.MonthFormat = "MM月";