Export (0) Print
Expand All
Expand Minimize

DateTimePickerFormat Enumeration

Specifies the date and time format the DateTimePicker control displays.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public enum class DateTimePickerFormat

Member nameDescription
CustomThe DateTimePicker control displays the date/time value in a custom format. For more information, see CustomFormat.
LongThe DateTimePicker control displays the date/time value in the long date format set by the user's operating system.
ShortThe DateTimePicker control displays the date/time value in the short date format set by the user's operating system.
TimeThe DateTimePicker control displays the date/time value in the time format set by the user's operating system.

This enumeration is used by members such as DateTimePicker::Format.

NoteNote

The actual date/time formats are determined by the date, time, and regional settings set in the user's operating system.

The following code example demonstrates initializing a DateTimePicker object by setting the Format to a DateTimePickerFormat value. To run this example paste the following code in a form and call InitializeDateTimePicker from the form's constructor or Load event-handling method.

internal:
   // Declare the DateTimePicker.
   System::Windows::Forms::DateTimePicker^ DateTimePicker1;

private:
   void InitializeDateTimePicker()
   {
      // Construct the DateTimePicker. 
      this->DateTimePicker1 = gcnew System::Windows::Forms::DateTimePicker;

      //Set size and location. 
      this->DateTimePicker1->Location = System::Drawing::Point( 40, 88 );
      this->DateTimePicker1->Size = System::Drawing::Size( 160, 21 );

      // Set the alignment of the drop-down MonthCalendar to right. 
      this->DateTimePicker1->DropDownAlign = LeftRightAlignment::Right;

      // Set the Value property to 50 years before today.
      DateTimePicker1->Value = System::DateTime::Now.AddYears(  -50 );

      //Set a custom format containing the string "of the year"
      DateTimePicker1->Format = DateTimePickerFormat::Custom;
      DateTimePicker1->CustomFormat = "MMM dd, 'of the year' yyyy ";

      // Add the DateTimePicker to the form. 
      this->Controls->Add( this->DateTimePicker1 );
   }
	DateTimePicker object by setting the DropDownAlign, Value, Format, and 
	CustomFormat properties.  To run this example paste the following
	code in a form containing a DateTimePicker named DateTimePicker1.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft