Permalink
Fetching contributors…
Cannot retrieve contributors at this time
82 lines (67 sloc) 4.63 KB
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
dotnet-winforms
article
jsharp
dates, setting in DateTimePicker
DateTimePicker control [Windows Forms], setting and returning dates
examples [Windows Forms], DateTimePicker control
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