AuroraMiddleware/qt5base-lts
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Clarify QDateTime documentation re timeSpec conversion.

Browse Source 
Clarify the documentation for setTimeSpec, toTimeSpec, toUTC and
toLocalTime, to be clear on which ones return the same point in time,
and which one simply changes the timezone.

Change-Id: Ic47dd8876ea733f1df0f64eca5bdf00d04f8d0d4
Reviewed-by: Thiago Macieira <thiago.macieira@intel.com>
This commit is contained in:
Mitch Curtis 2012-09-03 15:26:39 +02:00 committed by Qt by Nokia
parent c9819493d3
commit 1b4ab3764b
2 changed files with 52 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
src/corelib/doc/snippets/code/src_corelib_tools_qdatetime.cpp
View File

@ -156,4 +156,39 @@ 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]
//! [15]
//! [16]
QDateTime local(QDateTime::currentDateTime());
QDateTime UTC(local.toTimeSpec(Qt::UTC));
qDebug() << "Local time is:" << local;
qDebug() << "UTC time is:" << UTC;
qDebug() << "No difference between times:" << local.secsTo(UTC);
//! [16]
//! [17]
QDateTime UTC(QDateTime::currentDateTimeUtc());
QDateTime local(UTC.toLocalTime());
qDebug() << "UTC time is:" << UTC;
qDebug() << "Local time is:" << local;
qDebug() << "No difference between times:" << UTC.secsTo(local);
//! [17]
//! [18]
QDateTime local(QDateTime::currentDateTime());
QDateTime UTC(local.toUTC());
qDebug() << "Local time is:" << local;
qDebug() << "UTC time is:" << UTC;
qDebug() << "No difference between times:" << local.secsTo(UTC);
//! [18]
//! [19]
QDateTime local(QDateTime::currentDateTime());
qDebug() << "Local time is:" << local;
QDateTime UTC(local);
UTC.setTimeSpec(Qt::UTC);
qDebug() << "UTC time is:" << UTC;
qDebug() << "There are" << local.secsTo(UTC) << "seconds difference between the datetimes.";
//! [19]

17
src/corelib/tools/qdatetime.cpp
View File

@ -2322,6 +2322,10 @@ void QDateTime::setTime(const QTime &time)
/*!
Sets the time specification used in this datetime to \a spec.
The datetime will refer to a different point in time.
Example:
\snippet code/src_corelib_tools_qdatetime.cpp 19
\sa timeSpec(), setDate(), setTime(), Qt::TimeSpec
*/
@ -2856,9 +2860,12 @@ qint64 QDateTime::msecsTo(const QDateTime &other) const
/*!
\fn QDateTime QDateTime::toTimeSpec(Qt::TimeSpec specification) const
Returns a copy of this datetime configured to use the given time
Returns a copy of this datetime converted to the given time
\a specification.
Example:
\snippet code/src_corelib_tools_qdatetime.cpp 16
\sa timeSpec(), toUTC(), toLocalTime()
*/
@ -3570,6 +3577,10 @@ QDateTime QDateTime::fromString(const QString &string, const QString &format)
Returns a datetime containing the date and time information in
this datetime, but specified using the Qt::LocalTime definition.
Example:
\snippet code/src_corelib_tools_qdatetime.cpp 17
\sa toTimeSpec()
*/
@ -3579,6 +3590,10 @@ QDateTime QDateTime::fromString(const QString &string, const QString &format)
Returns a datetime containing the date and time information in
this datetime, but specified using the Qt::UTC definition.
Example:
\snippet code/src_corelib_tools_qdatetime.cpp 18
\sa toTimeSpec()
*/