C# DateTimePicker Control

A DateTimePicker control allows users to select a date and time in Windows Forms applications. In this tutorial, we will see how to create a DateTimePicker control at design-time as well as at run-time, set its properties and call its methods.

DateTimePicker Control 
Figure 1. 

Creating a DateTimePicker

We can create a DateTimePicker control using the Forms designer at design-time or using the DateTimePicker class in code at run-time (also known as dynamically).

Design-time

To create a DateTimePicker control at design-time, you simply drag and drop a DateTimePicker control from Toolbox to a Form in Visual Studio. After you drag and drop a DateTimePicker on a Form, the DateTimePicker looks like Figure 1. Once a DateTimePicker is on the Form, you can move it around and resize it using mouse and set its properties and events.

Now if you run the application and click on the calendar icon in the control, you will see a monthly calendar pops us for the current month as shown in Figure 2.

Design-time a DateTimePicker
Figure 2

Run-time

Creating a DateTimePicker control at run-time is merely a work of creating an instance of DateTimePicker class, set its properties and adds DateTimePicker class to the Form controls.

First step to create a dynamic DateTimePicker is to create an instance of DateTimePicker class. The following code snippet creates a DateTimePicker control object.

  1. private System.Windows.Forms.DateTimePicker dateTimePicker1;  
  2. this.dateTimePicker1 = new System.Windows.Forms.DateTimePicker();  

In the next step, you may set properties of a DateTimePicker control. The following code snippet sets location, size and Name properties of a DateTimePicker.

  1. this.dateTimePicker1.Location = new System.Drawing.Point(25, 12);  
  2. this.dateTimePicker1.Name = "dateTimePicker1";  
  3. this.dateTimePicker1.Size = new System.Drawing.Size(200, 20);  
  4. this.dateTimePicker1.TabIndex = 0;  
Once the DateTimePicker control is ready with its properties, the next step is to add the DateTimePicker to a Form. To do so, we use Form.Controls.Add method that adds DateTimePicker control to the Form controls and displays on the Form based on the location and size of the control. The following code snippet adds a DateTimePicker control to the current Form.

  1. this.Controls.Add(this.dateTimePicker1);  

Setting DateTimePicker Properties

After you place a DateTimePicker control on a Form, the next step is to set its properties.

The easiest way to set properties is from the Properties Window. You can open Properties window by pressing F4 or right click on a control and select Properties menu item. The Properties window looks like Figure 3.

Setting DateTimePicker Properties
Figure 3

Name

Name property represents a unique name of a DateTimePicker control. It is used to access the control in the code. The following code snippet sets and gets the name and text of a DateTimePicker control.

  1. DateTimePicker dynamicDTP = newDateTimePicker();  
  2. dynamicDTP.Name = "DyanmicDateTimePicker";  

Location, Height, Width and Size

The Location property takes a Point that specifies the starting position of the DateTimePicker on a Form. You may also use Left and Top properties to specify the location of a control from the left top corner of the Form. The Size property specifies the size of the control. We can also use Width and Height property instead of Size property. The following code snippet sets Location, Width, and Height properties of a DateTimePicker control.

  1. DateTimePicker dynamicDTP = newDateTimePicker();  
  2. dynamicDTP.Name = "DyanmicDateTimePicker";  
  3. dynamicDTP.Location = new System.Drawing.Point(12, 12);  
  4. dynamicDTP.Size = new System.Drawing.Size(200, 25);  
  5. dynamicDTP.Width = 200;  
  6. dynamicDTP.Height = 25;  
Font

Font property represents the font of text of a DateTimePicker control. If you click on the Font property in Properties window, you will see Font name, size and other font options. The following code snippet sets Font property at run-time.

  1. dynamicDTP.Font = newFont("Georgia", 12);  

Text and Value

Text property represents the text of a DateTimePicker control. The Value property represents the currently set date time value in a control. The following code snippet gets the Text and Value properties at run-time.

  1. MessageBox.Show(dynamicDTP.Text);  
  2. MessageBox.Show(dynamicDTP.Value.ToString());  

Formatting Calendar

MinDate and MaxDate properties are used to set the minimum and maximum value of date and time can be selected by a control. The following code snippet sets the MinDate and MaxDate properties at run-time.

  1. dynamicDTP.MinDate = newDateTime(2000, 1, 1);  
  2. dynamicDTP.MaxDate = DateTime.Today; 

DateTime Format

MinDate and MaxDate properties are used to set the minimum and maximum value of date and time can be selected by a control. The following code snippet sets the MinDate and MaxDate properties at run-time.

  1. dynamicDTP.CustomFormat = "MMMM dd, yyyy - dddd";  
  2. dynamicDTP.Format = DateTimePickerFormat.Custom;  

Calendar Foreground and Background

CalendarFont,CalendCalendarForeColor, CalendarMonthBackground, CalendarTitleBackColor, and CalendarTitleForeColor properties may be used to format calendar. The following code snippet uses these properties to format a calendar part of the DateTimePicker control.

  1. // Set Calendar foreground and font  
  2. dynamicDTP.CalendarFont = newFont("Tahoma", 10F, FontStyle.Italic,  
  3. GraphicsUnit.Point, ((Byte)(0)));  
  4. dynamicDTP.CalendarForeColor = Color.Black;  
  5. dynamicDTP.CalendarMonthBackground = Color.Orange;  
  6. dynamicDTP.CalendarTitleBackColor = Color.Yellow;  
  7. dynamicDTP.CalendarTitleForeColor = Color.Black;  

ShowCheckBox and ShowUpDown

You can make a DateTimePicker control editable where you can change the value without using the Calendar. This can be done by setting ShowCheckBox property to true. Once this property is true, the date part of the control is editable.

We can also use an up-down control (spin button control) to set the date and time. To enable the spin button control, we just need to set the ShowUpDown property to true. The following code snippet sets these properties.

  1. dynamicDTP.ShowCheckBox = true;  
  2. dynamicDTP.ShowUpDown = true;  

DateTimePicker ValueChanged Event Hander

ValueChanged event is fired when the value of a DateTimePicker control is changed. This is important say if you need to refresh some data on the Form based on the value of the DateTimePicker is changed.

To add this property event handler, you go to Events window and double click on the ValueChanged event as you can see in Figure 4. 

DateTimePicker ValueChanged Event Hander
Figure 4 

The following code snippet defines and implements these events and their respective event handlers.

  1. dynamicDTP.ValueChanged += new System.EventHandler(dateTimePicker1_ValueChanged);  
  2. privatevoid dateTimePicker1_ValueChanged(object sender, EventArgs e)  
  3. {  
  4.    MessageBox.Show("New Datetime :" + dynamicDTP.Value.ToString());  
  5. }  

Summary

In this article, we discussed discuss how to create a DateTimePicker control in Windows Forms at design-time as well as run-time. After that, we saw how to use various properties and methods.


Mindcracker
Founded in 2003, Mindcracker is the authority in custom software development and innovation. We put best practices into action. We deliver solutions based on consumer and industry analysis.