Qt QDateTimeEdit总结

1. 概述

• QDateTimeEdit 是 Qt 提供的用于编辑日期和时间的控件，支持直接输入或通过弹出日历/时间选择器调整值。
• 继承自 QAbstractSpinBox，是 QDateEdit 和 QTimeEdit 的父类，可同时处理日期和时间。
• 默认显示格式为系统本地化的日期时间格式，但支持自定义格式。

2. 核心特性

日期时间格式

• 使用 setDisplayFormat(const QString &format) 设置显示格式。

  dateTimeEdit->setDisplayFormat("yyyy-MM-dd HH:mm:ss");
  

  • 常用格式符：
    • yyyy：4 位年份
    • MM：2 位月份（01-12）
    • dd：2 位日期（01-31）
    • HH：24 小时制的小时（00-23）
    • hh：12 小时制的小时（01-12）
    • mm：分钟（00-59）
    • ss：秒（00-59）
    • AP 或 A：AM/PM 标识（与 hh 配合使用）

日期时间范围限制

• 设置允许的最小和最大日期时间：

  dateTimeEdit->setMinimumDateTime(QDateTime(QDate(2000, 1, 1), QTime(0, 0)));
  dateTimeEdit->setMaximumDateTime(QDateTime::currentDateTime());
  

弹出日历选择器

• 启用日历弹出窗口（默认禁用）：

  dateTimeEdit->setCalendarPopup(true);
  

键盘和鼠标交互

• 方向键或滚轮调整日期时间部分（如年、月、日）。
• 单击字段手动输入数值。

3. 常用方法

4. 信号

5. 示例代码

// 创建控件并初始化
QDateTimeEdit *dateTimeEdit = new QDateTimeEdit(this);
dateTimeEdit->setDisplayFormat("yyyy-MM-dd HH:mm");
dateTimeEdit->setDateTime(QDateTime::currentDateTime());
dateTimeEdit->setCalendarPopup(true);

// 连接信号到槽函数
connect(dateTimeEdit, &QDateTimeEdit::dateTimeChanged, [](const QDateTime &dt) {
    qDebug() << "New DateTime:" << dt.toString("yyyy-MM-dd HH:mm");
});

6. 注意事项

• 格式兼容性：确保格式字符串与系统本地化兼容，避免显示异常。
• 输入验证：若用户输入非法值，控件会自动调整为最近的有效值。
• 时区处理：默认使用本地时间，跨时区应用需显式设置 Qt::TimeSpec。

7. 进阶用法

• 自定义弹出界面：通过子类化并重写 event() 或使用 QCalendarWidget 定制日历。
• 样式表（QSS）：修改外观：

  QDateTimeEdit {
      background-color: #f0f0f0;
      border: 1px solid #888;
      padding: 2px;
  }