QDateTime ()

QDateTime ( const QDate & date )

QDateTime ( const QDate & date, const QTime & time )

bool isNull () const

bool isValid () const

QDate date () const

QTime time () const

void setDate ( const QDate & date )

void setTime ( const QTime & time )

void setTime_t ( uint secsSince1Jan1970UTC )

QString toString ( Qt::DateFormat f = Qt::TextDate ) const

QString toString ( const QString & format ) const

QDateTime addDays ( int ndays ) const

QDateTime addMonths ( int nmonths ) const

QDateTime addYears ( int nyears ) const

QDateTime addSecs ( int nsecs ) const

int daysTo ( const QDateTime & dt ) const

int secsTo ( const QDateTime & dt ) const

bool operator== ( const QDateTime & dt ) const

bool operator!= ( const QDateTime & dt ) const

bool operator< ( const QDateTime & dt ) const

bool operator<= ( const QDateTime & dt ) const

bool operator> ( const QDateTime & dt ) const

bool operator>= ( const QDateTime & dt ) const

静态公有成员

QDateTime currentDateTime ()

QDateTime fromString ( const QString & s, Qt::DateFormat f = Qt::TextDate )

QDataStream & operator<< ( QDataStream & s, const QDateTime & dt )

QDataStream & operator>> ( QDataStream & s, QDateTime & dt )

QDateTime类提供了日期和时间功能。

QDateTime对象包含一个日历日期和一个时钟时间（一个“日期时间”）。它是 QDate 和 QTime 两个类的组合。它可以从系统时钟中读取当前日期时间。它提供比较日期时间和操作日期时间的函数，比如加上一定数量的秒、天、月或年。

QDateTime对象通常可以由明白地给定的日期和时间来创建，或者使用静态函数 currentDateTime ()让QDateTime对象包含系统时钟的日期时间。日期时间也可以由 setDate ()和 setTime ()来改变。日期时间也可以通过使用 setTime_t ()函数来得到一个POSIX标准的时间，它表示的是自从1970年1月1日00:00:00以来的秒数。 fromString ()函数通过一个给定的字符串和在字符串中日期时间格式的间隔说明就可以返回一个QDateTime。

date ()和 time ()函数提供了对日期和时间的访问。 toString ()提供了文本格式的相同信息。

QDateTime提供了一整套的操作符来比较两个QDateTime对象，在这里小于表示早一些，大于表示晚一些。

你可以使用 addSecs ()或 addDays ()给一个日期增加（或减少）一个给定的秒数或天数。相似地你可以使用 addMonths ()和 addYears ()。 daysTo ()函数返回两个日期时间之间的天数，sectTo()返回两个日期时间之间的秒数。

日期时间对象的范围由 QDate 和 QTime 对象的范围约束。

也可以参考 QDate 、 QTime 、 QDateTimeEdit 和 时间和日期 。

---

成员函数文档

QDateTime::QDateTime ()

构造一个零日期时间（比如，零日期和零时间）。一个零日期时间是无效的，因为零日期是无效的。

也可以参考 isValid ()。

QDateTime::QDateTime ( const QDate & date ) 构造一个日期为 date 和零时间（00:00:00.000）的日期时间。

QDateTime::QDateTime ( const QDate & date, const QTime & time ) 构造一个日期为 date 和时间为 time 的日期时间。

QDateTime QDateTime::addDays ( int ndays ) const 返回这个日期时间对象 ndays 天之后的一个日期时间对象（或者 ndays 天之前的，如果它是一个负数）。

也可以参考 daysTo ()、 addMonths ()、 addYears ()和 addSecs ()。

QDateTime QDateTime::addMonths ( int nmonths ) const 返回这个日期时间对象 nmonths 月之后的一个日期时间对象（或者 nmonths 月之前的，如果它是一个负数）。

也可以参考 daysTo ()、 addDays ()、 addYears ()和 addSecs ()。

QDateTime QDateTime::addSecs ( int nsecs ) const 返回这个日期时间对象 nsecs 秒之后的一个日期时间对象（或者 nsecs 秒之前的，如果它是一个负数）。

也可以参考 secsTo ()、 addDays ()、 addMonths ()和 addYears ()。

实例： listviews/listviews.cpp 。

QDateTime QDateTime::addYears ( int nyears ) const 返回这个日期时间对象 nyears 年之后的一个日期时间对象（或者 nyears 年之前的，如果它是一个负数）。

也可以参考 daysTo ()、 addDays ()、 addMonths ()和 addSecs ()。

QDateTime QDateTime::currentDateTime () [静态] 返回当前日期时间，来自于系统时钟。

也可以参考 QDate::currentDate ()和 QTime::currentTime ()。

实例： listviews/listviews.cpp 。

QDate QDateTime::date () const

返回日期时间的日期部分。

也可以参考 setDate ()和 time ()。

int QDateTime::daysTo ( const QDateTime & dt ) const 返回这个日期时间到 dt 的天数（如果 dt 早于这个日期时间，返回的为负数）。

也可以参考 addDays ()和 secsTo ()。

QDateTime QDateTime::fromString ( const QString & s, Qt::DateFormat f = Qt::TextDate ) [静态] 通过给定的字符串 s ，使用格式 f ，返回这个QDateTime，或者如果这是不可能的话返回一个无效的日期时间。

注意Qt::LocalDate在这里不能使用。

注意Qt::TextDate：它被推荐使用英语中的月的缩写格式（比如Jan）。本地的月名称也可以被使用，但这取决于用户的本地设置。

bool QDateTime::isNull () const

