📄 qdatetime.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/reggie/tmp/qt-3.0-reggie-5401/qt-x11-commercial-3.0.5/src/tools/qdatetime.cpp:1672 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<meta name="Translator" content="Cavendish">
<meta name="Qt zh_CN Documents Website" content="http://www.qiliang.net/qt">
<title>QDateTime类</title>
<style type="text/css"><!--
h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; font-family: "Times New Roman" }
--></style>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
<a href="index.html">
<font color="#004faf">主页</font></a>
| <a href="classes.html">
<font color="#004faf">所有的类</font></a>
| <a href="mainclasses.html">
<font color="#004faf">主要的类</font></a>
| <a href="annotated.html">
<font color="#004faf">注释的类</font></a>
| <a href="groups.html">
<font color="#004faf">分组的类</font></a>
| <a href="functions.html">
<font color="#004faf">函数</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table>
<h1 align=center>QDateTime类参考</h1>
<p>QDateTime类提供了日期和时间功能。
<a href="#details">详情请见……</a>
<p><tt>#include <<a href="qdatetime-h.html">qdatetime.h</a>></tt>
<p><a href="qdatetime-members.html">所有成员函数的列表。</a>
<h2>公有成员</h2>
<ul>
<li><div class=fn><a href="#QDateTime"><b>QDateTime</b></a> ()</div></li>
<li><div class=fn><a href="#QDateTime-2"><b>QDateTime</b></a> ( const QDate & date )</div></li>
<li><div class=fn><a href="#QDateTime-3"><b>QDateTime</b></a> ( const QDate & date, const QTime & time )</div></li>
<li><div class=fn>bool <a href="#isNull"><b>isNull</b></a> () const</div></li>
<li><div class=fn>bool <a href="#isValid"><b>isValid</b></a> () const</div></li>
<li><div class=fn>QDate <a href="#date"><b>date</b></a> () const</div></li>
<li><div class=fn>QTime <a href="#time"><b>time</b></a> () const</div></li>
<li><div class=fn>void <a href="#setDate"><b>setDate</b></a> ( const QDate & date )</div></li>
<li><div class=fn>void <a href="#setTime"><b>setTime</b></a> ( const QTime & time )</div></li>
<li><div class=fn>void <a href="#setTime_t"><b>setTime_t</b></a> ( uint secsSince1Jan1970UTC )</div></li>
<li><div class=fn>QString <a href="#toString-2"><b>toString</b></a> ( Qt::DateFormat f = Qt::TextDate ) const</div></li>
<li><div class=fn>QString <a href="#toString"><b>toString</b></a> ( const QString & format ) const</div></li>
<li><div class=fn>QDateTime <a href="#addDays"><b>addDays</b></a> ( int ndays ) const</div></li>
<li><div class=fn>QDateTime <a href="#addMonths"><b>addMonths</b></a> ( int nmonths ) const</div></li>
<li><div class=fn>QDateTime <a href="#addYears"><b>addYears</b></a> ( int nyears ) const</div></li>
<li><div class=fn>QDateTime <a href="#addSecs"><b>addSecs</b></a> ( int nsecs ) const</div></li>
<li><div class=fn>int <a href="#daysTo"><b>daysTo</b></a> ( const QDateTime & dt ) const</div></li>
<li><div class=fn>int <a href="#secsTo"><b>secsTo</b></a> ( const QDateTime & dt ) const</div></li>
<li><div class=fn>bool <a href="#operator-eq-eq"><b>operator==</b></a> ( const QDateTime & dt ) const</div></li>
<li><div class=fn>bool <a href="#operator!-eq"><b>operator!=</b></a> ( const QDateTime & dt ) const</div></li>
<li><div class=fn>bool <a href="#operator-lt"><b>operator<</b></a> ( const QDateTime & dt ) const</div></li>
<li><div class=fn>bool <a href="#operator-lt-eq"><b>operator<=</b></a> ( const QDateTime & dt ) const</div></li>
<li><div class=fn>bool <a href="#operator-gt"><b>operator></b></a> ( const QDateTime & dt ) const</div></li>
<li><div class=fn>bool <a href="#operator-gt-eq"><b>operator>=</b></a> ( const QDateTime & dt ) const</div></li>
</ul>
<h2>静态公有成员</h2>
<ul>
<li><div class=fn>QDateTime <a href="#currentDateTime"><b>currentDateTime</b></a> ()</div></li>
<li><div class=fn>QDateTime <a href="#fromString"><b>fromString</b></a> ( const QString & s, Qt::DateFormat f = Qt::TextDate )</div></li>
</ul>
<h2>相关函数</h2>
<ul>
<li><div class=fn>QDataStream & <a href="#operator-lt-lt"><b>operator<<</b></a> ( QDataStream & s, const QDateTime & dt )</div></li>
<li><div class=fn>QDataStream & <a href="#operator-gt-gt"><b>operator>></b></a> ( QDataStream & s, QDateTime & dt )</div></li>
</ul>
<hr><a name="details"></a><h2>详细描述</h2>
QDateTime类提供了日期和时间功能。
<p>
<p> QDateTime对象包含一个日历日期和一个时钟时间（一个“日期时间”）。它是<a href="qdate.html">QDate</a>和<a href="qtime.html">QTime</a>两个类的组合。它可以从系统时钟中读取当前日期时间。它提供比较日期时间和操作日期时间的函数，比如加上一定数量的秒、天、月或年。
<p> QDateTime对象通常可以由明白地给定的日期和时间来创建，或者使用静态函数<a href="#currentDateTime">currentDateTime</a>()让QDateTime对象包含系统时钟的日期时间。日期时间也可以由<a href="#setDate">setDate</a>()和<a href="#setTime">setTime</a>()来改变。日期时间也可以通过使用<a href="#setTime_t">setTime_t</a>()函数来得到一个POSIX标准的时间，它表示的是自从1970年1月1日00:00:00以来的秒数。<a href="#fromString">fromString</a>()函数通过一个给定的字符串和在字符串中日期时间格式的间隔说明就可以返回一个QDateTime。
<p> <a href="#date">date</a>()和<a href="#time">time</a>()函数提供了对日期和时间的访问。<a href="#toString">toString</a>()提供了文本格式的相同信息。
<p> QDateTime提供了一整套的操作符来比较两个QDateTime对象，在这里小于表示早一些，大于表示晚一些。
<p> 你可以使用<a href="#addSecs">addSecs</a>()或<a href="#addDays">addDays</a>()给一个日期增加（或减少）一个给定的秒数或天数。相似地你可以使用<a href="#addMonths">addMonths</a>()和<a href="#addYears">addYears</a>()。<a href="#daysTo">daysTo</a>()函数返回两个日期时间之间的天数，sectTo()返回两个日期时间之间的秒数。
<p> 日期时间对象的范围由<a href="qdate.html">QDate</a>和<a href="qtime.html">QTime</a>对象的范围约束。
<p> <p>也可以参考<a href="qdate.html">QDate</a>、<a href="qtime.html">QTime</a>、<a href="qdatetimeedit.html">QDateTimeEdit</a>和<a href="time.html">时间和日期</a>。
<hr><h2>成员函数文档</h2>
<h3 class=fn><a name="QDateTime"></a>QDateTime::QDateTime ()
</h3>
<p> 构造一个零日期时间（比如，零日期和零时间）。一个零日期时间是无效的，因为零日期是无效的。
<p> <p>也可以参考<a href="#isValid">isValid</a>()。
<h3 class=fn><a name="QDateTime-2"></a>QDateTime::QDateTime ( const <a href="qdate.html">QDate</a> & date )
</h3>
构造一个日期为<em>date</em>和零时间（00:00:00.000）的日期时间。
<h3 class=fn><a name="QDateTime-3"></a>QDateTime::QDateTime ( const <a href="qdate.html">QDate</a> & date, const <a href="qtime.html">QTime</a> & time )
</h3>
构造一个日期为<em>date</em>和时间为<em>time</em>的日期时间。
<h3 class=fn><a href="qdatetime.html">QDateTime</a> <a name="addDays"></a>QDateTime::addDays ( int ndays ) const
</h3>
返回这个日期时间对象<em>ndays</em>天之后的一个日期时间对象（或者<em>ndays</em>天之前的，如果它是一个负数）。
<p> <p>也可以参考<a href="#daysTo">daysTo</a>()、<a href="#addMonths">addMonths</a>()、<a href="#addYears">addYears</a>()和<a href="#addSecs">addSecs</a>()。
<h3 class=fn><a href="qdatetime.html">QDateTime</a> <a name="addMonths"></a>QDateTime::addMonths ( int nmonths ) const
</h3>
返回这个日期时间对象<em>nmonths</em>月之后的一个日期时间对象（或者<em>nmonths</em>月之前的，如果它是一个负数）。
<p> <p>也可以参考<a href="#daysTo">daysTo</a>()、<a href="#addDays">addDays</a>()、<a href="#addYears">addYears</a>()和<a href="#addSecs">addSecs</a>()。
<h3 class=fn><a href="qdatetime.html">QDateTime</a> <a name="addSecs"></a>QDateTime::addSecs ( int nsecs ) const
</h3>
返回这个日期时间对象<em>nsecs</em>秒之后的一个日期时间对象（或者<em>nsecs</em>秒之前的，如果它是一个负数）。
<p> <p>也可以参考<a href="#secsTo">secsTo</a>()、<a href="#addDays">addDays</a>()、<a href="#addMonths">addMonths</a>()和<a href="#addYears">addYears</a>()。
<p>实例：<a href="listviews-example.html#x323">listviews/listviews.cpp</a>。
<h3 class=fn><a href="qdatetime.html">QDateTime</a> <a name="addYears"></a>QDateTime::addYears ( int nyears ) const
</h3>
返回这个日期时间对象<em>nyears</em>年之后的一个日期时间对象（或者<em>nyears</em>年之前的，如果它是一个负数）。
<p> <p>也可以参考<a href="#daysTo">daysTo</a>()、<a href="#addDays">addDays</a>()、<a href="#addMonths">addMonths</a>()和<a href="#addSecs">addSecs</a>()。
<h3 class=fn><a href="qdatetime.html">QDateTime</a> <a name="currentDateTime"></a>QDateTime::currentDateTime ()<tt> [静态]</tt>
</h3>
返回当前日期时间，来自于系统时钟。
<p> <p>也可以参考<a href="qdate.html#currentDate">QDate::currentDate</a>()和<a href="qtime.html#currentTime">QTime::currentTime</a>()。
<p>实例：<a href="listviews-example.html#x324">listviews/listviews.cpp</a>。
<h3 class=fn><a href="qdate.html">QDate</a> <a name="date"></a>QDateTime::date () const
</h3>
<p> 返回日期时间的日期部分。
<p> <p>也可以参考<a href="#setDate">setDate</a>()和<a href="#time">time</a>()。
<h3 class=fn>int <a name="daysTo"></a>QDateTime::daysTo ( const <a href="qdatetime.html">QDateTime</a> & dt ) const
</h3>
返回这个日期时间到<em>dt</em>的天数（如果<em>dt</em>早于这个日期时间，返回的为负数）。
<p> <p>也可以参考<a href="#addDays">addDays</a>()和<a href="#secsTo">secsTo</a>()。
<h3 class=fn><a href="qdatetime.html">QDateTime</a> <a name="fromString"></a>QDateTime::fromString ( const <a href="qstring.html">QString</a> & s, <a href="qt.html#DateFormat-enum">Qt::DateFormat</a> f = Qt::TextDate )<tt> [静态]</tt>
</h3>
通过给定的字符串<em>s</em>，使用格式<em>f</em>，返回这个QDateTime，或者如果这是不可能的话返回一个无效的日期时间。
<p> 注意Qt::LocalDate在这里不能使用。
<p> 注意Qt::TextDate：它被推荐使用英语中的月的缩写格式（比如Jan）。本地的月名称也可以被使用，但这取决于用户的本地设置。
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -