DateTimePicker クラス

.NET Framework クラス ライブラリ リファレンス

DateTimePicker クラス

ユーザーが日時を選択し、書式を指定して日時を表示できる Windows コントロールを表します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
<ComVisibleAttribute(True)> _
Public Class DateTimePicker
    Inherits Control

Visual Basic (使用法)

Dim instance As DateTimePicker

C#

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
[ComVisibleAttribute(true)] 
public class DateTimePicker : Control

C++

[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] 
[ComVisibleAttribute(true)] 
public ref class DateTimePicker : public
 Control

J#

/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
/** @attribute ComVisibleAttribute(true) */ 
public class DateTimePicker extends Control

JScript

ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
ComVisibleAttribute(true) 
public class DateTimePicker extends
 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 コントロールはグレゴリオ暦だけをサポートしています。

使用例

DateTimePicker コントロールの新しいインスタンスを作成し、初期化するコード例を次に示します。コントロールの CustomFormat プロパティが設定されます。また、コントロールに CheckBox が表示されるように ShowCheckBox プロパティが設定され、コントロールがスピン ボタン コントロール (アップダウン コントロール) として表示されるように ShowUpDown プロパティが設定されます。

Visual Basic

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 = 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;
   }

J#

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.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.Control
        System.Windows.Forms.DateTimePicker

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
DateTimePicker メンバ
System.Windows.Forms 名前空間
Size