如果日期和时间都是零，返回真，否则返回假。一个零日期时间是无效的。

也可以参考 QDate::isNull ()和 QTime::isNull ()。

bool QDateTime::isValid () const

如果日期和时间都是有效的，返回真，否则返回假。

也可以参考 QDate::isValid ()和 QTime::isValid ()。

bool QDateTime::operator!= ( const QDateTime & dt ) const 如果这个日期时间不等于 dt ，返回真，否则返回假。

也可以参考 operator== ()。

bool QDateTime::operator< ( const QDateTime & dt ) const 如果这个日期时间早于 dt ，返回真，否则返回假。

bool QDateTime::operator<= ( const QDateTime & dt ) const 如果这个日期时间不晚于 dt ，返回真，否则返回假。

bool QDateTime::operator== ( const QDateTime & dt ) const 如果这个日期时间等于 dt ，返回真，否则返回假。

也可以参考 operator!= ()。

bool QDateTime::operator> ( const QDateTime & dt ) const 如果这个日期时间晚于 dt ，返回真，否则返回假。

bool QDateTime::operator>= ( const QDateTime & dt ) const 如果这个日期时间不早于 dt ，返回真，否则返回假。

int QDateTime::secsTo ( const QDateTime & dt ) const 返回从这个日期到 dt 的秒数（如果 dt 早于这个日期，返回的为负数）。 QDateTime dt = QDateTime:: currentDateTime (); QDateTime xmas( QDate(dt.year(),12,24), QTime(17,00) ); qDebug ( "There are %d seconds to Christmas", dt. secsTo (xmas) ); // 离圣诞节还有多少秒

也可以参考 addSecs ()、 daysTo ()和 QTime::secsTo ()。

void QDateTime::setDate ( const QDate & date )

设置日期时间的日期部分为 date 。

也可以参考 date ()和 setTime ()。

void QDateTime::setTime ( const QTime & time )

设置日期时间的时间部分为 time 。

也可以参考 time ()和 setDate ()。

void QDateTime::setTime_t ( uint secsSince1Jan1970UTC ) 通过给定的从1970年1月1日00:00:00（通用协调时间）所过的秒来设置本地时间的日期和时间。在不支持时区的系统上，这个函数的行为就好像本地时间是通用协调时间一样。

注意Microsoft Windows只支持一定范围的 secsSince1Jan1970UTC 的值。

QTime QDateTime::time () const

返回日期时间的时间部分。

也可以参考 setTime ()和 date ()。

QString QDateTime::toString ( const QString & format ) const 返回一个字符串的日期时间。 format 参数决定了结果字符串的格式。

这些是可能用到的日期表达式：

d - 没有前置0的数字的天（1－31）

dd - 前置0的数字的天（01－31）

ddd - 缩写的日名称（Mon－Sun）。使用 QDate::shortDayName ()。

dddd - 长的日名称（Monday－Sunday）。使用 QDate::longDayName ()。

M - 没有前置0的数字的月（1－12）

MM - 前置0的数字的月（01－12）

MMM - 缩写的月名称（Jan－Dec）。使用 QDate::shortMonthName ()。

MMMM - 长的月名称（January－December）。使用 QDate::longMonthName ()。

yy - 两位数字的年（00－99）

yyyy - 四位数字的年（0000-9999）

这些是可能用到的时间表达式：

h - 没有前置0的数字的小时（0－23或者如果显示AM/PM时，1－12）

hh - 前置0的数字的小时（00－23或者如果显示AM/PM时，01－12）

m - 没有前置0的数字的分钟（0－59）

mm - 前置0的数字的分钟（00－59）

s - 没有前置0的数字的秒（0－59）

ss - 前置0的数字的秒（00－59）

z - 没有前置0的数字的毫秒（0－999）

zzz - 前置0的数字的毫秒（000－999）

AP - 切换为AM/PM显示。 AP 将被“AM”或“PM”替换。

ap - 切换为am/pm显示。 ap 将被“am”或“pm”替换。

所有其他输入字符都将被忽略。

格式字符串实例（假设这个QDateTime为2001年5月21日14:13:09）

“dd.MM.yyyy”的结果将是“21.05.2001”

“ddd MMMM d yy”的结果将是“Tue May 21 01”

“hh:mm:ss.zzz”的结果将是“14:13:09.042”

“h:m:s ap”的结果将是“2:13:9 pm”

也可以参考 QDate::toString ()和 QTime::toString ()。

QString QDateTime::toString ( Qt::DateFormat f = Qt::TextDate ) const 这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

返回一个字符串的日期时间。 f 参数决定了结果字符串的格式。

如果 f 是Qt::TextDate，字符串格式是“Wed May 20 03:40:13 1998”（使用 shortDayName ()、 shortMonthName ()和 QTime::toString ()函数来生成本地指定的字符串）。

如果 f 是Qt::ISODate，字符串格式遵循ISO 8601表示日期和时间的说明，也就是YYYY-MM-DDTHH:MM:SS。

如果 f 是Qt::LocalDate，字符串格式依赖于系统的本地设置。

如果 f 是无效的， toString ()返回一个空字符串。

也可以参考 QDate::toString ()和 QTime::toString ()。

QDataStream & operator<< ( QDataStream & s, const QDateTime & dt ) 写日期时间 dt 到流 s 中。

也可以参考 QDataStream操作符的格式 。

QDataStream & operator>> ( QDataStream & s, QDateTime & dt ) 从流 s 中读取一个日期时间到 dt 。

也可以参考 QDataStream操作符的格式 。 这个文件是 Qt工具包 一部分。 Trolltech 。保留所有权利。