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
Custom

The DateTimePicker control displays the date/time value in a custom format. For more information, see CustomFormat.

Long

The DateTimePicker control displays the date/time value in the long date format set by the user's operating system.

Short

The DateTimePicker control displays the date/time value in the short date format set by the user's operating system.

Time

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

System_CAPS_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 );
   }

.NET Framework
Available since 1.1
Return to top
Show: