DateTimePicker(日期时间选择器)控件详解
DateTimePicker(日期时间选择器)控件详解
本文面向零基础小白,所有代码都带详细注释。DateTimePicker 用于选择日期或时间。
一、DateTimePicker 是什么
DateTimePicker(日期时间选择器)用来让用户选择一个日期或时间。它默认显示一个日历下拉框,点击后可以翻月选日期,比手动输入日期更规范、不容易出错。
基本信息
| 项目 | 内容 |
|---|---|
| 命名空间 | System.Windows.Forms |
| 继承关系 |
DateTimePicker → Control
|
| 在工具箱里的名字 | DateTimePicker |
| 核心作用 | 选择日期/时间 |
最简单示例
// 获取用户选择的日期
DateTime date = dateTimePicker1.Value;
// 显示成指定格式
MessageBox.Show(date.ToString("yyyy-MM-dd"));
二、如何创建 DateTimePicker
方式 1:设计器拖拽
- 从工具箱拖入
DateTimePicker。 - 在属性窗口设置
Format、Value等属性。
方式 2:代码创建
DateTimePicker dtp = new DateTimePicker(); // 创建对象
dtp.Location = new Point(30, 30); // 位置
dtp.Size = new Size(200, 25); // 大小
dtp.Format = DateTimePickerFormat.Short; // 短日期格式
this.Controls.Add(dtp); // 添加到窗体
三、DateTimePicker 的属性详解
3.1 值类属性
Value —— 当前选择的日期时间(最重要)
// 设置默认值
dtp.Value = new DateTime(2026, 8, 7); // 2026年8月7日
// 获取用户选择的值
DateTime selected = dtp.Value;
Value返回的是DateTime类型(包含日期和时间),不只是日期。
MinDate / MaxDate —— 可选日期范围
dtp.MinDate = new DateTime(2000, 1, 1); // 最早能选 2000年
dtp.MaxDate = new DateTime(2030, 12, 31); // 最晚能选 2030年
3.2 格式类属性
Format —— 显示格式(重要)
| 值 | 说明 | 示例 |
|---|---|---|
Long |
长日期 | 2026年8月7日 |
Short |
短日期 | 2026/8/7 |
Time |
只显示时间 | 14:30:00 |
Custom |
自定义格式 | 自定义 |
dtp.Format = DateTimePickerFormat.Long; // 长日期
dtp.Format = DateTimePickerFormat.Short; // 短日期
dtp.Format = DateTimePickerFormat.Time; // 时间
dtp.Format = DateTimePickerFormat.Custom; // 自定义
CustomFormat —— 自定义格式(配合 Custom 使用)
// 先设为 Custom 模式
dtp.Format = DateTimePickerFormat.Custom;
// 再设置自定义格式
dtp.CustomFormat = "yyyy-MM-dd"; // 2026-08-07
dtp.CustomFormat = "yyyy年MM月dd日"; // 2026年08月07日
dtp.CustomFormat = "HH:mm:ss"; // 14:30:00
dtp.CustomFormat = "yyyy-MM-dd HH:mm"; // 2026-08-07 14:30
常用格式符号:
| 符号 | 含义 | 示例 |
|---|---|---|
yyyy |
四位年份 | 2026 |
MM |
两位月份 | 08 |
dd |
两位日期 | 07 |
HH |
24小时制小时 | 14 |
mm |
分钟 | 30 |
ss |
秒 | 00 |
3.3 外观/行为类属性
ShowUpDown —— 用数字增减代替日历
dtp.ShowUpDown = true; // 显示上下箭头,点击增减(不用日历)
dtp.ShowUpDown = false; // 显示日历下拉(默认)
ShowCheckBox —— 显示复选框(可表示"未选择")
dtp.ShowCheckBox = true; // 前面多一个复选框
dtp.Checked = false; // 未勾选表示"没有日期"
// 判断是否勾选(勾选了才表示有日期)
if (dtp.Checked)
{
DateTime date = dtp.Value;
}
else
{
MessageBox.Show("未选择日期");
}
CalendarForeColor / CalendarMonthBackground —— 日历颜色
dtp.CalendarForeColor = Color.Blue; // 日历文字颜色
dtp.CalendarMonthBackground = Color.White; // 日历背景色
四、DateTimePicker 的事件详解
4.1 ValueChanged —— 值改变事件(最常用)
什么时候触发:用户选择新的日期/时间时触发。
private void dtp_ValueChanged(object sender, EventArgs e)
{
// 获取新选择的值
DateTime date = dtp.Value;
lblTip.Text = "选择了:" + date.ToString("yyyy-MM-dd");
}
4.2 CloseUp —— 日历下拉关闭时
什么时候触发:日历下拉面板关闭时触发。
private void dtp_CloseUp(object sender, EventArgs e)
{
// 关闭日历下拉时触发(用户选完日期后)
MessageBox.Show("日期已选择");
}
4.3 DropDown —— 日历下拉展开时
private void dtp_DropDown(object sender, EventArgs e)
{
// 展开日历下拉时触发
}
五、实用技巧
5.1 获取并格式化日期
// 获取选中的日期
DateTime date = dtp.Value;
// 各种格式化
string s1 = date.ToString("yyyy-MM-dd"); // 2026-08-07
string s2 = date.ToString("yyyy年MM月dd日"); // 2026年08月07日
string s3 = date.ToString("yyyy/MM/dd HH:mm"); // 2026/08/07 14:30
5.2 计算两个日期的间隔
private void btnCalc_Click(object sender, EventArgs e)
{
// 两个日期选择器
DateTime start = dtpStart.Value; // 开始日期
DateTime end = dtpEnd.Value; // 结束日期
// 计算相差天数
TimeSpan span = end - start;
int days = span.Days;
MessageBox.Show("相差 " + days + " 天");
}
5.3 设置默认值为今天
dtp.Value = DateTime.Now; // 当前日期时间
dtp.Value = DateTime.Today; // 今天(零点)
5.4 只显示时间
dtp.Format = DateTimePickerFormat.Time; // 只显示时间
dtp.ShowUpDown = true; // 用上下箭头调时间
六、数据绑定与实体类示例
6.1 什么是实体类(Model)
实体类就是用代码描述现实中的一个对象。比如"学生"有出生日期这个特征:
// 定义一个"学生"实体类
public class Student
{
public int Id { get; set; } // 学号
public string Name { get; set; } // 姓名
public DateTime BirthDate { get; set; } // 出生日期(DateTime 类型)
}
DateTime是 C# 里专门表示日期和时间的类型。
6.2 如何新建一个实体类
方式 1:用 Visual Studio 添加类(推荐)
- 在"解决方案资源管理器"里,右键点击项目名。
- 选择"添加" → "新建项"(或"类")。
- 选择"类",文件名填
Student.cs。 - 点"添加",把上面的代码填进去。
方式 2:手动写代码
在任意 .cs 文件里(namespace 里面)粘贴上面的类代码即可。
6.3 回显(实体类 → DateTimePicker)
把实体类的日期值显示到选择器:
private void Form1_Load(object sender, EventArgs e)
{
// 1. 假设从数据库查到的学生对象
Student student = new Student();
student.Id = 1;
student.Name = "张三";
student.BirthDate = new DateTime(2000, 5, 20); // 2000年5月20日
// 2. 把出生日期显示到选择器
dtpBirth.Value = student.BirthDate;
}
6.4 保存(DateTimePicker → 实体类)
把选择器的值存回实体类:
private void btnSave_Click(object sender, EventArgs e)
{
// 创建对象
Student student = new Student();
student.Name = "张三";
// 把选择的日期存进对象
student.BirthDate = dtpBirth.Value;
MessageBox.Show("保存成功!出生日期:" + student.BirthDate.ToString("yyyy-MM-dd"));
}
6.5 真正的数据绑定(DataBindings)
DateTimePicker 支持把 Value 属性绑定到实体类的 DateTime 属性:
private void Form1_Load(object sender, EventArgs e)
{
// 1. 创建学生对象
Student student = new Student
{
Id = 1,
Name = "张三",
BirthDate = new DateTime(2000, 5, 20),
};
// 2. 把 DateTimePicker 的 Value 属性绑定到 student 的 BirthDate 属性
// 参数1:控件属性名("Value")
// 参数2:数据源对象(student)
// 参数3:数据源对象的属性名("BirthDate")
dtpBirth.DataBindings.Add("Value", student, "BirthDate");
}
绑定后的效果:
// 改了对象属性,选择器自动更新
student.BirthDate = new DateTime(2001, 1, 1);
// dtpBirth 自动显示 2001年1月1日
// 反过来:用户改选择器,对象属性自动更新
// 用户选择新日期后,student.BirthDate 自动变成新日期
七、完整实战示例
做一个"员工入职信息"表单,包含姓名和入职日期:
public partial class Form1 : Form
{
// 当前编辑的员工对象
private Employee _employee;
public Form1()
{
InitializeComponent();
}
// 窗体加载时初始化
private void Form1_Load(object sender, EventArgs e)
{
// 模拟从数据库读数据
_employee = new Employee
{
Id = 1,
Name = "张三",
JoinDate = new DateTime(2020, 3, 15), // 入职日期
};
// 回显姓名
txtName.Text = _employee.Name;
// 回显入职日期
dtpJoinDate.Value = _employee.JoinDate;
}
// 点击保存
private void btnSave_Click(object sender, EventArgs e)
{
// 保存姓名
_employee.Name = txtName.Text.Trim();
// 保存入职日期
_employee.JoinDate = dtpJoinDate.Value;
MessageBox.Show("保存成功!\n姓名:" + _employee.Name +
"\n入职日期:" + _employee.JoinDate.ToString("yyyy-MM-dd"));
}
}
// 员工实体类
public class Employee
{
public int Id { get; set; } // 员工编号
public string Name { get; set; } // 姓名
public DateTime JoinDate { get; set; } // 入职日期
}
八、常见问题
Q1:怎么只显示日期不显示时间?
答:设置 dtp.Format = DateTimePickerFormat.Short; 或 Custom + CustomFormat = "yyyy-MM-dd"。
Q2:怎么自定义日期显示格式?
答:dtp.Format = DateTimePickerFormat.Custom; 然后 dtp.CustomFormat = "yyyy年MM月dd日";
Q3:怎么限制只能选某个范围的日期?
答:设置 dtp.MinDate 和 dtp.MaxDate。
Q4:怎么让用户可以不选日期?
答:dtp.ShowCheckBox = true; 然后用 dtp.Checked 判断是否勾选。
Q5:Value 返回的是什么类型?
答:DateTime 类型,包含日期和时间,可以调用 .ToString("格式") 格式化输出。
内容来自 简书首页,版权归原作者所有。
阅读原文 ↗