C# | DateTimePicker类

简介

DateTimePicker类是C#中的一个Windows控件类，用于在窗体中提供一个日期选择器或时间选择器。该控件可以方便程序员选择指定日期或时间，并且可以根据需要进行格式化显示。

特点

• 通过简单的拖放操作即可在窗体中添加日期选择器或时间选择器。
• 可以根据需要自定义控件的格式，包括日期格式、时间格式等。
• 支持多种日期选择模式，例如长日期、短日期、自定义日期等。
• 可以在控件中设置默认值、最小值、最大值等属性。
• 支持国际化，可以通过设置不同的区域选项，来自动适应不同的区域和语言设置。

属性

| 属性名称 | 描述 | | ---------------- | ------------------------------------------------------------ | | CustomFormat | 设置或获取自定义日期时间格式字符串。 | | Format | 设置或获取控件的日期时间格式。 | | MinDate | 设置或获取日期范围的最小值。 | | MaxDate | 设置或获取日期范围的最大值。 | | Value | 设置或获取控件的当前日期值。 | | Checked | 设置或获取控件是否显示当前日期。 | | ShowUpDown | 设置或获取控件是否显示"上下"按钮。 | | ShowCheckBox | 设置或获取控件是否显示一个复选框（用来选中或取消当前日期值）。 | | ShowCalendar | 设置或获取控件是否显示日历。 | | AllowDrop | 设置或获取控件是否支持拖放操作。 | | AutoSize | 设置或获取控件的自动大小模式。 | | BorderStyle | 设置或获取控件的边框样式。 | | Font | 设置或获取控件所使用的字体。 | | ForeColor | 设置或获取控件的前景色。 | | BackColor | 设置或获取控件的背景色。 | | RightToLeft | 设置或获取控件的文本方向。 | | TabStop | 设置或获取控件是否可以使用 Tab 键聚焦。 | | Visible | 设置或获取控件的可见状态。 | | Date | 获取或设置控件中的当前日期。 | | Time | 获取或设置控件中的当前时间。 |

事件

| 事件名称 | 事件说明 | | ---------------------------------------- | -------------------------------------------------------------- | | ValueChanged | 当控件的 Value 属性的值更改时发生。 | | CloseUp | 当下拉式日历关闭时发生。 | | DropDown | 当下拉式的月/yyyy 日历的下降部分显示时发生。 | | DropDownAlign | 获取或设置一个控件的下拉框出现的位置（左、右、下）。 | | FormatChanged | 当控件的 Format 属性已更改时发生。 | | Validating | 当控件失去焦点并且它的值当前正在更改时发生。 | | ContextMenuStripChanged | 当控件的 ContextMenuStrip 属性更改时发生。 | | ControlAdded | 向控件的 Control.ControlCollection 添加新控件时发生。 | | ControlRemoved | 从控件的 Control.ControlCollection 移除控件时发生。 | | DragDrop | 拖放操作完成时发生。 | | EnabledChanged | 控件的 Enabled 属性值更改时发生。 | | FontChanged | 当控件的 Font 属性值更改时发生。 | | ForeColorChanged | 当控件的 ForeColor 属性值更改时发生。 | | LocationChanged | 控件位置更改时发生（拖动后释放鼠标）。 | | PaddingChanged | 控件的内边距更改时发生。 | | ParentChanged | 控件的 Parent 属性值更改时发生。 | | SizeChanged | 控件的大小更改时发生。 | | StyleChanged | 当控件样式更改时发生。 | | TabIndexChanged | 当控件的 TabIndex 属性值更改时发生。 | | TabStopChanged | 控件的 TabStop 属性值更改时发生。 | | TextChanged | 控件的 Text 属性值更改时发生（通过代码或通过用户交互）。 | | Validated | 控件完成验证时发生。 | | Enter | 控件获得输入焦点时发生。 | | GiveFeedback | 拖动操作期间发生，并且允许拖动源反馈它的拖动状态。 | | KeyDown | 当控件拥有焦点时按下键时发生。 | | KeyUp | 当控件拥有焦点并松开键时发生。 | | KeyPress | 当控件接收某个字符时发生。 | | MouseClick | 单击控件时发生。 | | MouseDoubleClick | 双击控件时发生。 | | MouseDown | 鼠标指针位于控件上并按下鼠标键时发生。 | | MouseUp | 鼠标指针位于该控件上并释放鼠标键时发生。 | | MouseCaptureChanged | 控件失去或接收鼠标捕获时发生。 | | MouseEnter | 鼠标指针进入控件时发生。 | | MouseHover | 鼠标指针停靠在控件上时发生。 | | MouseLeave | 鼠标指针离开控件时发生。 | | Move | 控件移动时发生。 | | Resize | 控件大小更改时发生。 | | StyleChanged | 控件的样式更改时发生。 | | Invalidated | 控件的显示要求重新绘制时发生。 |

示例代码

创建DateTimePicker控件

DateTimePicker dateTimePicker = new DateTimePicker();
dateTimePicker.Location = new Point(20, 20);
dateTimePicker.Size = new Size(200, 20);
this.Controls.Add(dateTimePicker);

设置DateTimePicker的默认值

dateTimePicker.Value = DateTime.Now;

设置DateTimePicker的日期格式

dateTimePicker.Format = DateTimePickerFormat.Long;

设置DateTimePicker的最小值和最大值

dateTimePicker.MinDate = new DateTime(2020, 1, 1);
dateTimePicker.MaxDate = new DateTime(2030, 12, 31);

获取DateTimePicker的当前日期

DateTime date = dateTimePicker.Value.Date;

获取DateTimePicker的当前时间

DateTime time = dateTimePicker.Value.TimeOfDay;

设置DateTimePicker的自定义日期时间格式字符串

dateTimePicker.CustomFormat = "yyyy-MM-dd HH:mm:ss";

总结

DateTimePicker类是非常实用的一个控件，可以让程序员轻松地提供日期选择器或时间选择器的功能。通过设置不同的属性和事件，可以让控件更符合实际需求。了解DateTimePicker类的属性和事件，可以更好地使用这个控件。