日付時刻の書式は、入力および表示用の各フィールドコレクションに、前項で解説したフィールドオブジェクトを組み合わせて作成します。

入力書式を設定するには、AddまたはAddRangeメソッドを使用して、DateTimeFieldCollectionInfoに入力用フィールドオブジェクトを追加します。表示書式は、Add　またはAddRangeメソッドを使用して、表示用フィールドオブジェクトをDateTimeDisplayFieldCollectionInfoに追加します。

サンプルコード

次のサンプルコードは、以下の図のようにGcDateTime型セルに書式を設定する例です。

using InputManCell = GrapeCity.Win.Spread.InputMan.CellType;
GrapeCity.Win.Spread.InputMan.CellType.GcDateTimeCellType gdcell = new GrapeCity.Win.Spread.InputMan.CellType.GcDateTimeCellType();
// フィールドをクリアします。
gdcell.Fields.Clear();
gdcell.DisplayFields.Clear();
// 入力フィールドのオブジェクトを作成します。
InputManCell.Fields.DateYearFieldInfo dateYearField1 = new InputManCell.Fields.DateYearFieldInfo(InputManCell.YearDigitType.FourDigitYear);
InputManCell.Fields.DateLiteralFieldInfo dateLiteralField1 = new InputManCell.Fields.DateLiteralFieldInfo("/");
InputManCell.Fields.DateMonthFieldInfo dateMonthField1 = new InputManCell.Fields.DateMonthFieldInfo(InputManCell.MonthPattern.Number);
InputManCell.Fields.DateLiteralFieldInfo dateLiteralField2 = new InputManCell.Fields.DateLiteralFieldInfo("/");
InputManCell.Fields.DateDayFieldInfo dateDayField1 = new InputManCell.Fields.DateDayFieldInfo();   
// フィールドをコレクションに追加してコントロールに入力書式を設定します。
gdcell.Fields.AddRange(new InputManCell.Fields.DateFieldInfo[] {
dateYearField1, dateLiteralField1, dateMonthField1,
dateLiteralField2, dateDayField1
});
// 表示フィールドのオブジェクトを作成します。
InputManCell.Fields.DateYearDisplayFieldInfo dateYearDisplayDield1 = new InputManCell.Fields.DateYearDisplayFieldInfo(false);
InputManCell.Fields.DateLiteralDisplayFieldInfo dateLiteralDisplayField1 = new InputManCell.Fields.DateLiteralDisplayFieldInfo("年");
InputManCell.Fields.DateMonthDisplayFieldInfo dateMonthDisplayField1 = new InputManCell.Fields.DateMonthDisplayFieldInfo(false);
 InputManCell.Fields.DateLiteralDisplayFieldInfo dateLiteralDisplayField2 = new InputManCell.Fields.DateLiteralDisplayFieldInfo("月");
 InputManCell.Fields.DateDayDisplayFieldInfo dateDayDisplayField1 = new InputManCell.Fields.DateDayDisplayFieldInfo(false);
 InputManCell.Fields.DateLiteralDisplayFieldInfo dateLiteralDisplayField3 = new InputManCell.Fields.DateLiteralDisplayFieldInfo("日");
// フィールドをコレクションに追加してコントロールに表示書式を設定します。
gdcell.DisplayFields.AddRange(new InputManCell.Fields.DateDisplayFieldInfo[] {
       dateYearDisplayDield1, dateLiteralDisplayField1, dateMonthDisplayField1,
       dateLiteralDisplayField2, dateDayDisplayField1 , dateLiteralDisplayField3
       });
fpSpread1.ActiveSheet.Cells[0, 0].CellType = gdcell;

