DateTimePickerFormat Enumeration

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Specifies the date and time format the DateTimePicker control displays.

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

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


' Declare the DateTimePicker.
Friend WithEvents DateTimePicker1 As System.Windows.Forms.DateTimePicker


Private Sub InitializeDateTimePicker()

    ' Construct the DateTimePicker.
    Me.DateTimePicker1 = New System.Windows.Forms.DateTimePicker

    'Set size and location.
    Me.DateTimePicker1.Location = New System.Drawing.Point(40, 88)
    Me.DateTimePicker1.Size = New Size(160, 21)

    ' Set the alignment of the drop-down MonthCalendar to right.
    Me.DateTimePicker1.DropDownAlign = LeftRightAlignment.Right

    ' Set the Value property to 50 years before today.
    DateTimePicker1.Value = (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.
    Me.Controls.Add(Me.DateTimePicker1)
End Sub

.NET Framework
Available since 1.1
Return to top
Show: