Qt：QDateTime、QDate、QTime与QDateTimeEdit

时间日期是经常遇到的数据类型，Qt中的时间日期类如下：

• QTime：时间类型，只表示时间，如15:23:13；
• QDate：日期类型，只表示日期，如2017-4-5；
• QDateTime：日期时间类型，表示日期和时间，如2017-03-23 08:12:43；

Qt中有专门用于日期、时间编辑和显示的界面组件：

• QTimeEdit：编辑和显示时间的组件；
• QDateEdit：编辑和显示日期的组件；
• QDateTimeEdit：编辑和显示日期时间的组件；
• QCalendarWidget：一个用日历形式选择日期的组件。

实例程序samp4_5演示了这些时间日期相关类的使用，其运行界面如下图所示：

QDateTime与QString之间的转换

时间、日期编辑器属性设置

在上图左上角“日期时间”Groupbox中，使用QTimeEdit、QDateEdit、QDateTimeEdit组件作为时间、日期、日期时间编辑器；在其右侧，各放置一个QLineEdit组件用于字符串显示。

QDateEdit与QTimeEdit都从QDateTimeEdit继承而来，实现针对日期和时间的特定显示功能。实际上，QDateEdit和QTimeEdit的显示功能都可以通过QDateTimeEdit实现，只需要设置好属性就可以了。

QDateTimeEdit类的主要属性如下：

• datetime：日期时间；
• date：日期；设置datetime时会自动改变date；同时，设置date时，也会自动改变datetime中的日期；
• time：时间；和date类似，设置datetime和time时会互相改变对方的值；
• maximumDateTime、minimumDateTime：最大、最小时间日期；
• maximumTime、minimumTime：最大、最小时间；
• currentSection：当前输入光标所在的时间日期数据段，是枚举类型QDateTimeEdit::Section。QDateTimeEdit显示日期时间数据时分为多个段，单击编辑框右侧的按钮可以修改当前段的值。如输入光标在Year Section段，就修改“年”的值；
• currentSectionIndex：用序号表示输入光标所在的段；
• calendarPopup：是否允许弹出一个日历框；取值为true时，右侧的输入按钮变为下拉按钮，单击按钮时出现一个日历框，用于在日历上选择日期。对于QTimeEdit，此属性无效；
• displayFormat：格式化显示；如果设置为“yyyy-MM-dd HH:mm:ss”，一个日期时间数据就显示为“2016-11-02 08:23:46”

QDateTime的获取与QString的转换

“读取当前日期时间”按钮的clicked()信号的槽函数中，写如下代码：

void Widget::on_btnGetTime_clicked()
{
    //获取当前日期时间，为三个专用编辑器设置日期时间数据，并转换为字符串
    QDateTime curDateTime = QDateTime :: currentDateTime();
    ui->timeEdit->setTime(curDateTime.time());
    ui->editTime->setText(curDateTime.toString("hh:mm:ss"));
    ui->dateEdit->setDate(curDateTime.date());
    ui->editDate->setText(curDateTime.toString("yyyy-MM-dd"));
    ui->dateTimeEdit->setDateTime(curDateTime);
    ui->editDateTime->setText(curDateTime.toString("yyyy-MM-dd hh:mm:ss"));
}

首先用QDateTime类的静态函数currentDateTime()获取当前日期时间，并赋值给变量curDateTime。

然后用curDateTime变量设置界面上的3个Date、Time、DateTime，利用QDateTime的time()、date()分别提取time和date。

将curDateTime表示的日期时间转换为字符串，然后在LineEdit编辑框上显示。转换时使用了QDateTime的toString()函数，函数参数指定了显示Time、Date、DateTime的格式：

QString QDateTime :: toString ( QString format )

它将日期按照format指定的格式转换为字符串。format是一个字符串，包含一些特定的字符，表示Date或Time的各个部分，下表显示了常用format：

字符	意义
d	天，不补零显示，1-31
dd	天，补零显示，01-31
M	月，1-12
MM	月，01-12
yy	年，00-99
yyyy	年，0000-9999
h	小时，0-23或1-12（如果显示AM/PM）
hh	小时，00-23或01-12（如果显示AM/PM）
H	小时，0-23
HH	小时，00-23
m	分钟，0-59
mm	分钟，00-59
s	秒，0-59
ss	秒，00-59
z	毫秒，0-999
zzz	毫秒，000-999
AP或A	AM/PM
ap或A	am/pm

在设置DateTime显示字符串时，还可以使用填字符，甚至使用汉字。例如：

curDateTime.toString("yyyy年MM月dd日");

这样得到的字符将是“2021年6月6日”。

QString转换为DateTime

将QString转换为QTime、QDate、QDateTime类型，需要使用静态函数QDateTime::fromString()：

QDateTime QDateTime :: fromString( string , format )

第一个参数string是DateTime字符串，第二个参数format是格式，按照之前的格式表定义。

在程序运行时，手工修改“日期时间”后面文本框editDateTime中的DateTime字符串，单击“设置日期时间”按钮，可以将文本框中的QString转换为QDateTime变量，并设置为左侧DateTimeEdit组件的DateTime数据：

void Widget::on_btnSetDateTime_clicked()
{
    //QString转换为QDateTime
    QString str = ui->editDateTime->text();
    str = str.trimmed();
    if( !str.isEmpty() )
    {
        QDateTime datetime = QDateTime::fromString(str,"yyyy-MM-dd hh:mm:ss");
        ui->dateTimeEdit->setDateTime(datetime);
    }
}

程序中，字符串str按照格式yyyy-MM-dd hh:mm:ss转换为日期时间变量。

QCalendarWidget日历组件

图1右侧是QCalendarWidget组件，它以日历的形式显示日期，可以用于日期选择。QCalendarWidget有一个信号selectionChanged()，在日历上选择的日期变化后会发射此信号，为此信号创建槽函数，编写代码如下：

void Dialog :: on_calendarWidget_selectionChanged()
{
    //在日历上选择日期
    QDate dt = ui->calendarWidget->selectedDate();
    QString str = dt.toString("yyyy 年 M 月 d 日");
    ui->editCalendar->setText(str);
}

总结

1、有三种日期时间类型QTime、QDate、QDateTime，格式与Python中的同名类相同。

2、假设有三个时间日期相关的控件QDateTimeEdit、QTimeEdit、QDateEdit及其对应的对象名为datetimeEdit、timeEdit、dateEdit，为这三个对象set的函数分别是setDateTime( QDateTime )、setTime( QTime )、setDate( QDate )：

QDateTime now = QDateTime::currentDateTime();
ui->timeEdit->setTime( now.time() );
ui->dateEdit->setDate( now.date() );
ui->datetimeEdit->setDateTime( now );

3、QDateTime→QString：

QString QDateTime :: toString ( format )

例如：

time_str = now.toString("hh:mm:ss");
date_str = now.toString("yyyy-MM-dd");
datetime_str = now.toString("yyyy-MM-dd hh:mm:ss");

只需要在format中用指定格式说明要输出的内容，就可以正确的输出想要的时间日期字符串了。

4、QString→QDateTime、QTime、QDate：

static QDateTime QDateTime :: fromString ( string , format )

QString str = ui->editxxx->text();//从某个QLineEdit中读取输入的QString

...//对str做处理

QDateTime datetime = QDateTime :: fromString( str , "yyyy-MM-dd hh:mm:ss" );//QString→QDateTime

//显示QDateTime
ui->datetimeEdit->setDateTime(datetime);

5、日历控件：QCalendarWidget

有一个选择日期的信号selectionChanged()，在日历上选择日期后，可以得到一个QDate对象：

QDate dt = ui->calendarWidget->selectedDate();

QString str = dt.toString("yyyy年M月d日");//对QDate进行处理