DateTimePicker クラス
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)

<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _ <ComVisibleAttribute(True)> _ Public Class DateTimePicker Inherits Control
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] [ComVisibleAttribute(true)] public class DateTimePicker : Control
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] [ComVisibleAttribute(true)] public ref class DateTimePicker : public Control

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 コントロールの新しいインスタンスを作成し、初期化するコード例を次に示します。コントロールの 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
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; }
public: void CreateMyDateTimePicker() { // Create a new DateTimePicker control and initialize it. DateTimePicker^ dateTimePicker1 = gcnew DateTimePicker; // Set the MinDate and MaxDate. dateTimePicker1->MinDate = 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; }
public void CreateMyDateTimePicker() { // Create a new DateTimePicker control and initialize it. DateTimePicker dateTimePicker1 = new DateTimePicker(); // Set the MinDate and MaxDate. dateTimePicker1.set_MinDate(new DateTime(1985, 6, 20)); dateTimePicker1.set_MaxDate(DateTime.get_Today()); // Set the CustomFormat string. dateTimePicker1.set_CustomFormat("MMMM dd, yyyy - dddd"); dateTimePicker1.set_Format(DateTimePickerFormat.Custom); // Show the CheckBox and display the control as an up-down control. dateTimePicker1.set_ShowCheckBox(true); dateTimePicker1.set_ShowUpDown(true); } //CreateMyDateTimePicker

System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.DateTimePicker


Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


- DateTimePicker クラスのページへのリンク