| title | ms.custom | ms.date | ms.prod | ms.reviewer | ms.suite | ms.technology | ms.tgt_pltfrm | ms.topic | dev_langs | helpviewer_keywords | ms.assetid | caps.latest.revision | author | ms.author | manager | |||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
How to: Set and Return Dates with the Windows Forms DateTimePicker Control |
03/30/2017 |
.net-framework |
|
article |
|
|
a8a48d68-e4b5-426e-9764-51230fc9acd2 |
17 |
dotnet-bot |
dotnetcontent |
wpickett |
How to: Set and Return Dates with the Windows Forms DateTimePicker Control
The currently selected date or time in the Windows Forms xref:System.Windows.Forms.DateTimePicker control is determined by the xref:System.Windows.Forms.DateTimePicker.Value%2A property. You can set the xref:System.Windows.Forms.DateTimePicker.Value%2A property before the control is displayed (for example, at design time or in the form's xref:System.Windows.Forms.Form.Load event) to determine which date will be initially selected in the control. By default, the control's xref:System.Windows.Forms.DateTimePicker.Value%2A is set to the current date. If you change the control's xref:System.Windows.Forms.DateTimePicker.Value%2A in code, the control is automatically updated on the form to reflect the new setting.
The xref:System.Windows.Forms.DateTimePicker.Value%2A property returns a xref:System.DateTime structure as its value. There are several properties of the xref:System.DateTime structure that return specific information about the displayed date. These properties can only be used to return a value; do not use them to set a value.
-
For date values, the xref:System.DateTime.Month%2A, xref:System.DateTime.Day%2A, and xref:System.DateTime.Year%2A properties return integer values for those time units of the selected date. The xref:System.DateTime.DayOfWeek%2A property returns a value indicating the selected day of the week (possible values are listed in the xref:System.DayOfWeek enumeration).
-
For time values, the xref:System.DateTime.Hour%2A, xref:System.DateTime.Minute%2A, xref:System.DateTime.Second%2A, and xref:System.DateTime.Millisecond%2A properties return integer values for those time units. To configure the control to display times, see How to: Display Time with the DateTimePicker Control.
To set the date and time value of the control
-
Set the xref:System.Windows.Forms.DateTimePicker.Value%2A property to a date or time value.
DateTimePicker1.Value = New DateTime(2001, 10, 20)
dateTimePicker1.Value = new DateTime(2001, 10, 20);
dateTimePicker1->Value = DateTime(2001, 10, 20);
To return the date and time value
-
Call the xref:System.Windows.Forms.DateTimePicker.Text%2A property to return the entire value as formatted in the control, or call the appropriate method of the xref:System.Windows.Forms.DateTimePicker.Value%2A property to return a part of the value. Use xref:System.Windows.Forms.DateTimePicker.ToString%2A to convert the information into a string that can be displayed to the user.
MessageBox.Show("The selected value is ", DateTimePicker1.Text) MessageBox.Show("The day of the week is ", DateTimePicker1.Value.DayOfWeek.ToString) MessageBox.Show("Millisecond is: ", DateTimePicker1.Value.Millisecond.ToString)
MessageBox.Show ("The selected value is " + dateTimePicker1.Text); MessageBox.Show ("The day of the week is " + dateTimePicker1.Value.DayOfWeek.ToString()); MessageBox.Show("Millisecond is: " + dateTimePicker1.Value.Millisecond.ToString());
MessageBox::Show (String::Concat("The selected value is ", dateTimePicker1->Text)); MessageBox::Show (String::Concat("The day of the week is ", dateTimePicker1->Value.DayOfWeek.ToString())); MessageBox::Show(String::Concat("Millisecond is: ", dateTimePicker1->Value.Millisecond.ToString()));
See Also
DateTimePicker Control
How to: Display a Date in a Custom Format with the Windows Forms DateTimePicker Control