マスクを定義するには、C1InputDate スマートタグまたは C1InputDate C1Input デザイナフォームなどの視覚的なデザイナを使用するか、プログラムで C1InputDate オブジェクトを使用します。
実行時にユーザーが日付を編集する際は、以下の点に注意します。
下の表に、C1InputDate コントロールの一般プロパティを示します。
| プロパティ | 説明 |
|---|---|
| Date | DateTime 値 |
| DateFormat | 日付書式パターンまたは日付書式文字（プリセット文字） |
| DateFormatResultPattern | カルチャによって決まる結果の日付書式パターン（取得のみ） |
| Placeholder | 空の状態で表示されるテキストを示します。 |
| WebCalendar | C1InputDate コントロールとインタラクティブ操作する C1WebCalendar コントロールを取得または設定します。 |
| DisplayFormat | コントロールがフォーカスを失ったときに表示する日付書式パターン |
C1InputDate 書式文字は、大文字と小文字を区別します。下の表に、標準書式文字を示します。
| プリセットパターン | 名前 |
|---|---|
| d | 短い日付パターン |
| D | 長い日付パターン |
| t | 短い時刻パターン |
| T | 長い時刻パターン |
| F | 完全な日付／時刻パターン（短い時刻） |
| g | 一般的な時刻パターン（短い時刻） |
| G | h一般的な日付／時刻パターン（長い時刻） |
| U | 世界時のソート可能な日付／時刻パターン |
C1InputDate パターンは、大文字と小文字を区別します。下の表に、標準パターンを示します。
| 書式パターン | 説明 |
|---|---|
| d | 月の日。１桁の日は、前にゼロが付きません。 |
| dd | 月の２桁の日。１桁の日は、前にゼロが付きます。 |
| ddd | 曜日の省略名 |
| dddd | 曜日の完全名 |
| M | 数字月。１桁の月は、前にゼロが付きません。 |
| MM | 数字月。１桁の月は、前にゼロが付きます。 |
| MMM | 月の省略名 |
| MMMM | 月の完全名 |
| y | 下２桁の年（西暦）。下２桁の年（西暦）が 10 未満の場合、年は前にゼロを付けずに表示されます。 |
| yy | 下２桁の年（西暦）。下２桁の年（西暦）が 10 未満の場合、年は前にゼロを付けて表示されます。 |
| yyyy | ４桁の年（0000〜9999） |
| h | 12 時間表示の時。１桁の時は、前にゼロが付きません。 |
| hh | 12 時間表示の時。１桁の時は、前にゼロが付きます。 |
| H | 24 時間表示の時。１桁の時は、前にゼロが付きません。 |
| HH | 24 時間表示の時。１桁の時は、前にゼロが付きます。 |
| m | 分。１桁の分は、前にゼロが付きません。 |
| mm | 分。１桁の分は、前にゼロが付きます。 |
| s | 秒。１桁の秒は、前にゼロが付きません。 |
| ss | 秒。１桁の秒は、前にゼロが付きます。 |
| t | AM/PM 指定子の最初の文字 |
| tt | AM/PM 指定子 |
| e | 年号を１桁以上の数値で表示します（1-??）。 |
| ee | 年号を２桁以上の数値で表示します（01-??）。 |
| eee（さらに任意の個数の文字「e」を付加可能） | 「ee」と同様に機能します。 |
| g | 年号をアルファベットで表示します（M、T、S、H）。 |
| gg | 年号の最初の文字（DBCS）を表示します（明、大、昭、平） |
| ggg | 完全な年号（DBCS）を表示します（明治、大正、昭和、平成）。 |
| gggg（さらに任意の個数の文字「g」を付加可能） | 書式文字列に他の「g」または「gg」または「ggg」パターンがない場合は、「ggg」と同様に機能します。 |
| キーワード | 説明 |
|---|---|
| e | 年号を１桁以上の数値で表示します（1-??）。 |
| ee | 年号を２桁以上の数値で表示します（01-??）。 |
| eee（さらに任意の個数の文字「e」を付加可能） | 「ee」と同様に機能します。 |
| E | 和暦年を２桁で表示し開始年を元と表示（先頭に0を付けない）（例：平成元年） |
| EE | 和暦年を２桁で表示し開始年を元と表示（先頭に0を付ける）（例：平成元年） |
| d | 先頭に０を付けない数字で日を表示します（1 - 31）。 |
| dd | 先頭に０を付けた数字で日を表示します（01 - 31）。 |
| ddd | 現在のスレッドに関連付けられた DateTimeFormatInfo.AbbreviatedDayNames() プロパティまたは指定された書式プロバイダによって定義された日を表示します。 |
| dddd | 現在のスレッドに関連付けられた DateTimeFormatInfo.DayNames() プロパティまたは指定された書式プロバイダによって定義された日を表示します。 |
| ddddd（さらに任意の個数の文字「d」を付加可能） | 「dddd」と同様に機能します。 |
| g | 年号をアルファベットで表示します（M、T、S、H）。 |
| gg | 年号の最初の文字（DBCS）を表示します（明、大、昭、平）。 |
| ggg | 完全な年号（DBCS）を表示します（明治、大正、昭和、平成）。 |
| gggg（さらに任意の個数の文字「g」を付加可能） | 「ggg」と同様に機能します。 |
| h | 先頭に０を付けない数字で 12 時間制の時間を表示します（0 - 11）。 |
| hh | 先頭に０を付けた数字で 12 時間制の時間を表示します（00 - 11）。 |
| hhh（さらに任意の個数の文字「h」を付加可能） | 「hh」と同様に機能します。 |
| H | 先頭に０を付けない数字で 24 時間制の時間を表示します（0 - 23）。 |
| HH | 先頭に０を付けた数字で 24 時間制の時間を表示します（00 - 23）。 |
| HHH（さらに任意の個数の文字「H」を付加可能） | 「HH」と同様に機能します。 |
| m | 先頭に０を付けないの数字で分を表示します（0 - 59）。 |
| mm | 先頭に０を付けない数字で分を表示します（00 - 59）。 |
| mmm（さらに任意の個数の文字「m」を付加可能） | 「mm」と同様に機能します。 |
| M | 先頭に０を付けない数字で月を表示します（1 - 12）。 |
| MM | 先頭に０を付けた数字で月を表示します（01 - 12）。 |
| MMM | 現在のスレッドに関連付けられた DateTimeFormatInfo.AbbreviatedMonthNames() プロパティまたは指定された書式プロバイダによって定義された月を表示します。 |
| MMMM | 現在のスレッドに関連付けられた DateTimeFormatInfo.MonthNames() プロパティまたは指定された書式プロバイダによって定義された月を表示します。 |
| MMMMM（さらに任意の個数の文字「M」を付加可能） | 「MMMM」と同様に機能します。 |
| s | 先頭に０を付けない数字で秒を表示します（0 - 59）。 |
| ss | 先頭に０を付けた数字で秒を表示します（00 - 59）。 |
| sss（さらに任意の個数の文字「s」を付加可能） | 「ss」と同様に機能します。 |
| t | A.M./P.M. 指定子の最初の文字を表示します。 |
| tt | A.M./P.M. 指定子を表示します。 |
| ttt（さらに任意の個数の文字「t」を付加可能） | 「tt」と同様に機能します。 |
| y | 先頭に０を付けない数字で年を表示します（0 - 99）。 |
| yy | 先頭に０を付けた数字で年を表示します（00 - 99）。 |
| yyy | 先頭に０を付けない数字で年を表示します（1 - 9999）。 |
| yyyy | ４桁の数字で年を表示します（0001 - 9999）。 |
| yyyyy（さらに任意の個数の文字「y」を付加可能） | 「yyyy」と同様に機能します。 |
| A | AD 表現「A.D.」を表示します。 |
| d | ShortDatePattern |
| D | LongDatePattern |
| f/F | 完全な日時（長い日付と短い時刻） |
| g | 一般（短い日付と短い時刻） |
| G | 一般（短い日付と長い時刻） |
| m/M | MonthDayPattern |
| r/R | RFC1123Pattern |
| s | SortableDateTimePattern |
| t | shortTimePattern |
| T | LongTimePattern |
| u | UniversalSortableDateTimePattern |
| U | グリニッジ標準時による完全な日時（長い日付と長い時刻） |
| y/Y | YearMonthPattern |