Imports InputManCell = GrapeCity.Win.Spread.InputMan.CellType
Dim gdcell = New GrapeCity.Win.Spread.InputMan.CellType.GcDateTimeCellType()
' フィールドをクリアします。
gdcell.Fields.Clear()
gdcell.DisplayFields.Clear()
' 入力フィールドのオブジェクトを作成します。
Dim dateYearField1 As New InputManCell.Fields.DateYearFieldInfo(InputManCell.YearDigitType.FourDigitYear)
Dim dateLiteralField1 As New InputManCell.Fields.DateLiteralFieldInfo("/")
Dim dateMonthField1 As New InputManCell.Fields.DateMonthFieldInfo(InputManCell.MonthPattern.Number)
Dim dateLiteralField2 As New InputManCell.Fields.DateLiteralFieldInfo("/")
Dim dateDayField1 As New InputManCell.Fields.DateDayFieldInfo()
' フィールドをコレクションに追加してコントロールに入力書式を設定します。
gdcell.Fields.AddRange(New InputManCell.Fields.DateFieldInfo() { _
dateYearField1, dateLiteralField1, dateMonthField1, _
dateLiteralField2, dateDayField1})
' 表示フィールドのオブジェクトを作成します。
Dim dateYearDisplayDield1 As New InputManCell.Fields.DateYearDisplayFieldInfo(False)
Dim dateLiteralDisplayField1 As New InputManCell.Fields.DateLiteralDisplayFieldInfo("年")
Dim dateMonthDisplayField1 As New InputManCell.Fields.DateMonthDisplayFieldInfo(False)
Dim dateLiteralDisplayField2 As New InputManCell.Fields.DateLiteralDisplayFieldInfo("月")
Dim dateDayDisplayField1 As New InputManCell.Fields.DateDayDisplayFieldInfo(False)
Dim dateLiteralDisplayField3 As New InputManCell.Fields.DateLiteralDisplayFieldInfo("日")
' フィールドをコレクションに追加してコントロールに入力書式を設定します。
gdcell.DisplayFields.AddRange(New InputManCell.Fields.DateDisplayFieldInfo() { _
dateYearDisplayDield1, dateLiteralDisplayField1, dateMonthDisplayField1, _
dateLiteralDisplayField2, dateDayDisplayField1, dateLiteralDisplayField3})
FpSpread1.ActiveSheet.Cells(0, 0).CellType = gdcell

フィールドオブジェクトをDateTimeFieldCollectionInfoまたはDateTimeDisplayFieldCollectionInfoから削除するには、Remove、またはRemoveAtメソッドを使用します。

次のサンプルコードは、DateTimeDisplayFieldCollectionInfoの先頭のフィールドを削除する例です。

// コレクションの先頭のオブジェクトを削除
GrapeCity.Win.Spread.InputMan.CellType.GcDateTimeCellType cell = (fpSpread1.ActiveSheet.GetCellType(0, 0) as GrapeCity.Win.Spread.InputMan.CellType.GcDateTimeCellType);
cell.DisplayFields.RemoveAt(0);

' コレクションの先頭のオブジェクトを削除
Dim cell As GrapeCity.Win.Spread.InputMan.CellType.GcDateTimeCellType = TryCast(FpSpread1.ActiveSheet.GetCellType(0, 0), GrapeCity.Win.Spread.InputMan.CellType.GcDateTimeCellType)
cell.DisplayFields.RemoveAt(0)

ここでは、GcDateTime型セルの入力フィールドに設定可能な11種類のフィールドについて、すべてのフィールドに共通な設定項目と各フィールドに特化した設定項目にわけて解説します。

すべてのフィールドクラスに共通な設定

これらのプロパティは、GcDateTime型セルのすべての入力フィールドオブジェクトに共通な設定項目です。

リテラル文字フィールド (DateLiteralFieldInfo)

リテラル文字フィールド（DateLiteralFieldInfoクラス）は、コントロールに表示するリテラル文字を設定します。

年号入力フィールド (DateEraFieldInfo)

