QDateTime

QDateTime类

#include

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

1、详细描述

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

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

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

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

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

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

2、成员函数文档

QDateTime::QDateTime ()

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

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天之前的，如果它是一个负数）。

QDateTime QDateTime::addMonths ( int nmonths ) const

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

QDateTime QDateTime::addSecs ( int nsecs ) const

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

QDateTime QDateTime::addYears ( int nyears ) const

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

QDateTime QDateTime::currentDateTime () [静态]

返回当前日期时间，来自于系统时钟。

QDate QDateTime::date () const

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

int QDateTime::daysTo ( const QDateTime & dt ) const

返回这个日期时间到dt的天数（如果dt早于这个日期时间，返回的为负数）。

QDateTime QDateTime::fromString (const QString & s, Qt::DateFormat f = Qt::TextDate ) [静态]

通过给定的字符串s，使用格式f，返回这个QDateTime，或者如果这是不可能的话返回一个无效的日期时间。

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

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

bool QDateTime::isNull () const

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

bool QDateTime::isValid () const

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

bool QDateTime::operator!= ( const QDateTime & dt ) const

如果这个日期时间不等于dt，返回真，否则返回假。

bool QDateTime::operator< ( const QDateTime & dt ) const

如果这个日期时间早于dt，返回真，否则返回假。

bool QDateTime::operator<= ( const QDateTime & dt ) const

如果这个日期时间不晚于dt，返回真，否则返回假。

bool QDateTime::operator== ( const QDateTime & dt ) const

如果这个日期时间等于dt，返回真，否则返回假。

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) ); // 离圣诞节还有多少秒void QDateTime::setDate ( const QDate & date )

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

void QDateTime::setTime ( const QTime & time )

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

void QDateTime::setTime_t ( uint secsSince1Jan1970UTC )

通过给定的从1970年1月1日00:00:00（通用协调时间）所过的秒来设置本地时间的日期和时间。在不支持时区的系统上，这个函数的行为就好像本地时间是通用协调时间一样。注意Microsoft Windows只支持一定范围的secsSince1Jan1970UTC的值。

QTime QDateTime::time () const

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

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”

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()返回一个空字符串。

相关函数

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

写日期时间dt到流s中。

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

从流s中读取一个日期时间到dt。