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