DateTimePicker(日期时间选择器)控件详解

DateTimePicker(日期时间选择器)控件详解

本文面向零基础小白,所有代码都带详细注释。DateTimePicker 用于选择日期或时间。


一、DateTimePicker 是什么

DateTimePicker(日期时间选择器)用来让用户选择一个日期或时间。它默认显示一个日历下拉框,点击后可以翻月选日期,比手动输入日期更规范、不容易出错。

基本信息

项目 内容
命名空间 System.Windows.Forms
继承关系 DateTimePicker → Control
在工具箱里的名字 DateTimePicker
核心作用 选择日期/时间

最简单示例

// 获取用户选择的日期
DateTime date = dateTimePicker1.Value;

// 显示成指定格式
MessageBox.Show(date.ToString("yyyy-MM-dd"));

二、如何创建 DateTimePicker

方式 1:设计器拖拽

  1. 从工具箱拖入 DateTimePicker。
  2. 在属性窗口设置 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 添加类(推荐)

  1. 在"解决方案资源管理器"里,右键点击项目名。
  2. 选择"添加" → "新建项"(或"类")。
  3. 选择"类",文件名填 Student.cs。
  4. 点"添加",把上面的代码填进去。

方式 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("格式") 格式化输出。

内容来自 简书首页,版权归原作者所有。

阅读原文 ↗

把喜欢的内容,留在你的新标签页。

打开我的订阅