| Absolute File Name: | /home/qt/qt5_coco/qt5/qtbase/src/corelib/tools/qtimezone.cpp |
| Source code | Switch to Preprocessed file |
| Line | Source | Count | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | /**************************************************************************** | - | ||||||||||||
| 2 | ** | - | ||||||||||||
| 3 | ** Copyright (C) 2013 John Layt <jlayt@kde.org> | - | ||||||||||||
| 4 | ** Contact: http://www.qt.io/licensing/ | - | ||||||||||||
| 5 | ** | - | ||||||||||||
| 6 | ** This file is part of the QtCore module of the Qt Toolkit. | - | ||||||||||||
| 7 | ** | - | ||||||||||||
| 8 | ** $QT_BEGIN_LICENSE:LGPL21$ | - | ||||||||||||
| 9 | ** Commercial License Usage | - | ||||||||||||
| 10 | ** Licensees holding valid commercial Qt licenses may use this file in | - | ||||||||||||
| 11 | ** accordance with the commercial license agreement provided with the | - | ||||||||||||
| 12 | ** Software or, alternatively, in accordance with the terms contained in | - | ||||||||||||
| 13 | ** a written agreement between you and The Qt Company. For licensing terms | - | ||||||||||||
| 14 | ** and conditions see http://www.qt.io/terms-conditions. For further | - | ||||||||||||
| 15 | ** information use the contact form at http://www.qt.io/contact-us. | - | ||||||||||||
| 16 | ** | - | ||||||||||||
| 17 | ** GNU Lesser General Public License Usage | - | ||||||||||||
| 18 | ** Alternatively, this file may be used under the terms of the GNU Lesser | - | ||||||||||||
| 19 | ** General Public License version 2.1 or version 3 as published by the Free | - | ||||||||||||
| 20 | ** Software Foundation and appearing in the file LICENSE.LGPLv21 and | - | ||||||||||||
| 21 | ** LICENSE.LGPLv3 included in the packaging of this file. Please review the | - | ||||||||||||
| 22 | ** following information to ensure the GNU Lesser General Public License | - | ||||||||||||
| 23 | ** requirements will be met: https://www.gnu.org/licenses/lgpl.html and | - | ||||||||||||
| 24 | ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. | - | ||||||||||||
| 25 | ** | - | ||||||||||||
| 26 | ** As a special exception, The Qt Company gives you certain additional | - | ||||||||||||
| 27 | ** rights. These rights are described in The Qt Company LGPL Exception | - | ||||||||||||
| 28 | ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. | - | ||||||||||||
| 29 | ** | - | ||||||||||||
| 30 | ** $QT_END_LICENSE$ | - | ||||||||||||
| 31 | ** | - | ||||||||||||
| 32 | ****************************************************************************/ | - | ||||||||||||
| 33 | - | |||||||||||||
| 34 | - | |||||||||||||
| 35 | #include "qtimezone.h" | - | ||||||||||||
| 36 | #include "qtimezoneprivate_p.h" | - | ||||||||||||
| 37 | - | |||||||||||||
| 38 | #include <QtCore/qdatastream.h> | - | ||||||||||||
| 39 | #include <QtCore/qdatetime.h> | - | ||||||||||||
| 40 | - | |||||||||||||
| 41 | #include <qdebug.h> | - | ||||||||||||
| 42 | - | |||||||||||||
| 43 | #include <algorithm> | - | ||||||||||||
| 44 | - | |||||||||||||
| 45 | QT_BEGIN_NAMESPACE | - | ||||||||||||
| 46 | - | |||||||||||||
| 47 | // Create default time zone using appropriate backend | - | ||||||||||||
| 48 | static QTimeZonePrivate *newBackendTimeZone() | - | ||||||||||||
| 49 | { | - | ||||||||||||
| 50 | #ifdef QT_NO_SYSTEMLOCALE | - | ||||||||||||
| 51 | #ifdef QT_USE_ICU | - | ||||||||||||
| 52 | return new QIcuTimeZonePrivate(); | - | ||||||||||||
| 53 | #else | - | ||||||||||||
| 54 | return new QUtcTimeZonePrivate(); | - | ||||||||||||
| 55 | #endif // QT_USE_ICU | - | ||||||||||||
| 56 | #else | - | ||||||||||||
| 57 | #if defined Q_OS_MAC | - | ||||||||||||
| 58 | return new QMacTimeZonePrivate(); | - | ||||||||||||
| 59 | #elif defined Q_OS_ANDROID | - | ||||||||||||
| 60 | return new QAndroidTimeZonePrivate(); | - | ||||||||||||
| 61 | #elif defined Q_OS_UNIX | - | ||||||||||||
| 62 | return new QTzTimeZonePrivate(); executed 1 time by 1 test: return new QTzTimeZonePrivate();Executed by:
| 1 | ||||||||||||
| 63 | // Registry based timezone backend not available on WinRT | - | ||||||||||||
| 64 | #elif defined Q_OS_WIN | - | ||||||||||||
| 65 | return new QWinTimeZonePrivate(); | - | ||||||||||||
| 66 | #elif defined QT_USE_ICU | - | ||||||||||||
| 67 | return new QIcuTimeZonePrivate(); | - | ||||||||||||
| 68 | #else | - | ||||||||||||
| 69 | return new QUtcTimeZonePrivate(); | - | ||||||||||||
| 70 | #endif // System Locales | - | ||||||||||||
| 71 | #endif // QT_NO_SYSTEMLOCALE | - | ||||||||||||
| 72 | } | - | ||||||||||||
| 73 | - | |||||||||||||
| 74 | // Create named time zone using appropriate backend | - | ||||||||||||
| 75 | static QTimeZonePrivate *newBackendTimeZone(const QByteArray &ianaId) | - | ||||||||||||
| 76 | { | - | ||||||||||||
| 77 | #ifdef QT_NO_SYSTEMLOCALE | - | ||||||||||||
| 78 | #ifdef QT_USE_ICU | - | ||||||||||||
| 79 | return new QIcuTimeZonePrivate(ianaId); | - | ||||||||||||
| 80 | #else | - | ||||||||||||
| 81 | return new QUtcTimeZonePrivate(ianaId); | - | ||||||||||||
| 82 | #endif // QT_USE_ICU | - | ||||||||||||
| 83 | #else | - | ||||||||||||
| 84 | #if defined Q_OS_MAC | - | ||||||||||||
| 85 | return new QMacTimeZonePrivate(ianaId); | - | ||||||||||||
| 86 | #elif defined Q_OS_ANDROID | - | ||||||||||||
| 87 | return new QAndroidTimeZonePrivate(ianaId); | - | ||||||||||||
| 88 | #elif defined Q_OS_UNIX | - | ||||||||||||
| 89 | return new QTzTimeZonePrivate(ianaId); executed 450 times by 2 tests: return new QTzTimeZonePrivate(ianaId);Executed by:
| 450 | ||||||||||||
| 90 | // Registry based timezone backend not available on WinRT | - | ||||||||||||
| 91 | #elif defined Q_OS_WIN | - | ||||||||||||
| 92 | return new QWinTimeZonePrivate(ianaId); | - | ||||||||||||
| 93 | #elif defined QT_USE_ICU | - | ||||||||||||
| 94 | return new QIcuTimeZonePrivate(ianaId); | - | ||||||||||||
| 95 | #else | - | ||||||||||||
| 96 | return new QUtcTimeZonePrivate(ianaId); | - | ||||||||||||
| 97 | #endif // System Locales | - | ||||||||||||
| 98 | #endif // QT_NO_SYSTEMLOCALE | - | ||||||||||||
| 99 | } | - | ||||||||||||
| 100 | - | |||||||||||||
| 101 | class QTimeZoneSingleton | - | ||||||||||||
| 102 | { | - | ||||||||||||
| 103 | public: | - | ||||||||||||
| 104 | QTimeZoneSingleton() : backend(newBackendTimeZone()) {} executed 1 time by 1 test: end of blockExecuted by:
| 1 | ||||||||||||
| 105 | - | |||||||||||||
| 106 | // The backend_tz is the tz to use in static methods such as availableTimeZoneIds() and | - | ||||||||||||
| 107 | // isTimeZoneIdAvailable() and to create named IANA time zones. This is usually the host | - | ||||||||||||
| 108 | // system, but may be different if the host resources are insufficient or if | - | ||||||||||||
| 109 | // QT_NO_SYSTEMLOCALE is set. A simple UTC backend is used if no alternative is available. | - | ||||||||||||
| 110 | QSharedDataPointer<QTimeZonePrivate> backend; | - | ||||||||||||
| 111 | }; | - | ||||||||||||
| 112 | - | |||||||||||||
| 113 | Q_GLOBAL_STATIC(QTimeZoneSingleton, global_tz); executed 1 time by 1 test: end of blockExecuted by:
executed 1 time by 1 test: guard.store(QtGlobalStatic::Destroyed);Executed by:
executed 468 times by 1 test: return &holder.value;Executed by:
| 0-468 | ||||||||||||
| 114 | - | |||||||||||||
| 115 | /*! | - | ||||||||||||
| 116 | \class QTimeZone | - | ||||||||||||
| 117 | \inmodule QtCore | - | ||||||||||||
| 118 | \since 5.2 | - | ||||||||||||
| 119 | - | |||||||||||||
| 120 | \brief The QTimeZone class converts between UTC and local time in a specific | - | ||||||||||||
| 121 | time zone. | - | ||||||||||||
| 122 | - | |||||||||||||
| 123 | \threadsafe | - | ||||||||||||
| 124 | - | |||||||||||||
| 125 | This class provides a stateless calculator for time zone conversions | - | ||||||||||||
| 126 | between UTC and the local time in a specific time zone. By default it uses | - | ||||||||||||
| 127 | the host system time zone data to perform these conversions. | - | ||||||||||||
| 128 | - | |||||||||||||
| 129 | This class is primarily designed for use in QDateTime; most applications | - | ||||||||||||
| 130 | will not need to access this class directly and should instead use | - | ||||||||||||
| 131 | QDateTime with a Qt::TimeSpec of Qt::TimeZone. | - | ||||||||||||
| 132 | - | |||||||||||||
| 133 | \note For consistency with QDateTime, QTimeZone does not account for leap | - | ||||||||||||
| 134 | seconds. | - | ||||||||||||
| 135 | - | |||||||||||||
| 136 | \section1 | - | ||||||||||||
| 137 | - | |||||||||||||
| 138 | \section2 IANA Time Zone IDs | - | ||||||||||||
| 139 | - | |||||||||||||
| 140 | QTimeZone uses the IANA time zone IDs as defined in the IANA Time Zone | - | ||||||||||||
| 141 | Database (http://www.iana.org/time-zones). This is to ensure a standard ID | - | ||||||||||||
| 142 | across all supported platforms. Most platforms support the IANA IDs | - | ||||||||||||
| 143 | and the IANA Database natively, but for Windows a mapping is required to | - | ||||||||||||
| 144 | the native IDs. See below for more details. | - | ||||||||||||
| 145 | - | |||||||||||||
| 146 | The IANA IDs can and do change on a regular basis, and can vary depending | - | ||||||||||||
| 147 | on how recently the host system data was updated. As such you cannot rely | - | ||||||||||||
| 148 | on any given ID existing on any host system. You must use | - | ||||||||||||
| 149 | availableTimeZoneIds() to determine what IANA IDs are available. | - | ||||||||||||
| 150 | - | |||||||||||||
| 151 | The IANA IDs and database are also know as the Olson IDs and database, | - | ||||||||||||
| 152 | named after their creator. | - | ||||||||||||
| 153 | - | |||||||||||||
| 154 | \section2 UTC Offset Time Zones | - | ||||||||||||
| 155 | - | |||||||||||||
| 156 | A default UTC time zone backend is provided which is always guaranteed to | - | ||||||||||||
| 157 | be available. This provides a set of generic Offset From UTC time zones | - | ||||||||||||
| 158 | in the range UTC-14:00 to UTC+14:00. These time zones can be created | - | ||||||||||||
| 159 | using either the standard ISO format names "UTC+00:00" as listed by | - | ||||||||||||
| 160 | availableTimeZoneIds(), or using the number of offset seconds. | - | ||||||||||||
| 161 | - | |||||||||||||
| 162 | \section2 Windows Time Zones | - | ||||||||||||
| 163 | - | |||||||||||||
| 164 | Windows native time zone support is severely limited compared to the | - | ||||||||||||
| 165 | standard IANA TZ Database. Windows time zones cover larger geographic | - | ||||||||||||
| 166 | areas and are thus less accurate in their conversions. They also do not | - | ||||||||||||
| 167 | support as much historic conversion data and so may only be accurate for | - | ||||||||||||
| 168 | the current year. | - | ||||||||||||
| 169 | - | |||||||||||||
| 170 | QTimeZone uses a conversion table derived form the Unicode CLDR data to map | - | ||||||||||||
| 171 | between IANA IDs and Windows IDs. Depending on your version of Windows | - | ||||||||||||
| 172 | and Qt, this table may not be able to provide a valid conversion, in which | - | ||||||||||||
| 173 | "UTC" will be returned. | - | ||||||||||||
| 174 | - | |||||||||||||
| 175 | QTimeZone provides a public API to use this conversion table. The Windows ID | - | ||||||||||||
| 176 | used is the Windows Registry Key for the time zone which is also the MS | - | ||||||||||||
| 177 | Exchange EWS ID as well, but is different to the Time Zone Name (TZID) and | - | ||||||||||||
| 178 | COD code used by MS Exchange in versions before 2007. | - | ||||||||||||
| 179 | - | |||||||||||||
| 180 | \section2 System Time Zone | - | ||||||||||||
| 181 | - | |||||||||||||
| 182 | QTimeZone does not support any concept of a system or default time zone. | - | ||||||||||||
| 183 | If you require a QDateTime that uses the current system time zone at any | - | ||||||||||||
| 184 | given moment then you should use a Qt::TimeSpec of Qt::LocalTime. | - | ||||||||||||
| 185 | - | |||||||||||||
| 186 | The method systemTimeZoneId() returns the current system IANA time zone | - | ||||||||||||
| 187 | ID which on Unix-like systems will always be correct. On Windows this ID is | - | ||||||||||||
| 188 | translated from the Windows system ID using an internal translation | - | ||||||||||||
| 189 | table and the user's selected country. As a consequence there is a small | - | ||||||||||||
| 190 | chance any Windows install may have IDs not known by Qt, in which case | - | ||||||||||||
| 191 | "UTC" will be returned. | - | ||||||||||||
| 192 | - | |||||||||||||
| 193 | Creating a new QTimeZone instance using the system time zone ID will only | - | ||||||||||||
| 194 | produce a fixed named copy of the time zone, it will not change if the | - | ||||||||||||
| 195 | system time zone changes. | - | ||||||||||||
| 196 | - | |||||||||||||
| 197 | \section2 Time Zone Offsets | - | ||||||||||||
| 198 | - | |||||||||||||
| 199 | The difference between UTC and the local time in a time zone is expressed | - | ||||||||||||
| 200 | as an offset in seconds from UTC, i.e. the number of seconds to add to UTC | - | ||||||||||||
| 201 | to obtain the local time. The total offset is comprised of two component | - | ||||||||||||
| 202 | parts, the standard time offset and the daylight-saving time offset. The | - | ||||||||||||
| 203 | standard time offset is the number of seconds to add to UTC to obtain | - | ||||||||||||
| 204 | standard time in the time zone. The daylight-saving time offset is the | - | ||||||||||||
| 205 | number of seconds to add to the standard time offset to obtain | - | ||||||||||||
| 206 | daylight-saving time (abbreviated DST and sometimes called "daylight time" | - | ||||||||||||
| 207 | or "summer time") in the time zone. | - | ||||||||||||
| 208 | - | |||||||||||||
| 209 | Note that the standard and DST offsets for a time zone may change over time | - | ||||||||||||
| 210 | as countries have changed DST laws or even their standard time offset. | - | ||||||||||||
| 211 | - | |||||||||||||
| 212 | \section2 License | - | ||||||||||||
| 213 | - | |||||||||||||
| 214 | This class includes data obtained from the CLDR data files under the terms | - | ||||||||||||
| 215 | of the Unicode license. | - | ||||||||||||
| 216 | - | |||||||||||||
| 217 | \legalese | - | ||||||||||||
| 218 | COPYRIGHT AND PERMISSION NOTICE | - | ||||||||||||
| 219 | - | |||||||||||||
| 220 | Copyright © 1991-2012 Unicode, Inc. All rights reserved. Distributed under | - | ||||||||||||
| 221 | the Terms of Use in http://www.unicode.org/copyright.html. | - | ||||||||||||
| 222 | - | |||||||||||||
| 223 | Permission is hereby granted, free of charge, to any person obtaining a | - | ||||||||||||
| 224 | copy of the Unicode data files and any associated documentation (the "Data | - | ||||||||||||
| 225 | Files") or Unicode software and any associated documentation (the "Software") | - | ||||||||||||
| 226 | to deal in the Data Files or Software without restriction, including without | - | ||||||||||||
| 227 | limitation the rights to use, copy, modify, merge, publish, distribute, and/or | - | ||||||||||||
| 228 | sell copies of the Data Files or Software, and to permit persons to whom the | - | ||||||||||||
| 229 | Data Files or Software are furnished to do so, provided that (a) the above | - | ||||||||||||
| 230 | copyright notice(s) and this permission notice appear with all copies of the | - | ||||||||||||
| 231 | Data Files or Software, (b) both the above copyright notice(s) and this | - | ||||||||||||
| 232 | permission notice appear in associated documentation, and (c) there is clear | - | ||||||||||||
| 233 | notice in each modified Data File or in the Software as well as in the | - | ||||||||||||
| 234 | documentation associated with the Data File(s) or Software that the data or | - | ||||||||||||
| 235 | software has been modified. | - | ||||||||||||
| 236 | \endlegalese | - | ||||||||||||
| 237 | - | |||||||||||||
| 238 | \sa QDateTime | - | ||||||||||||
| 239 | */ | - | ||||||||||||
| 240 | - | |||||||||||||
| 241 | /*! | - | ||||||||||||
| 242 | \enum QTimeZone::TimeType | - | ||||||||||||
| 243 | - | |||||||||||||
| 244 | The type of time zone time, for example when requesting the name. In time | - | ||||||||||||
| 245 | zones that do not apply DST, all three values may return the same result. | - | ||||||||||||
| 246 | - | |||||||||||||
| 247 | \value StandardTime | - | ||||||||||||
| 248 | The standard time in a time zone, i.e. when Daylight-Saving is not | - | ||||||||||||
| 249 | in effect. | - | ||||||||||||
| 250 | For example when formatting a display name this will show something | - | ||||||||||||
| 251 | like "Pacific Standard Time". | - | ||||||||||||
| 252 | \value DaylightTime | - | ||||||||||||
| 253 | A time when Daylight-Saving is in effect. | - | ||||||||||||
| 254 | For example when formatting a display name this will show something | - | ||||||||||||
| 255 | like "Pacific daylight-saving time". | - | ||||||||||||
| 256 | \value GenericTime | - | ||||||||||||
| 257 | A time which is not specifically Standard or Daylight-Saving time, | - | ||||||||||||
| 258 | either an unknown time or a neutral form. | - | ||||||||||||
| 259 | For example when formatting a display name this will show something | - | ||||||||||||
| 260 | like "Pacific Time". | - | ||||||||||||
| 261 | */ | - | ||||||||||||
| 262 | - | |||||||||||||
| 263 | /*! | - | ||||||||||||
| 264 | \enum QTimeZone::NameType | - | ||||||||||||
| 265 | - | |||||||||||||
| 266 | The type of time zone name. | - | ||||||||||||
| 267 | - | |||||||||||||
| 268 | \value DefaultName | - | ||||||||||||
| 269 | The default form of the time zone name, e.g. LongName, ShortName or OffsetName | - | ||||||||||||
| 270 | \value LongName | - | ||||||||||||
| 271 | The long form of the time zone name, e.g. "Central European Time" | - | ||||||||||||
| 272 | \value ShortName | - | ||||||||||||
| 273 | The short form of the time zone name, usually an abbreviation, e.g. "CET" | - | ||||||||||||
| 274 | \value OffsetName | - | ||||||||||||
| 275 | The standard ISO offset form of the time zone name, e.g. "UTC+01:00" | - | ||||||||||||
| 276 | */ | - | ||||||||||||
| 277 | - | |||||||||||||
| 278 | /*! | - | ||||||||||||
| 279 | \class QTimeZone::OffsetData | - | ||||||||||||
| 280 | \inmodule QtCore | - | ||||||||||||
| 281 | - | |||||||||||||
| 282 | The time zone offset data for a given moment in time, i.e. the time zone | - | ||||||||||||
| 283 | offsets and abbreviation to use at that moment in time. | - | ||||||||||||
| 284 | - | |||||||||||||
| 285 | \list | - | ||||||||||||
| 286 | \li OffsetData::atUtc The datetime of the offset data in UTC time. | - | ||||||||||||
| 287 | \li OffsetData::offsetFromUtc The total offset from UTC in effect at the datetime. | - | ||||||||||||
| 288 | \li OffsetData::standardTimeOffset The standard time offset component of the total offset. | - | ||||||||||||
| 289 | \li OffsetData::daylightTimeOffset The DST offset component of the total offset. | - | ||||||||||||
| 290 | \li OffsetData::abbreviation The abbreviation in effect at the datetime. | - | ||||||||||||
| 291 | \endlist | - | ||||||||||||
| 292 | - | |||||||||||||
| 293 | For example, for time zone "Europe/Berlin" the OffsetDate in standard and DST might be: | - | ||||||||||||
| 294 | - | |||||||||||||
| 295 | \list | - | ||||||||||||
| 296 | \li atUtc = QDateTime(QDate(2013, 1, 1), QTime(0, 0, 0), Qt::UTC) | - | ||||||||||||
| 297 | \li offsetFromUtc = 3600 | - | ||||||||||||
| 298 | \li standardTimeOffset = 3600 | - | ||||||||||||
| 299 | \li daylightTimeOffset = 0 | - | ||||||||||||
| 300 | \li abbreviation = "CET" | - | ||||||||||||
| 301 | \endlist | - | ||||||||||||
| 302 | - | |||||||||||||
| 303 | \list | - | ||||||||||||
| 304 | \li atUtc = QDateTime(QDate(2013, 6, 1), QTime(0, 0, 0), Qt::UTC) | - | ||||||||||||
| 305 | \li offsetFromUtc = 7200 | - | ||||||||||||
| 306 | \li standardTimeOffset = 3600 | - | ||||||||||||
| 307 | \li daylightTimeOffset = 3600 | - | ||||||||||||
| 308 | \li abbreviation = "CEST" | - | ||||||||||||
| 309 | \endlist | - | ||||||||||||
| 310 | */ | - | ||||||||||||
| 311 | - | |||||||||||||
| 312 | /*! | - | ||||||||||||
| 313 | \typedef QTimeZone::OffsetDataList | - | ||||||||||||
| 314 | - | |||||||||||||
| 315 | Synonym for QVector<OffsetData>. | - | ||||||||||||
| 316 | */ | - | ||||||||||||
| 317 | - | |||||||||||||
| 318 | /*! | - | ||||||||||||
| 319 | Create a null/invalid time zone instance. | - | ||||||||||||
| 320 | */ | - | ||||||||||||
| 321 | - | |||||||||||||
| 322 | QTimeZone::QTimeZone() | - | ||||||||||||
| 323 | : d(0) | - | ||||||||||||
| 324 | { | - | ||||||||||||
| 325 | } executed 14007651 times by 124 tests: end of blockExecuted by:
| 14007651 | ||||||||||||
| 326 | - | |||||||||||||
| 327 | /*! | - | ||||||||||||
| 328 | Creates an instance of the requested time zone \a ianaId. | - | ||||||||||||
| 329 | - | |||||||||||||
| 330 | The ID must be one of the available system IDs otherwise an invalid | - | ||||||||||||
| 331 | time zone will be returned. | - | ||||||||||||
| 332 | - | |||||||||||||
| 333 | \sa availableTimeZoneIds() | - | ||||||||||||
| 334 | */ | - | ||||||||||||
| 335 | - | |||||||||||||
| 336 | QTimeZone::QTimeZone(const QByteArray &ianaId) | - | ||||||||||||
| 337 | { | - | ||||||||||||
| 338 | // Try and see if it's a valid UTC offset ID, just as quick to try create as look-up | - | ||||||||||||
| 339 | d = new QUtcTimeZonePrivate(ianaId); | - | ||||||||||||
| 340 | // If not a valid UTC offset ID then try create it with the system backend | - | ||||||||||||
| 341 | // Relies on backend not creating valid tz with invalid name | - | ||||||||||||
| 342 | if (!d->isValid())
| 43-450 | ||||||||||||
| 343 | d = newBackendTimeZone(ianaId); executed 450 times by 2 tests: d = newBackendTimeZone(ianaId);Executed by:
| 450 | ||||||||||||
| 344 | } executed 493 times by 2 tests: end of blockExecuted by:
| 493 | ||||||||||||
| 345 | - | |||||||||||||
| 346 | /*! | - | ||||||||||||
| 347 | Creates an instance of a time zone with the requested Offset from UTC of | - | ||||||||||||
| 348 | \a offsetSeconds. | - | ||||||||||||
| 349 | - | |||||||||||||
| 350 | The \a offsetSeconds from UTC must be in the range -14 hours to +14 hours | - | ||||||||||||
| 351 | otherwise an invalid time zone will be returned. | - | ||||||||||||
| 352 | */ | - | ||||||||||||
| 353 | - | |||||||||||||
| 354 | QTimeZone::QTimeZone(int offsetSeconds) | - | ||||||||||||
| 355 | { | - | ||||||||||||
| 356 | // offsetSeconds must fall between -14:00 and +14:00 hours | - | ||||||||||||
| 357 | if (offsetSeconds >= -50400 && offsetSeconds <= 50400)
| 1-8 | ||||||||||||
| 358 | d = new QUtcTimeZonePrivate(offsetSeconds); executed 7 times by 2 tests: d = new QUtcTimeZonePrivate(offsetSeconds);Executed by:
| 7 | ||||||||||||
| 359 | else | - | ||||||||||||
| 360 | d = 0; executed 2 times by 1 test: d = 0;Executed by:
| 2 | ||||||||||||
| 361 | } | - | ||||||||||||
| 362 | - | |||||||||||||
| 363 | /*! | - | ||||||||||||
| 364 | Creates a custom time zone with an ID of \a ianaId and an offset from UTC | - | ||||||||||||
| 365 | of \a offsetSeconds. The \a name will be the name used by displayName() | - | ||||||||||||
| 366 | for the LongName, the \a abbreviation will be used by displayName() for the | - | ||||||||||||
| 367 | ShortName and by abbreviation(), and the optional \a country will be used | - | ||||||||||||
| 368 | by country(). The \a comment is an optional note that may be displayed in | - | ||||||||||||
| 369 | a GUI to assist users in selecting a time zone. | - | ||||||||||||
| 370 | - | |||||||||||||
| 371 | The \a ianaId must not be one of the available system IDs returned by | - | ||||||||||||
| 372 | availableTimeZoneIds(). The \a offsetSeconds from UTC must be in the range | - | ||||||||||||
| 373 | -14 hours to +14 hours. | - | ||||||||||||
| 374 | - | |||||||||||||
| 375 | If the custom time zone does not have a specific country then set it to the | - | ||||||||||||
| 376 | default value of QLocale::AnyCountry. | - | ||||||||||||
| 377 | */ | - | ||||||||||||
| 378 | - | |||||||||||||
| 379 | QTimeZone::QTimeZone(const QByteArray &ianaId, int offsetSeconds, const QString &name, | - | ||||||||||||
| 380 | const QString &abbreviation, QLocale::Country country, const QString &comment) | - | ||||||||||||
| 381 | : d() | - | ||||||||||||
| 382 | { | - | ||||||||||||
| 383 | if (!isTimeZoneIdAvailable(ianaId))
| 0-3 | ||||||||||||
| 384 | d = new QUtcTimeZonePrivate(ianaId, offsetSeconds, name, abbreviation, country, comment); executed 3 times by 1 test: d = new QUtcTimeZonePrivate(ianaId, offsetSeconds, name, abbreviation, country, comment);Executed by:
| 3 | ||||||||||||
| 385 | } executed 3 times by 1 test: end of blockExecuted by:
| 3 | ||||||||||||
| 386 | - | |||||||||||||
| 387 | /*! | - | ||||||||||||
| 388 | \internal | - | ||||||||||||
| 389 | - | |||||||||||||
| 390 | Private. Create time zone with given private backend | - | ||||||||||||
| 391 | */ | - | ||||||||||||
| 392 | - | |||||||||||||
| 393 | QTimeZone::QTimeZone(QTimeZonePrivate &dd) | - | ||||||||||||
| 394 | : d(&dd) | - | ||||||||||||
| 395 | { | - | ||||||||||||
| 396 | } never executed: end of block | 0 | ||||||||||||
| 397 | - | |||||||||||||
| 398 | /*! | - | ||||||||||||
| 399 | Copy constructor, copy \a other to this. | - | ||||||||||||
| 400 | */ | - | ||||||||||||
| 401 | - | |||||||||||||
| 402 | QTimeZone::QTimeZone(const QTimeZone &other) | - | ||||||||||||
| 403 | : d(other.d) | - | ||||||||||||
| 404 | { | - | ||||||||||||
| 405 | } executed 48396 times by 20 tests: end of blockExecuted by:
| 48396 | ||||||||||||
| 406 | - | |||||||||||||
| 407 | /*! | - | ||||||||||||
| 408 | Destroys the time zone. | - | ||||||||||||
| 409 | */ | - | ||||||||||||
| 410 | - | |||||||||||||
| 411 | QTimeZone::~QTimeZone() | - | ||||||||||||
| 412 | { | - | ||||||||||||
| 413 | } | - | ||||||||||||
| 414 | - | |||||||||||||
| 415 | /*! | - | ||||||||||||
| 416 | \fn QTimeZone::swap(QTimeZone &other) | - | ||||||||||||
| 417 | - | |||||||||||||
| 418 | Swaps this time zone instance with \a other. This function is very | - | ||||||||||||
| 419 | fast and never fails. | - | ||||||||||||
| 420 | */ | - | ||||||||||||
| 421 | - | |||||||||||||
| 422 | /*! | - | ||||||||||||
| 423 | Assignment operator, assign \a other to this. | - | ||||||||||||
| 424 | */ | - | ||||||||||||
| 425 | - | |||||||||||||
| 426 | QTimeZone &QTimeZone::operator=(const QTimeZone &other) | - | ||||||||||||
| 427 | { | - | ||||||||||||
| 428 | d = other.d; | - | ||||||||||||
| 429 | return *this; executed 484 times by 2 tests: return *this;Executed by:
| 484 | ||||||||||||
| 430 | } | - | ||||||||||||
| 431 | - | |||||||||||||
| 432 | /* | - | ||||||||||||
| 433 | \fn void QTimeZone::swap(QTimeZone &other) | - | ||||||||||||
| 434 | - | |||||||||||||
| 435 | Swaps this timezone with \a other. This function is very fast and | - | ||||||||||||
| 436 | never fails. | - | ||||||||||||
| 437 | */ | - | ||||||||||||
| 438 | - | |||||||||||||
| 439 | /*! | - | ||||||||||||
| 440 | \fn QTimeZone &QTimeZone::operator=(QTimeZone &&other) | - | ||||||||||||
| 441 | - | |||||||||||||
| 442 | Move-assigns \a other to this QTimeZone instance, transferring the | - | ||||||||||||
| 443 | ownership of the managed pointer to this instance. | - | ||||||||||||
| 444 | */ | - | ||||||||||||
| 445 | - | |||||||||||||
| 446 | /*! | - | ||||||||||||
| 447 | Returns \c true if this time zone is equal to the \a other time zone. | - | ||||||||||||
| 448 | */ | - | ||||||||||||
| 449 | - | |||||||||||||
| 450 | bool QTimeZone::operator==(const QTimeZone &other) const | - | ||||||||||||
| 451 | { | - | ||||||||||||
| 452 | if (d && other.d) | - | ||||||||||||
| 453 | return (*d == *other.d); executed 19 times by 2 tests: return (*d == *other.d);Executed by:
| 19 | ||||||||||||
| 454 | else | - | ||||||||||||
| 455 | return (d == other.d); executed 2 times by 1 test: return (d == other.d);Executed by:
| 2 | ||||||||||||
| 456 | } | - | ||||||||||||
| 457 | - | |||||||||||||
| 458 | /*! | - | ||||||||||||
| 459 | Returns \c true if this time zone is not equal to the \a other time zone. | - | ||||||||||||
| 460 | */ | - | ||||||||||||
| 461 | - | |||||||||||||
| 462 | bool QTimeZone::operator!=(const QTimeZone &other) const | - | ||||||||||||
| 463 | { | - | ||||||||||||
| 464 | if (d && other.d) | - | ||||||||||||
| 465 | return (*d != *other.d); executed 2 times by 1 test: return (*d != *other.d);Executed by:
| 2 | ||||||||||||
| 466 | else | - | ||||||||||||
| 467 | return (d != other.d); executed 2 times by 1 test: return (d != other.d);Executed by:
| 2 | ||||||||||||
| 468 | } | - | ||||||||||||
| 469 | - | |||||||||||||
| 470 | /*! | - | ||||||||||||
| 471 | Returns \c true if this time zone is valid. | - | ||||||||||||
| 472 | */ | - | ||||||||||||
| 473 | - | |||||||||||||
| 474 | bool QTimeZone::isValid() const | - | ||||||||||||
| 475 | { | - | ||||||||||||
| 476 | if (d)
| 23-11616 | ||||||||||||
| 477 | return d->isValid(); executed 11616 times by 2 tests: return d->isValid();Executed by:
| 11616 | ||||||||||||
| 478 | else | - | ||||||||||||
| 479 | return false; executed 23 times by 1 test: return false;Executed by:
| 23 | ||||||||||||
| 480 | } | - | ||||||||||||
| 481 | - | |||||||||||||
| 482 | /*! | - | ||||||||||||
| 483 | Returns the IANA ID for the time zone. | - | ||||||||||||
| 484 | - | |||||||||||||
| 485 | IANA IDs are used on all platforms. On Windows these are translated | - | ||||||||||||
| 486 | from the Windows ID into the closest IANA ID for the time zone and country. | - | ||||||||||||
| 487 | */ | - | ||||||||||||
| 488 | - | |||||||||||||
| 489 | QByteArray QTimeZone::id() const | - | ||||||||||||
| 490 | { | - | ||||||||||||
| 491 | if (d)
| 1-468 | ||||||||||||
| 492 | return d->id(); executed 468 times by 2 tests: return d->id();Executed by:
| 468 | ||||||||||||
| 493 | else | - | ||||||||||||
| 494 | return QByteArray(); executed 1 time by 1 test: return QByteArray();Executed by:
| 1 | ||||||||||||
| 495 | } | - | ||||||||||||
| 496 | - | |||||||||||||
| 497 | /*! | - | ||||||||||||
| 498 | Returns the country for the time zone. | - | ||||||||||||
| 499 | */ | - | ||||||||||||
| 500 | - | |||||||||||||
| 501 | QLocale::Country QTimeZone::country() const | - | ||||||||||||
| 502 | { | - | ||||||||||||
| 503 | if (isValid())
| 1-463 | ||||||||||||
| 504 | return d->country(); executed 463 times by 1 test: return d->country();Executed by:
| 463 | ||||||||||||
| 505 | else | - | ||||||||||||
| 506 | return QLocale::AnyCountry; executed 1 time by 1 test: return QLocale::AnyCountry;Executed by:
| 1 | ||||||||||||
| 507 | } | - | ||||||||||||
| 508 | - | |||||||||||||
| 509 | /*! | - | ||||||||||||
| 510 | Returns any comment for the time zone. | - | ||||||||||||
| 511 | - | |||||||||||||
| 512 | A comment may be provided by the host platform to assist users in | - | ||||||||||||
| 513 | choosing the correct time zone. Depending on the platform this may not | - | ||||||||||||
| 514 | be localized. | - | ||||||||||||
| 515 | */ | - | ||||||||||||
| 516 | - | |||||||||||||
| 517 | QString QTimeZone::comment() const | - | ||||||||||||
| 518 | { | - | ||||||||||||
| 519 | if (isValid())
| 1-462 | ||||||||||||
| 520 | return d->comment(); executed 462 times by 1 test: return d->comment();Executed by:
| 462 | ||||||||||||
| 521 | else | - | ||||||||||||
| 522 | return QString(); executed 1 time by 1 test: return QString();Executed by:
| 1 | ||||||||||||
| 523 | } | - | ||||||||||||
| 524 | - | |||||||||||||
| 525 | /*! | - | ||||||||||||
| 526 | Returns the localized time zone display name at the given \a atDateTime | - | ||||||||||||
| 527 | for the given \a nameType in the given \a locale. The \a nameType and | - | ||||||||||||
| 528 | \a locale requested may not be supported on all platforms, in which case | - | ||||||||||||
| 529 | the best available option will be returned. | - | ||||||||||||
| 530 | - | |||||||||||||
| 531 | If the \a locale is not provided then the application default locale will | - | ||||||||||||
| 532 | be used. | - | ||||||||||||
| 533 | - | |||||||||||||
| 534 | The display name may change depending on DST or historical events. | - | ||||||||||||
| 535 | - | |||||||||||||
| 536 | \sa abbreviation() | - | ||||||||||||
| 537 | */ | - | ||||||||||||
| 538 | - | |||||||||||||
| 539 | QString QTimeZone::displayName(const QDateTime &atDateTime, NameType nameType, | - | ||||||||||||
| 540 | const QLocale &locale) const | - | ||||||||||||
| 541 | { | - | ||||||||||||
| 542 | if (isValid())
| 1-460 | ||||||||||||
| 543 | return d->displayName(atDateTime.toMSecsSinceEpoch(), nameType, locale); executed 460 times by 1 test: return d->displayName(atDateTime.toMSecsSinceEpoch(), nameType, locale);Executed by:
| 460 | ||||||||||||
| 544 | else | - | ||||||||||||
| 545 | return QString(); executed 1 time by 1 test: return QString();Executed by:
| 1 | ||||||||||||
| 546 | } | - | ||||||||||||
| 547 | - | |||||||||||||
| 548 | /*! | - | ||||||||||||
| 549 | Returns the localized time zone display name for the given \a timeType | - | ||||||||||||
| 550 | and \a nameType in the given \a locale. The \a nameType and \a locale | - | ||||||||||||
| 551 | requested may not be supported on all platforms, in which case the best | - | ||||||||||||
| 552 | available option will be returned. | - | ||||||||||||
| 553 | - | |||||||||||||
| 554 | If the \a locale is not provided then the application default locale will | - | ||||||||||||
| 555 | be used. | - | ||||||||||||
| 556 | - | |||||||||||||
| 557 | Where the time zone display names have changed over time then the most | - | ||||||||||||
| 558 | recent names will be used. | - | ||||||||||||
| 559 | - | |||||||||||||
| 560 | \sa abbreviation() | - | ||||||||||||
| 561 | */ | - | ||||||||||||
| 562 | - | |||||||||||||
| 563 | QString QTimeZone::displayName(TimeType timeType, NameType nameType, | - | ||||||||||||
| 564 | const QLocale &locale) const | - | ||||||||||||
| 565 | { | - | ||||||||||||
| 566 | if (isValid())
| 1-923 | ||||||||||||
| 567 | return d->displayName(timeType, nameType, locale); executed 923 times by 1 test: return d->displayName(timeType, nameType, locale);Executed by:
| 923 | ||||||||||||
| 568 | else | - | ||||||||||||
| 569 | return QString(); executed 1 time by 1 test: return QString();Executed by:
| 1 | ||||||||||||
| 570 | } | - | ||||||||||||
| 571 | - | |||||||||||||
| 572 | /*! | - | ||||||||||||
| 573 | Returns the time zone abbreviation at the given \a atDateTime. The | - | ||||||||||||
| 574 | abbreviation may change depending on DST or even historical events. | - | ||||||||||||
| 575 | - | |||||||||||||
| 576 | Note that the abbreviation is not guaranteed to be unique to this time zone | - | ||||||||||||
| 577 | and should not be used in place of the ID or display name. | - | ||||||||||||
| 578 | - | |||||||||||||
| 579 | \sa displayName() | - | ||||||||||||
| 580 | */ | - | ||||||||||||
| 581 | - | |||||||||||||
| 582 | QString QTimeZone::abbreviation(const QDateTime &atDateTime) const | - | ||||||||||||
| 583 | { | - | ||||||||||||
| 584 | if (isValid())
| 1-462 | ||||||||||||
| 585 | return d->abbreviation(atDateTime.toMSecsSinceEpoch()); executed 462 times by 1 test: return d->abbreviation(atDateTime.toMSecsSinceEpoch());Executed by:
| 462 | ||||||||||||
| 586 | else | - | ||||||||||||
| 587 | return QString(); executed 1 time by 1 test: return QString();Executed by:
| 1 | ||||||||||||
| 588 | } | - | ||||||||||||
| 589 | - | |||||||||||||
| 590 | /*! | - | ||||||||||||
| 591 | Returns the total effective offset at the given \a atDateTime, i.e. the | - | ||||||||||||
| 592 | number of seconds to add to UTC to obtain the local time. This includes | - | ||||||||||||
| 593 | any DST offset that may be in effect, i.e. it is the sum of | - | ||||||||||||
| 594 | standardTimeOffset() and daylightTimeOffset() for the given datetime. | - | ||||||||||||
| 595 | - | |||||||||||||
| 596 | For example, for the time zone "Europe/Berlin" the standard time offset is | - | ||||||||||||
| 597 | +3600 seconds and the DST offset is +3600 seconds. During standard time | - | ||||||||||||
| 598 | offsetFromUtc() will return +3600 (UTC+01:00), and during DST it will | - | ||||||||||||
| 599 | return +7200 (UTC+02:00). | - | ||||||||||||
| 600 | - | |||||||||||||
| 601 | \sa standardTimeOffset(), daylightTimeOffset() | - | ||||||||||||
| 602 | */ | - | ||||||||||||
| 603 | - | |||||||||||||
| 604 | int QTimeZone::offsetFromUtc(const QDateTime &atDateTime) const | - | ||||||||||||
| 605 | { | - | ||||||||||||
| 606 | if (isValid())
| 2-466 | ||||||||||||
| 607 | return d->offsetFromUtc(atDateTime.toMSecsSinceEpoch()); executed 466 times by 1 test: return d->offsetFromUtc(atDateTime.toMSecsSinceEpoch());Executed by:
| 466 | ||||||||||||
| 608 | else | - | ||||||||||||
| 609 | return 0; executed 2 times by 1 test: return 0;Executed by:
| 2 | ||||||||||||
| 610 | } | - | ||||||||||||
| 611 | - | |||||||||||||
| 612 | /*! | - | ||||||||||||
| 613 | Returns the standard time offset at the given \a atDateTime, i.e. the | - | ||||||||||||
| 614 | number of seconds to add to UTC to obtain the local Standard Time. This | - | ||||||||||||
| 615 | excludes any DST offset that may be in effect. | - | ||||||||||||
| 616 | - | |||||||||||||
| 617 | For example, for the time zone "Europe/Berlin" the standard time offset is | - | ||||||||||||
| 618 | +3600 seconds. During both standard and DST offsetFromUtc() will return | - | ||||||||||||
| 619 | +3600 (UTC+01:00). | - | ||||||||||||
| 620 | - | |||||||||||||
| 621 | \sa offsetFromUtc(), daylightTimeOffset() | - | ||||||||||||
| 622 | */ | - | ||||||||||||
| 623 | - | |||||||||||||
| 624 | int QTimeZone::standardTimeOffset(const QDateTime &atDateTime) const | - | ||||||||||||
| 625 | { | - | ||||||||||||
| 626 | if (isValid())
| 2-465 | ||||||||||||
| 627 | return d->standardTimeOffset(atDateTime.toMSecsSinceEpoch()); executed 465 times by 1 test: return d->standardTimeOffset(atDateTime.toMSecsSinceEpoch());Executed by:
| 465 | ||||||||||||
| 628 | else | - | ||||||||||||
| 629 | return 0; executed 2 times by 1 test: return 0;Executed by:
| 2 | ||||||||||||
| 630 | } | - | ||||||||||||
| 631 | - | |||||||||||||
| 632 | /*! | - | ||||||||||||
| 633 | Returns the daylight-saving time offset at the given \a atDateTime, | - | ||||||||||||
| 634 | i.e. the number of seconds to add to the standard time offset to obtain the | - | ||||||||||||
| 635 | local daylight-saving time. | - | ||||||||||||
| 636 | - | |||||||||||||
| 637 | For example, for the time zone "Europe/Berlin" the DST offset is +3600 | - | ||||||||||||
| 638 | seconds. During standard time daylightTimeOffset() will return 0, and when | - | ||||||||||||
| 639 | daylight-saving is in effect it will return +3600. | - | ||||||||||||
| 640 | - | |||||||||||||
| 641 | \sa offsetFromUtc(), standardTimeOffset() | - | ||||||||||||
| 642 | */ | - | ||||||||||||
| 643 | - | |||||||||||||
| 644 | int QTimeZone::daylightTimeOffset(const QDateTime &atDateTime) const | - | ||||||||||||
| 645 | { | - | ||||||||||||
| 646 | if (hasDaylightTime())
| 176-291 | ||||||||||||
| 647 | return d->daylightTimeOffset(atDateTime.toMSecsSinceEpoch()); executed 291 times by 1 test: return d->daylightTimeOffset(atDateTime.toMSecsSinceEpoch());Executed by:
| 291 | ||||||||||||
| 648 | else | - | ||||||||||||
| 649 | return 0; executed 176 times by 1 test: return 0;Executed by:
| 176 | ||||||||||||
| 650 | } | - | ||||||||||||
| 651 | - | |||||||||||||
| 652 | /*! | - | ||||||||||||
| 653 | Returns \c true if the time zone has practiced daylight-saving at any time. | - | ||||||||||||
| 654 | - | |||||||||||||
| 655 | \sa isDaylightTime(), daylightTimeOffset() | - | ||||||||||||
| 656 | */ | - | ||||||||||||
| 657 | - | |||||||||||||
| 658 | bool QTimeZone::hasDaylightTime() const | - | ||||||||||||
| 659 | { | - | ||||||||||||
| 660 | if (isValid())
| 5-1388 | ||||||||||||
| 661 | return d->hasDaylightTime(); executed 1388 times by 1 test: return d->hasDaylightTime();Executed by:
| 1388 | ||||||||||||
| 662 | else | - | ||||||||||||
| 663 | return false; executed 5 times by 1 test: return false;Executed by:
| 5 | ||||||||||||
| 664 | } | - | ||||||||||||
| 665 | - | |||||||||||||
| 666 | /*! | - | ||||||||||||
| 667 | Returns \c true if daylight-saving was in effect at the given \a atDateTime. | - | ||||||||||||
| 668 | - | |||||||||||||
| 669 | \sa hasDaylightTime(), daylightTimeOffset() | - | ||||||||||||
| 670 | */ | - | ||||||||||||
| 671 | - | |||||||||||||
| 672 | bool QTimeZone::isDaylightTime(const QDateTime &atDateTime) const | - | ||||||||||||
| 673 | { | - | ||||||||||||
| 674 | if (hasDaylightTime())
| 173-291 | ||||||||||||
| 675 | return d->isDaylightTime(atDateTime.toMSecsSinceEpoch()); executed 291 times by 1 test: return d->isDaylightTime(atDateTime.toMSecsSinceEpoch());Executed by:
| 291 | ||||||||||||
| 676 | else | - | ||||||||||||
| 677 | return false; executed 173 times by 1 test: return false;Executed by:
| 173 | ||||||||||||
| 678 | } | - | ||||||||||||
| 679 | - | |||||||||||||
| 680 | /*! | - | ||||||||||||
| 681 | Returns the effective offset details at the given \a forDateTime. This is | - | ||||||||||||
| 682 | the equivalent of calling offsetFromUtc(), abbreviation(), etc individually but is | - | ||||||||||||
| 683 | more efficient. | - | ||||||||||||
| 684 | - | |||||||||||||
| 685 | \sa offsetFromUtc(), standardTimeOffset(), daylightTimeOffset(), abbreviation() | - | ||||||||||||
| 686 | */ | - | ||||||||||||
| 687 | - | |||||||||||||
| 688 | QTimeZone::OffsetData QTimeZone::offsetData(const QDateTime &forDateTime) const | - | ||||||||||||
| 689 | { | - | ||||||||||||
| 690 | if (hasTransitions())
| 40-421 | ||||||||||||
| 691 | return QTimeZonePrivate::toOffsetData(d->data(forDateTime.toMSecsSinceEpoch())); executed 421 times by 1 test: return QTimeZonePrivate::toOffsetData(d->data(forDateTime.toMSecsSinceEpoch()));Executed by:
| 421 | ||||||||||||
| 692 | else | - | ||||||||||||
| 693 | return QTimeZonePrivate::invalidOffsetData(); executed 40 times by 1 test: return QTimeZonePrivate::invalidOffsetData();Executed by:
| 40 | ||||||||||||
| 694 | } | - | ||||||||||||
| 695 | - | |||||||||||||
| 696 | /*! | - | ||||||||||||
| 697 | Returns \c true if the system backend supports obtaining transitions. | - | ||||||||||||
| 698 | - | |||||||||||||
| 699 | Transitions are changes in the time-zone: these happen when DST turns on or | - | ||||||||||||
| 700 | off and when authorities alter the offsets for the time-zone. | - | ||||||||||||
| 701 | - | |||||||||||||
| 702 | \sa nextTransition(), previousTransition(), transitions() | - | ||||||||||||
| 703 | */ | - | ||||||||||||
| 704 | - | |||||||||||||
| 705 | bool QTimeZone::hasTransitions() const | - | ||||||||||||
| 706 | { | - | ||||||||||||
| 707 | if (isValid())
| 4-5526 | ||||||||||||
| 708 | return d->hasTransitions(); executed 5526 times by 1 test: return d->hasTransitions();Executed by:
| 5526 | ||||||||||||
| 709 | else | - | ||||||||||||
| 710 | return false; executed 4 times by 1 test: return false;Executed by:
| 4 | ||||||||||||
| 711 | } | - | ||||||||||||
| 712 | - | |||||||||||||
| 713 | /*! | - | ||||||||||||
| 714 | Returns the first time zone Transition after the given \a afterDateTime. | - | ||||||||||||
| 715 | This is most useful when you have a Transition time and wish to find the | - | ||||||||||||
| 716 | Transition after it. | - | ||||||||||||
| 717 | - | |||||||||||||
| 718 | If there is no transition after the given \a afterDateTime then an invalid | - | ||||||||||||
| 719 | OffsetData will be returned with an invalid QDateTime. | - | ||||||||||||
| 720 | - | |||||||||||||
| 721 | The given \a afterDateTime is exclusive. | - | ||||||||||||
| 722 | - | |||||||||||||
| 723 | \sa hasTransitions(), previousTransition(), transitions() | - | ||||||||||||
| 724 | */ | - | ||||||||||||
| 725 | - | |||||||||||||
| 726 | QTimeZone::OffsetData QTimeZone::nextTransition(const QDateTime &afterDateTime) const | - | ||||||||||||
| 727 | { | - | ||||||||||||
| 728 | if (hasTransitions())
| 196-2107 | ||||||||||||
| 729 | return QTimeZonePrivate::toOffsetData(d->nextTransition(afterDateTime.toMSecsSinceEpoch())); executed 2107 times by 1 test: return QTimeZonePrivate::toOffsetData(d->nextTransition(afterDateTime.toMSecsSinceEpoch()));Executed by:
| 2107 | ||||||||||||
| 730 | else | - | ||||||||||||
| 731 | return QTimeZonePrivate::invalidOffsetData(); executed 196 times by 1 test: return QTimeZonePrivate::invalidOffsetData();Executed by:
| 196 | ||||||||||||
| 732 | } | - | ||||||||||||
| 733 | - | |||||||||||||
| 734 | /*! | - | ||||||||||||
| 735 | Returns the first time zone Transition before the given \a beforeDateTime. | - | ||||||||||||
| 736 | This is most useful when you have a Transition time and wish to find the | - | ||||||||||||
| 737 | Transition before it. | - | ||||||||||||
| 738 | - | |||||||||||||
| 739 | If there is no transition before the given \a beforeDateTime then an invalid | - | ||||||||||||
| 740 | OffsetData will be returned with an invalid QDateTime. | - | ||||||||||||
| 741 | - | |||||||||||||
| 742 | The given \a beforeDateTime is exclusive. | - | ||||||||||||
| 743 | - | |||||||||||||
| 744 | \sa hasTransitions(), nextTransition(), transitions() | - | ||||||||||||
| 745 | */ | - | ||||||||||||
| 746 | - | |||||||||||||
| 747 | QTimeZone::OffsetData QTimeZone::previousTransition(const QDateTime &beforeDateTime) const | - | ||||||||||||
| 748 | { | - | ||||||||||||
| 749 | if (hasTransitions())
| 196-2107 | ||||||||||||
| 750 | return QTimeZonePrivate::toOffsetData(d->previousTransition(beforeDateTime.toMSecsSinceEpoch())); executed 2107 times by 1 test: return QTimeZonePrivate::toOffsetData(d->previousTransition(beforeDateTime.toMSecsSinceEpoch()));Executed by:
| 2107 | ||||||||||||
| 751 | else | - | ||||||||||||
| 752 | return QTimeZonePrivate::invalidOffsetData(); executed 196 times by 1 test: return QTimeZonePrivate::invalidOffsetData();Executed by:
| 196 | ||||||||||||
| 753 | } | - | ||||||||||||
| 754 | - | |||||||||||||
| 755 | /*! | - | ||||||||||||
| 756 | Returns a list of all time zone transitions between the given datetimes. | - | ||||||||||||
| 757 | - | |||||||||||||
| 758 | The given \a fromDateTime and \a toDateTime are inclusive. | - | ||||||||||||
| 759 | - | |||||||||||||
| 760 | \sa hasTransitions(), nextTransition(), previousTransition() | - | ||||||||||||
| 761 | */ | - | ||||||||||||
| 762 | - | |||||||||||||
| 763 | QTimeZone::OffsetDataList QTimeZone::transitions(const QDateTime &fromDateTime, | - | ||||||||||||
| 764 | const QDateTime &toDateTime) const | - | ||||||||||||
| 765 | { | - | ||||||||||||
| 766 | OffsetDataList list; | - | ||||||||||||
| 767 | if (hasTransitions()) {
| 0-1 | ||||||||||||
| 768 | QTimeZonePrivate::DataList plist = d->transitions(fromDateTime.toMSecsSinceEpoch(), | - | ||||||||||||
| 769 | toDateTime.toMSecsSinceEpoch()); | - | ||||||||||||
| 770 | list.reserve(plist.count()); | - | ||||||||||||
| 771 | foreach (const QTimeZonePrivate::Data &pdata, plist) | - | ||||||||||||
| 772 | list.append(QTimeZonePrivate::toOffsetData(pdata)); executed 2 times by 1 test: list.append(QTimeZonePrivate::toOffsetData(pdata));Executed by:
| 2 | ||||||||||||
| 773 | } executed 1 time by 1 test: end of blockExecuted by:
| 1 | ||||||||||||
| 774 | return list; executed 1 time by 1 test: return list;Executed by:
| 1 | ||||||||||||
| 775 | } | - | ||||||||||||
| 776 | - | |||||||||||||
| 777 | // Static methods | - | ||||||||||||
| 778 | - | |||||||||||||
| 779 | /*! | - | ||||||||||||
| 780 | Returns the current system time zone IANA ID. | - | ||||||||||||
| 781 | - | |||||||||||||
| 782 | On Windows this ID is translated from the Windows ID using an internal | - | ||||||||||||
| 783 | translation table and the user's selected country. As a consequence there | - | ||||||||||||
| 784 | is a small chance any Windows install may have IDs not known by Qt, in | - | ||||||||||||
| 785 | which case "UTC" will be returned. | - | ||||||||||||
| 786 | */ | - | ||||||||||||
| 787 | - | |||||||||||||
| 788 | QByteArray QTimeZone::systemTimeZoneId() | - | ||||||||||||
| 789 | { | - | ||||||||||||
| 790 | return global_tz->backend->systemTimeZoneId(); never executed: return global_tz->backend->systemTimeZoneId(); | 0 | ||||||||||||
| 791 | } | - | ||||||||||||
| 792 | - | |||||||||||||
| 793 | /*! | - | ||||||||||||
| 794 | \since 5.5 | - | ||||||||||||
| 795 | Returns a QTimeZone object that refers to the local system time, as | - | ||||||||||||
| 796 | specified by systemTimeZoneId(). | - | ||||||||||||
| 797 | - | |||||||||||||
| 798 | \sa utc() | - | ||||||||||||
| 799 | */ | - | ||||||||||||
| 800 | QTimeZone QTimeZone::systemTimeZone() | - | ||||||||||||
| 801 | { | - | ||||||||||||
| 802 | return QTimeZone(QTimeZone::systemTimeZoneId()); never executed: return QTimeZone(QTimeZone::systemTimeZoneId()); | 0 | ||||||||||||
| 803 | } | - | ||||||||||||
| 804 | - | |||||||||||||
| 805 | /*! | - | ||||||||||||
| 806 | \since 5.5 | - | ||||||||||||
| 807 | Returns a QTimeZone object that refers to UTC (Universal Time Coordinated). | - | ||||||||||||
| 808 | - | |||||||||||||
| 809 | \sa systemTimeZone() | - | ||||||||||||
| 810 | */ | - | ||||||||||||
| 811 | QTimeZone QTimeZone::utc() | - | ||||||||||||
| 812 | { | - | ||||||||||||
| 813 | return QTimeZone(QTimeZonePrivate::utcQByteArray()); never executed: return QTimeZone(QTimeZonePrivate::utcQByteArray()); | 0 | ||||||||||||
| 814 | } | - | ||||||||||||
| 815 | - | |||||||||||||
| 816 | /*! | - | ||||||||||||
| 817 | Returns \c true if a given time zone \a ianaId is available on this system. | - | ||||||||||||
| 818 | - | |||||||||||||
| 819 | \sa availableTimeZoneIds() | - | ||||||||||||
| 820 | */ | - | ||||||||||||
| 821 | - | |||||||||||||
| 822 | bool QTimeZone::isTimeZoneIdAvailable(const QByteArray &ianaId) | - | ||||||||||||
| 823 | { | - | ||||||||||||
| 824 | // isValidId is not strictly required, but faster to weed out invalid | - | ||||||||||||
| 825 | // IDs as availableTimeZoneIds() may be slow | - | ||||||||||||
| 826 | if (!QTimeZonePrivate::isValidId(ianaId))
| 0-463 | ||||||||||||
| 827 | return false; never executed: return false; | 0 | ||||||||||||
| 828 | const QList<QByteArray> tzIds = availableTimeZoneIds(); | - | ||||||||||||
| 829 | return std::binary_search(tzIds.begin(), tzIds.end(), ianaId); executed 463 times by 1 test: return std::binary_search(tzIds.begin(), tzIds.end(), ianaId);Executed by:
| 463 | ||||||||||||
| 830 | } | - | ||||||||||||
| 831 | - | |||||||||||||
| 832 | static QList<QByteArray> set_union(const QList<QByteArray> &l1, const QList<QByteArray> &l2) | - | ||||||||||||
| 833 | { | - | ||||||||||||
| 834 | QList<QByteArray> result; | - | ||||||||||||
| 835 | result.reserve(l1.size() + l2.size()); | - | ||||||||||||
| 836 | std::set_union(l1.begin(), l1.end(), | - | ||||||||||||
| 837 | l2.begin(), l2.end(), | - | ||||||||||||
| 838 | std::back_inserter(result)); | - | ||||||||||||
| 839 | return result; executed 468 times by 1 test: return result;Executed by:
| 468 | ||||||||||||
| 840 | } | - | ||||||||||||
| 841 | - | |||||||||||||
| 842 | /*! | - | ||||||||||||
| 843 | Returns a list of all available IANA time zone IDs on this system. | - | ||||||||||||
| 844 | - | |||||||||||||
| 845 | \sa isTimeZoneIdAvailable() | - | ||||||||||||
| 846 | */ | - | ||||||||||||
| 847 | - | |||||||||||||
| 848 | QList<QByteArray> QTimeZone::availableTimeZoneIds() | - | ||||||||||||
| 849 | { | - | ||||||||||||
| 850 | return set_union(QUtcTimeZonePrivate().availableTimeZoneIds(), executed 466 times by 1 test: return set_union(QUtcTimeZonePrivate().availableTimeZoneIds(), global_tz->backend->availableTimeZoneIds());Executed by:
| 466 | ||||||||||||
| 851 | global_tz->backend->availableTimeZoneIds()); executed 466 times by 1 test: return set_union(QUtcTimeZonePrivate().availableTimeZoneIds(), global_tz->backend->availableTimeZoneIds());Executed by:
| 466 | ||||||||||||
| 852 | } | - | ||||||||||||
| 853 | - | |||||||||||||
| 854 | /*! | - | ||||||||||||
| 855 | Returns a list of all available IANA time zone IDs for a given \a country. | - | ||||||||||||
| 856 | - | |||||||||||||
| 857 | As a special case, a \a country of Qt::AnyCountry returns those time zones | - | ||||||||||||
| 858 | that do not have any country related to them, such as UTC. If you require | - | ||||||||||||
| 859 | a list of all time zone IDs for all countries then use the standard | - | ||||||||||||
| 860 | availableTimeZoneIds() method. | - | ||||||||||||
| 861 | - | |||||||||||||
| 862 | \sa isTimeZoneIdAvailable() | - | ||||||||||||
| 863 | */ | - | ||||||||||||
| 864 | - | |||||||||||||
| 865 | QList<QByteArray> QTimeZone::availableTimeZoneIds(QLocale::Country country) | - | ||||||||||||
| 866 | { | - | ||||||||||||
| 867 | return set_union(QUtcTimeZonePrivate().availableTimeZoneIds(country), executed 1 time by 1 test: return set_union(QUtcTimeZonePrivate().availableTimeZoneIds(country), global_tz->backend->availableTimeZoneIds(country));Executed by:
| 1 | ||||||||||||
| 868 | global_tz->backend->availableTimeZoneIds(country)); executed 1 time by 1 test: return set_union(QUtcTimeZonePrivate().availableTimeZoneIds(country), global_tz->backend->availableTimeZoneIds(country));Executed by:
| 1 | ||||||||||||
| 869 | } | - | ||||||||||||
| 870 | - | |||||||||||||
| 871 | /*! | - | ||||||||||||
| 872 | Returns a list of all available IANA time zone IDs with a given standard | - | ||||||||||||
| 873 | time offset of \a offsetSeconds. | - | ||||||||||||
| 874 | - | |||||||||||||
| 875 | \sa isTimeZoneIdAvailable() | - | ||||||||||||
| 876 | */ | - | ||||||||||||
| 877 | - | |||||||||||||
| 878 | QList<QByteArray> QTimeZone::availableTimeZoneIds(int offsetSeconds) | - | ||||||||||||
| 879 | { | - | ||||||||||||
| 880 | return set_union(QUtcTimeZonePrivate().availableTimeZoneIds(offsetSeconds), executed 1 time by 1 test: return set_union(QUtcTimeZonePrivate().availableTimeZoneIds(offsetSeconds), global_tz->backend->availableTimeZoneIds(offsetSeconds));Executed by:
| 1 | ||||||||||||
| 881 | global_tz->backend->availableTimeZoneIds(offsetSeconds)); executed 1 time by 1 test: return set_union(QUtcTimeZonePrivate().availableTimeZoneIds(offsetSeconds), global_tz->backend->availableTimeZoneIds(offsetSeconds));Executed by:
| 1 | ||||||||||||
| 882 | } | - | ||||||||||||
| 883 | - | |||||||||||||
| 884 | /*! | - | ||||||||||||
| 885 | Returns the Windows ID equivalent to the given \a ianaId. | - | ||||||||||||
| 886 | - | |||||||||||||
| 887 | \sa windowsIdToDefaultIanaId(), windowsIdToIanaIds() | - | ||||||||||||
| 888 | */ | - | ||||||||||||
| 889 | - | |||||||||||||
| 890 | QByteArray QTimeZone::ianaIdToWindowsId(const QByteArray &ianaId) | - | ||||||||||||
| 891 | { | - | ||||||||||||
| 892 | return QTimeZonePrivate::ianaIdToWindowsId(ianaId); executed 5 times by 1 test: return QTimeZonePrivate::ianaIdToWindowsId(ianaId);Executed by:
| 5 | ||||||||||||
| 893 | } | - | ||||||||||||
| 894 | - | |||||||||||||
| 895 | /*! | - | ||||||||||||
| 896 | Returns the default IANA ID for a given \a windowsId. | - | ||||||||||||
| 897 | - | |||||||||||||
| 898 | Because a Windows ID can cover several IANA IDs in several different | - | ||||||||||||
| 899 | countries, this function returns the most frequently used IANA ID with no | - | ||||||||||||
| 900 | regard for the country and should thus be used with care. It is usually | - | ||||||||||||
| 901 | best to request the default for a specific country. | - | ||||||||||||
| 902 | - | |||||||||||||
| 903 | \sa ianaIdToWindowsId(), windowsIdToIanaIds() | - | ||||||||||||
| 904 | */ | - | ||||||||||||
| 905 | - | |||||||||||||
| 906 | QByteArray QTimeZone::windowsIdToDefaultIanaId(const QByteArray &windowsId) | - | ||||||||||||
| 907 | { | - | ||||||||||||
| 908 | return QTimeZonePrivate::windowsIdToDefaultIanaId(windowsId); executed 2 times by 1 test: return QTimeZonePrivate::windowsIdToDefaultIanaId(windowsId);Executed by:
| 2 | ||||||||||||
| 909 | } | - | ||||||||||||
| 910 | - | |||||||||||||
| 911 | /*! | - | ||||||||||||
| 912 | Returns the default IANA ID for a given \a windowsId and \a country. | - | ||||||||||||
| 913 | - | |||||||||||||
| 914 | Because a Windows ID can cover several IANA IDs within a given country, | - | ||||||||||||
| 915 | the most frequently used IANA ID in that country is returned. | - | ||||||||||||
| 916 | - | |||||||||||||
| 917 | As a special case, QLocale::AnyCountry returns the default of those IANA IDs | - | ||||||||||||
| 918 | that do not have any specific country. | - | ||||||||||||
| 919 | - | |||||||||||||
| 920 | \sa ianaIdToWindowsId(), windowsIdToIanaIds() | - | ||||||||||||
| 921 | */ | - | ||||||||||||
| 922 | - | |||||||||||||
| 923 | QByteArray QTimeZone::windowsIdToDefaultIanaId(const QByteArray &windowsId, | - | ||||||||||||
| 924 | QLocale::Country country) | - | ||||||||||||
| 925 | { | - | ||||||||||||
| 926 | return QTimeZonePrivate::windowsIdToDefaultIanaId(windowsId, country); executed 2 times by 1 test: return QTimeZonePrivate::windowsIdToDefaultIanaId(windowsId, country);Executed by:
| 2 | ||||||||||||
| 927 | } | - | ||||||||||||
| 928 | - | |||||||||||||
| 929 | /*! | - | ||||||||||||
| 930 | Returns all the IANA IDs for a given \a windowsId. | - | ||||||||||||
| 931 | - | |||||||||||||
| 932 | The returned list is sorted alphabetically. | - | ||||||||||||
| 933 | - | |||||||||||||
| 934 | \sa ianaIdToWindowsId(), windowsIdToDefaultIanaId() | - | ||||||||||||
| 935 | */ | - | ||||||||||||
| 936 | - | |||||||||||||
| 937 | QList<QByteArray> QTimeZone::windowsIdToIanaIds(const QByteArray &windowsId) | - | ||||||||||||
| 938 | { | - | ||||||||||||
| 939 | return QTimeZonePrivate::windowsIdToIanaIds(windowsId); executed 2 times by 1 test: return QTimeZonePrivate::windowsIdToIanaIds(windowsId);Executed by:
| 2 | ||||||||||||
| 940 | } | - | ||||||||||||
| 941 | - | |||||||||||||
| 942 | /*! | - | ||||||||||||
| 943 | Returns all the IANA IDs for a given \a windowsId and \a country. | - | ||||||||||||
| 944 | - | |||||||||||||
| 945 | As a special case QLocale::AnyCountry returns those IANA IDs that do | - | ||||||||||||
| 946 | not have any specific country. | - | ||||||||||||
| 947 | - | |||||||||||||
| 948 | The returned list is in order of frequency of usage, i.e. larger zones | - | ||||||||||||
| 949 | within a country are listed first. | - | ||||||||||||
| 950 | - | |||||||||||||
| 951 | \sa ianaIdToWindowsId(), windowsIdToDefaultIanaId() | - | ||||||||||||
| 952 | */ | - | ||||||||||||
| 953 | - | |||||||||||||
| 954 | QList<QByteArray> QTimeZone::windowsIdToIanaIds(const QByteArray &windowsId, | - | ||||||||||||
| 955 | QLocale::Country country) | - | ||||||||||||
| 956 | { | - | ||||||||||||
| 957 | return QTimeZonePrivate::windowsIdToIanaIds(windowsId, country); executed 6 times by 1 test: return QTimeZonePrivate::windowsIdToIanaIds(windowsId, country);Executed by:
| 6 | ||||||||||||
| 958 | } | - | ||||||||||||
| 959 | - | |||||||||||||
| 960 | #ifndef QT_NO_DATASTREAM | - | ||||||||||||
| 961 | QDataStream &operator<<(QDataStream &ds, const QTimeZone &tz) | - | ||||||||||||
| 962 | { | - | ||||||||||||
| 963 | tz.d->serialize(ds); | - | ||||||||||||
| 964 | return ds; executed 3 times by 2 tests: return ds;Executed by:
| 3 | ||||||||||||
| 965 | } | - | ||||||||||||
| 966 | - | |||||||||||||
| 967 | QDataStream &operator>>(QDataStream &ds, QTimeZone &tz) | - | ||||||||||||
| 968 | { | - | ||||||||||||
| 969 | QString ianaId; | - | ||||||||||||
| 970 | ds >> ianaId; | - | ||||||||||||
| 971 | if (ianaId == QLatin1String("OffsetFromUtc")) {
| 1-2 | ||||||||||||
| 972 | int utcOffset; | - | ||||||||||||
| 973 | QString name; | - | ||||||||||||
| 974 | QString abbreviation; | - | ||||||||||||
| 975 | int country; | - | ||||||||||||
| 976 | QString comment; | - | ||||||||||||
| 977 | ds >> ianaId >> utcOffset >> name >> abbreviation >> country >> comment; | - | ||||||||||||
| 978 | tz = QTimeZone(ianaId.toUtf8(), utcOffset, name, abbreviation, (QLocale::Country) country, comment); | - | ||||||||||||
| 979 | } else { executed 1 time by 1 test: end of blockExecuted by:
| 1 | ||||||||||||
| 980 | tz = QTimeZone(ianaId.toUtf8()); | - | ||||||||||||
| 981 | } executed 2 times by 2 tests: end of blockExecuted by:
| 2 | ||||||||||||
| 982 | return ds; executed 3 times by 2 tests: return ds;Executed by:
| 3 | ||||||||||||
| 983 | } | - | ||||||||||||
| 984 | #endif // QT_NO_DATASTREAM | - | ||||||||||||
| 985 | - | |||||||||||||
| 986 | #ifndef QT_NO_DEBUG_STREAM | - | ||||||||||||
| 987 | QDebug operator<<(QDebug dbg, const QTimeZone &tz) | - | ||||||||||||
| 988 | { | - | ||||||||||||
| 989 | QDebugStateSaver saver(dbg); | - | ||||||||||||
| 990 | //TODO Include backend and data version details? | - | ||||||||||||
| 991 | dbg.nospace() << "QTimeZone(" << QString::fromUtf8(tz.id()) << ')'; | - | ||||||||||||
| 992 | return dbg; never executed: return dbg; | 0 | ||||||||||||
| 993 | } | - | ||||||||||||
| 994 | #endif | - | ||||||||||||
| 995 | - | |||||||||||||
| 996 | QT_END_NAMESPACE | - | ||||||||||||
| Source code | Switch to Preprocessed file |