C#：DataTimePicker控件(可调节类控件)

    DataTimePicker控件(日期控件)是一个用来显示时间和日期的控件，并且可以作为一个用户用以修改日期和事件信息的界面，控件显示包含由控件格式字符串定义的字段。DataTimePicker控件只能选择一个时间，而不是连续的时间段，也可以直接输入日期和时间。DataTimePicker控件显示为两部分：一部分为下拉列表(以文本形式表示的日期)，另一部分为网格(在单击列表旁边的向下箭头时显示)。在程序设计中经常使用，由于该控件支持用户自定义时间和日期格式，所以用起来非常方便。

 

一、日期控件的部分属性及其说明

DataTimePicker控件的常用属性及说明

属性	说明
CalendarFont	获取或设置日历的字体样式
CalendarFo reColor	用于设置日历的前景色，也就是用户看到的字体颜色
CalendarTitleForeColor	确定日历标题区的前景色，也就是年月、日期信息的字体颜色
CalendarTitleBackColor	确定控件日历标题区的背景色，也就是年月、星期、日信息的背景色
CalendarMonthBackground	确定日历的背景颜色，这个颜色是控件的背景色，与字体颜色无关
CalendarTrailingForeColor	确定日历中结尾日期的前景色，结尾日期指的的日历中用于填充日历网格的上个月的结束日期或者下个月的起始日   期。这些提示一般是灰色的
CustomFormat	用于设置自定义日期/时间的格式字符串，这个格式字符串由开发环境定义的枚举类型确定
Format	获取或设置控件中显示的日期和时间格式
ForeColor	获取或设置DataTimePicker控件的前景色
BackColor	该值指示DataTimePicker控件的背景色
BackgroundImage	获取或设置控件的背景图像
BackgroundImage	获取或设置DataTimePicker控件背景图像的布局
Location	用于设置控件的位置，这个位置上指控件左上角顶点的位置，用像素表示
Checked	获取或设置一个值，该值指示是否已用有效日期/时间值设置了Value属性且显示的值可以更新
Region	用于设置与控件关联的窗口区域(窗口区域是操作系统允许在其中进行绘制的窗口内的像素的集合，控件的区域的坐   标相对于控件的左上角，且该区域包含的像素的集合可以说不连续的)，这个窗口区域包括客户区和非客户区，一般   用来制作非常规窗体。
ShowUpDown	属性用于设置是否显示调节数字的微调按钮，单击此按钮可以调整相应文本框中的内容。这个属性的取值聚顶了控     件的内容。如果显示的是非时间，则将属性设置为true，反之，如果要显示时间，则需要将属性设置为false并       将format设置为time
ShowCheckBox	用来确定是否在控件左侧显示复选框，取值为true显示，否则不显示
Size	以像素为单位描述控件的大小。Size是值类型，它按传值方式返回，若要调整控件的Width或Height，必须设置控件   的Width或Height，或重新设置Size。控件Size还受在控件中显示字体的大小和属性的影响，选定某字体后，则控件   保存一定的高度和宽度，任何小于该值的Size设置都无效
Value	表示当前控件的取值，这个值代表的是当前显示的时间。如果在代码中更改了DataTimePicker的Value属性，控件会   自动更新并反映出新的设置
UpDown	决定了控件属于何种模式。当设置为true时，DataTimePicker控件属于时间格式模式；当设置为false   时，DataTimePicker控件属于下拉日历模式。
RightToLeftLayout	获取或设置DataTimePicker的内容布局是否为从右向左
MaxDate	获取或设置可在控件中选择的最大日期和时间
MaximumDateTime	获取DataTimePicker控件允许的最大日期值
MinDate	获取或设置可在控件中选择的最小日期和时间
MinimumDateTime	获取DataTimePicker控件允许的最小日期

 

[补充]：属性说明

►CustomFormat的枚举类型值如下表所示：

模式	说明
yyyy	完整的年份(4位数表示)
yy	年份的最后两位数(2位数表示)
y	一位数的年份
MMMM	完整的中文月份名
MMM	三个字符的月份缩写
MM	两位数月份值，小于10时，有前导零
M	一位数或两位数月份值，小于10时，没有前导零
dddd	完整的中文星期几名称
ddd	三个字符的星期几缩写
dd	两位数的天数，小于10时，有前导零
d	一位数或两位数的天数，小于10时，没有前导零
tt	两字母A.M./P.M.缩写(A.M.将显示为“AM”)
t	两字母A.M./P.M.缩写(A.M.将显示为“A”)
HH	24小时格式的两位数小时数，小于10时，有前导零
H	24小时格式的一位数或两位数小时数，小于10时，没有前导零
hh	12小时格式的两位数小时数，小于10时，有前导零
h	12小时格式的一位数或两位数小时数，小于10时，没有前导零
mm	两位数分钟值，小于10时，有前导零
m	一位数或两位数分钟值，小于10时，没有前导零
ss	两位数秒数，小于10时，有前导零
s	一位数或两位数秒数，小于10时，没有前导零

 

了解更多属性见：

http://msdn.microsoft.com/zh-cn/library/System.Windows.Forms.DateTimePicker_properties(v=vs.80).aspx

二、DataTimePicker控件的几个应用

1、使用DataTimePicker控件显示时间

    通过将DataTimePicker控件的Format属性设置为Time，可实现控件只显示时间。Format属性用于获取或设置控件中显示的日期和时间格式。

    语法：publicDataTimePickerFormat Format{ get; set; }

说明：属性值表示DataTimePickerFormat值之一，默认为long。

DataTimePickerFormat枚举值及说明

枚举值	说明
Custom	DataTimePicker控件以自动以格式显示日期/时间值
Long	DataTimePicker控件以用户操作系统设置的长日期格式显示日期/时间值
Short	DataTimePicker控件以用户操作系统设置的短日期格式显示日期/时间值
Time	DataTimePicker控件以用户操作系统设置的时间格式显示日期/时间值

 

2、使用DataTimePicker控件以自定义格式显示日期

    通过DataTimePicker控件的CustomFormat属性可以自定义日期/时间格式字符串。

    语法：public string CustomFormat{ get; set; }

    例：创建一个Windows应用程序，首先将控件Format属性设置为DataTimePicker.Custom，使用户自定义的时间格式生效。然后将控件的CustomFormat属性设置为自定义的格式，更改选项后，TextBox控件中的时间也随之更改。代码如下：

private void Form1_Load(object sender, EventArgs e){

   //设置dateTimePicker1的Format属性为Custom，使其用户自定义的时间格式生效

    dateTimePicker1.Format = DateTimePickerFormat.Custom;

   //通过控件CustomFormat属性设置自定义的格式

    dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd";

   //显示当前控件显示的自定义格式的日期

    label1.Text = dateTimePicker1.Text;

}

 

3、返回DataTimePicker控件中选择的日期

    调用DataTimePicker控件的Text属性以返回与控件中的格式相同的完整值，或调用Value属性的适当属性来返回部分值，这些属性包括Year属性、Month属性、Day属性等，使用ToString将信息转换成可显示为用户的字符串。

例：

textBox1.Text = dateTimePicker1.Value.Year.ToString();