DateTimePicker 日期时间选择器
控件名称
DateTimePicker
中文名称
日期时间选择器
控件优点
DateTimePicker 是一个功能强大的日期时间选择控件，支持多种值类型和主题色，可以绑定多个文本框实现数据同步。
主要特性
- 多种值类型：支持年份、月份、日期、时间四种选择模式
- 文本框绑定：可同时绑定多个文本框，选择值自动同步
- 主题色系统：内置8种主题色（蓝绿、清新绿、经典蓝、红、橙、紫、深灰、浅灰）
- 圆角设计：支持自定义圆角半径
- 清除功能：支持一键清除已选值
- 自定义格式：支持自定义显示格式
重要参数说明
数据属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
Value |
DateTime | DateTime.Now | 当前选中的日期时间值 |
Text |
string | - | 获取/设置格式化后的值字符串（根据 ValueType 自动格式化） |
ValueType |
DateTimePickerValueType | Date | 选择器值类型 |
值类型枚举
| 枚举值 | 说明 | 显示格式 |
|---|---|---|
Year |
年份选择 | yyyy |
Month |
月份选择 | yyyy-MM |
Date |
日期选择 | yyyy-MM-dd |
Time |
时间选择 | HH:mm:ss |
外观属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
Theme |
DateTimePickerTheme | Teal | 主题色 |
BorderRadius |
int | 6 | 边框圆角半径 |
BorderWidth |
int | 1 | 边框宽度 |
BorderColor |
Color | 217, 217, 217 | 边框颜色 |
BackColor |
Color | White | 背景颜色 |
ForeColor |
Color | Black | 文字颜色 |
Placeholder |
string | "请选择" | 占位符文本 |
PlaceholderColor |
Color | Gray | 占位符颜色 |
ShowClearButton |
bool | true | 是否显示清除按钮 |
PrefixText |
string | "" | 前缀文本 |
PrefixColor |
Color | Gray | 前缀文本颜色 |
主题色枚举
| 枚举值 | 颜色值 | 说明 |
|---|---|---|
Teal |
#16baaa | 蓝绿色（默认） |
Green |
#16b777 | 清新绿 |
Blue |
#1e9fff | 经典蓝 |
Red |
#ff5722 | 红色 |
Orange |
#ffb800 | 橙色 |
Purple |
#a233c6 | 紫色 |
Dark |
#2f363c | 深灰 |
Light |
#fafafa | 浅灰 |