QDateTime类参考

最新推荐文章于 2024-01-30 18:41:01 发布

mochouxiyan

最新推荐文章于 2024-01-30 18:41:01 发布

阅读量6.2k

点赞数 1

文章标签： date qt microsoft windows 日历 sun

QT 专栏收录该内容

2 篇文章 0 订阅

订阅专栏

QDateTime类参考

QDateTime类提供了日期和时间功能。详情请见……

#include <qdatetime.h>

所有成员函数的列表。

公有成员

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 )

详细描述

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()。