diff options
author | Mitch Curtis <mitch.curtis@nokia.com> | 2012-08-06 12:08:42 +0200 |
---|---|---|
committer | Qt by Nokia <qt-info@nokia.com> | 2012-08-08 09:43:45 +0200 |
commit | ebbd8e66717e7bf400b395e240569e72409c9959 (patch) | |
tree | daafb8dd1bbff26fd8cb283601684c2a43294e94 /src | |
parent | 6820f1716e991ef5e3e83d3f09658197417e4db5 (diff) |
Clarify how days are counted in QDateTime::daysTo documentation.
Mention that the days are counted as the amount of times midnight is
reached between the start and end date.
Task-number: QTBUG-26780
Change-Id: I22ff6c56b748ac968d6991e0be3e10905c0634bd
Reviewed-by: Thiago Macieira <thiago.macieira@intel.com>
Diffstat (limited to 'src')
-rw-r--r-- | src/corelib/doc/snippets/code/src_corelib_tools_qdatetime.cpp | 13 | ||||
-rw-r--r-- | src/corelib/tools/qdatetime.cpp | 10 |
2 files changed, 22 insertions, 1 deletions
diff --git a/src/corelib/doc/snippets/code/src_corelib_tools_qdatetime.cpp b/src/corelib/doc/snippets/code/src_corelib_tools_qdatetime.cpp index 59cd67fe6d..ce0ccc12f4 100644 --- a/src/corelib/doc/snippets/code/src_corelib_tools_qdatetime.cpp +++ b/src/corelib/doc/snippets/code/src_corelib_tools_qdatetime.cpp @@ -144,3 +144,16 @@ QDateTime dateTime = QDateTime::fromString("130", "Mm"); // invalid QDateTime dateTime = QDateTime::fromString("1.30.1", "M.d.s"); // dateTime is January 30 in 1900 at 00:00:01. //! [14] + +//! [15] +QDateTime startDate(QDate(2012, 7, 6), QTime(8, 30, 0)); +QDateTime endDate(QDate(2012, 7, 7), QTime(16, 30, 0)); +qDebug() << "Days from startDate to endDate: " << startDate.daysTo(endDate); + +startDate = QDateTime(QDate(2012, 7, 6), QTime(23, 55, 0)); +endDate = QDateTime(QDate(2012, 7, 7), QTime(0, 5, 0)); +qDebug() << "Days from startDate to endDate: " << startDate.daysTo(endDate); + +qSwap(startDate, endDate); // Make endDate before startDate. +qDebug() << "Days from startDate to endDate: " << startDate.daysTo(endDate); +//! [15]
\ No newline at end of file diff --git a/src/corelib/tools/qdatetime.cpp b/src/corelib/tools/qdatetime.cpp index 87ff03cdcd..769ab0acb6 100644 --- a/src/corelib/tools/qdatetime.cpp +++ b/src/corelib/tools/qdatetime.cpp @@ -2765,9 +2765,17 @@ QDateTime QDateTime::addMSecs(qint64 msecs) const /*! Returns the number of days from this datetime to the \a other - datetime. If the \a other datetime is earlier than this datetime, + datetime. The number of days is counted as the number of times + midnight is reached between this datetime to the \a other + datetime. This means that a 10 minute difference from 23:55 to + 0:05 the next day counts as one day. + + If the \a other datetime is earlier than this datetime, the value returned is negative. + Example: + \snippet code/src_corelib_tools_qdatetime.cpp 15 + \sa addDays(), secsTo(), msecsTo() */ |