DateTimePicker クラス
Windows 日時指定コントロールを表します。
この型のすべてのメンバの一覧については、DateTimePicker メンバ を参照してください。
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.DateTimePicker
Public Class DateTimePicker
Inherits Control
[C#]
public class DateTimePicker : Control
[C++]
public __gc class DateTimePicker : public Control
[JScript]
public class DateTimePicker extends Control
スレッドセーフ
この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。
解説
DateTimePicker コントロールを使用すると、ユーザーが日時を選択できるようになり、指定した形式でその日時を表示できます。 MinDate プロパティと MaxDate プロパティを設定すると、選択できる日時を制限できます。
CalendarForeColor 、 CalendarFont 、 CalendarTitleBackColor 、 CalendarTitleForeColor 、 CalendarTrailingForeColor 、 CalendarMonthBackground の各プロパティを設定すると、コントロールの予定表部分の外観を変更できます。
Format プロパティは、コントロールの DateTimePickerFormat を設定します。日付の既定の Format は、 DateTimePickerFormat.Long です。 Format プロパティが DateTimePickerFormat.Custom に設定されている場合は、 CustomFormat プロパティを設定し、カスタム書式指定文字列を作成することによって、独自の書式スタイルを作成できます。カスタム書式指定文字列は、カスタム フィールド文字とその他のリテラル文字を組み合わせて作成できます。たとえば、日付を "June 01, 2001 - Friday" と表示するには、 CustomFormat プロパティを "MMMM dd, yyyy - dddd" に設定します。詳細については、「 日付と時刻の書式指定文字列 」を参照してください。
アップダウン スタイルのコントロールを使用して日付/時刻値を指定できるようにする場合は、 ShowUpDown プロパティを true に設定します。予定表コントロールを選択しても、ドロップダウン リストは表示されません。日付/時刻値を指定するには、各要素を個別に選択し、上向き矢印ボタンと下向き矢印ボタンを使用して値を変更します。
カスタムの日付書式を指定し、選択できる日を 1 日だけに制限する必要がある場合などは、 MonthCalendar ではなく DateTimePicker コントロールを使用します。 DateTimePicker を使用すると、日付/時刻値として指定され、検証対象とするデータが限定されます。
メモ DateTimePicker コントロールはグレゴリオ暦だけをサポートしています。
使用例
[Visual Basic, C#, C++] DateTimePicker コントロールの新しいインスタンスを作成し、初期化する例を次に示します。コントロールの CustomFormat プロパティが設定されます。また、コントロールに CheckBox が表示されるように ShowCheckBox プロパティが設定され、コントロールがアップダウン コントロールとして表示されるように ShowUpDown プロパティが設定されます。
Public Sub CreateMyDateTimePicker()
' Create a new DateTimePicker control and initialize it.
Dim dateTimePicker1 As New DateTimePicker()
' Set the MinDate and MaxDate.
dateTimePicker1.MinDate = New DateTime(1985, 6, 20)
dateTimePicker1.MaxDate = DateTime.Today
' Set the CustomFormat string.
dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd"
dateTimePicker1.Format = DateTimePickerFormat.Custom
' Show the CheckBox and display the control as an up-down control.
dateTimePicker1.ShowCheckBox = True
dateTimePicker1.ShowUpDown = True
End Sub 'CreateMyDateTimePicker
[C#]
public void CreateMyDateTimePicker()
{
// Create a new DateTimePicker control and initialize it.
DateTimePicker dateTimePicker1 = new DateTimePicker();
// Set the MinDate and MaxDate.
dateTimePicker1.MinDate = new DateTime(1985, 6, 20);
dateTimePicker1.MaxDate = DateTime.Today;
// Set the CustomFormat string.
dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd";
dateTimePicker1.Format = DateTimePickerFormat.Custom;
// Show the CheckBox and display the control as an up-down control.
dateTimePicker1.ShowCheckBox = true;
dateTimePicker1.ShowUpDown = true;
}
[C++]
public:
void CreateMyDateTimePicker()
{
// Create a new DateTimePicker control and initialize it.
DateTimePicker* dateTimePicker1 = new DateTimePicker();
// Set the MinDate and MaxDate.
dateTimePicker1->MinDate = DateTime(1985, 6, 20);
dateTimePicker1->MaxDate = DateTime::Today;
// Set the CustomFormat string.
dateTimePicker1->CustomFormat = S"MMMM dd, yyyy - dddd";
dateTimePicker1->Format = DateTimePickerFormat::Custom;
// Show the CheckBox and display the control as an up-down control.
dateTimePicker1->ShowCheckBox = true;
dateTimePicker1->ShowUpDown = true;
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。
必要条件
名前空間: System.Windows.Forms
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
アセンブリ: System.Windows.Forms (System.Windows.Forms.dll 内)