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)

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


' 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

Supported in: 4.6, 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