다음을 통해 공유

DateTimePicker 클래스

  • 아티클

사용자가 날짜와 시간을 선택하고, 해당 날짜와 시간을 지정된 형식으로 표시할 수 있도록 하는 Windows 컨트롤을 나타냅니다.

네임스페이스: System.Windows.Forms
어셈블리: System.Windows.Forms(system.windows.forms.dll)

구문

‘선언
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
<ComVisibleAttribute(True)> _
Public Class DateTimePicker
    Inherits Control
‘사용 방법
Dim instance As DateTimePicker

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

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

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

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 속성을 설정하고 사용자 지정 형식의 문자열을 작성하여, 사용자 고유의 형식 스타일을 만들 수 있습니다. 사용자 지정 형식의 문자열은 사용자 지정 필드 문자와 다른 리터럴 문자를 조합하여 만들 수 있습니다. 예를 들어, CustomFormat 속성을 "MMMM dd, yyyy - dddd"로 설정하면 날짜를 "June 01, 2001 - Friday"와 같이 표시할 수 있습니다. 자세한 내용은 날짜 및 시간 형식 문자열을 참조하십시오.

스핀 단추 컨트롤(up-down 컨트롤이라고도 함)을 사용하여 날짜/시간 값을 조정하려면 ShowUpDown 속성을 true로 설정합니다. 이렇게 설정하면 해당 컨트롤을 선택해도 Calendar 컨트롤은 아래로 펼쳐지지 않습니다. 날짜 및 시간을 조정하려면 각 요소를 개별적으로 선택하거나 위쪽 및 아래쪽 화살표 단추를 사용하여 값을 변경하면 됩니다.

날짜 형식을 사용자 지정하거나(예: 날짜를 하나만 선택하도록 제한함) MonthCalendar 대신 DateTimePicker 컨트롤을 사용합니다. DateTimePicker를 사용하면 날짜 및 시간 값에 대한 데이터 유효성 검사 작업을 줄일 수 있습니다.

참고

DateTimePicker 컨트롤은 그레고리오력만 지원합니다.

예제

다음 코드 예제에서는 DateTimePicker 컨트롤의 새 인스턴스를 만든 다음 초기화합니다. 컨트롤의 CustomFormat 속성이 설정됩니다. 또한 ShowCheckBox 속성을 설정하여 컨트롤에 CheckBox가 표시되며, ShowUpDown 속성을 설정하여 컨트롤이 스핀 단추 컨트롤(up-down 컨트롤이라고도 함)로 표시됩니다.

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.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