年号入力フィールド (DateEraFieldInfoクラス）は和暦表示時の年号を入力するフィールドです。

和暦入力フィールド (DateEraYearFieldInfo)

和暦入力フィールド (DateEraYearFieldInfo クラス）は、和暦年を入力するフィールドです。

年入力フィールド (DateYearFieldInfo)

年入力フィールド (DateYearFieldInfoクラス）は、西暦の年を入力するフィールドです。

月入力フィールド (DateMonthFieldInfo)

月入力フィールド (DateMonthFieldInfoクラス）は、月を入力するフィールドです。

日入力フィールド (DateDayFieldInfo)

日入力フィールド (DateDayFieldInfoクラス）は、日を入力するフィールドです。

午前／午後入力フィールド (DateAmPmFieldInfo)

午前／午後入力フィールド（DateAmPmFieldInfoクラス）は、時刻の午前／午後を入力するフィールドです。

12時間制時刻入力フィールド (DateShortHourFieldInfo)

12時間制時刻入力フィールド (DateShortHourFieldInfoクラス）は、12時間制の時刻を入力するフィールドです。

時入力フィールド (DateHourFieldInfo)

時入力フィールド (DateHourFieldInfoクラス）は、時刻の時を入力するフィールドです。

分入力フィールド (DateMinuteFieldInfo)

分入力フィールド (DateMinuteFieldInfoクラス）は、時刻の分を入力するフィールドです。

秒入力フィールド (DateSecondFieldInfo)

秒入力フィールド (DateSecondFieldInfoクラス）は、時刻の秒を入力するフィールドです。

ここでは、GcDateTime型セルの表示フィールドに設定可能な14種類のフィールドについて、すべてのフィールドに共通な設定項目と各フィールドに特化した設定項目にわけて解説します。

すべてのフィールドクラスに共通な設定

これらのプロパティは、日付時刻コントロールのすべての表示フィールドオブジェクトに共通な設定項目です。

リテラル文字表示フィールド (DateLiteralDisplayFieldInfo)

リテラル文字表示フィールド (DateLiteralDisplayFieldInfoクラス）は、コントロールに表示するリテラル文字を設定します。

年号表示フィールド (DateEraDisplayFieldInfo)

年号表示フィールド (DateEraDisplayFieldInfoクラス）は、和暦表示時の年号を表示するフィールドです。

和暦表示フィールド (DateEraYearDisplayFieldInfo)

和暦表示フィールド (DateEraYearDisplayFieldInfoクラス）は、和暦年を表示するフィールドです。

西暦表示フィールド (DateADDisplayFieldInfo)

西暦表示フィールド (DateADDisplayFieldInfo クラス）は、紀元後を表すA.D.を表示するフィールドです。

年表示フィールド (DateYearDisplayFieldInfo)

年表示フィールド (DateYearDisplayFieldInfo クラス）は、西暦の年を表示するフィールドです。

月表示フィールド (DateMonthDisplayFieldInfo)

月表示フィールド (DateMonthDisplayFieldInfo クラス）は、月を表示するフィールドです。

日表示フィールド (DateDayDisplayFieldInfo)

日表示フィールド (DateDayDisplayFieldInfo クラス）は、日を表示するフィールドです。

曜日表示フィールド (DateWeekdayDisplayFieldInfo)

曜日表示フィールド (DateWeekdayDisplayFieldInfo クラス）は、曜日を表示するフィールドです。

午前／午後表示フィールド (DateAmPmDisplayFieldInfo)

午前／午後表示フィールド (DateAmPmDisplayFieldInfo クラス）は、時刻の午前／午後を表示するフィールドです。

12時間制時刻表示フィールド (DateShortHourDisplayFieldInfo)

12時間制時刻表示フィールド (DateShortHourDisplayFieldInfo クラス）は、 12時間制の時刻を表示するフィールドです。

時表示フィールド (DateHourDisplayFieldInfo)

時表示フィールド (DateHourDisplayFieldInfo クラス）は、時刻の時を表示するフィールドです。

分表示フィールド (DateMinuteDisplayFieldInfo)

分表示フィールド (DateMinuteDisplayFieldInfo クラス）は、時刻の分を表示するフィールドです。

秒表示フィールド (DateSecondDisplayFieldInfo)

秒表示フィールド (DateSecondDisplayFieldInfo クラス）は、時刻の秒を表示するフィールドです。

システム書式表示フィールド (DateSystemFormatDisplayFieldInfo)

システム書式表示フィールド (DateSystemFormatDisplayFieldInfo クラス）は、 システムで定義された書式指定子を使用して日付または時刻の書式を設定します。

◆ Pattern プロパティに設定可能な書式指定子