| /**************************************************************************** |
| ** |
| ** Copyright (C) 2013 John Layt <jlayt@kde.org> |
| ** Contact: http://www.qt.io/licensing/ |
| ** |
| ** This file is part of the QtCore module of the Qt Toolkit. |
| ** |
| ** $QT_BEGIN_LICENSE:LGPL21$ |
| ** Commercial License Usage |
| ** Licensees holding valid commercial Qt licenses may use this file in |
| ** accordance with the commercial license agreement provided with the |
| ** Software or, alternatively, in accordance with the terms contained in |
| ** a written agreement between you and The Qt Company. For licensing terms |
| ** and conditions see http://www.qt.io/terms-conditions. For further |
| ** information use the contact form at http://www.qt.io/contact-us. |
| ** |
| ** GNU Lesser General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU Lesser |
| ** General Public License version 2.1 or version 3 as published by the Free |
| ** Software Foundation and appearing in the file LICENSE.LGPLv21 and |
| ** LICENSE.LGPLv3 included in the packaging of this file. Please review the |
| ** following information to ensure the GNU Lesser General Public License |
| ** requirements will be met: https://www.gnu.org/licenses/lgpl.html and |
| ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. |
| ** |
| ** As a special exception, The Qt Company gives you certain additional |
| ** rights. These rights are described in The Qt Company LGPL Exception |
| ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. |
| ** |
| ** $QT_END_LICENSE$ |
| ** |
| ****************************************************************************/ |
| |
| |
| #ifndef QTIMEZONE_H |
| #define QTIMEZONE_H |
| |
| #include <QtCore/qshareddata.h> |
| #include <QtCore/qlocale.h> |
| #include <QtCore/qdatetime.h> |
| |
| QT_BEGIN_NAMESPACE |
| |
| class QTimeZonePrivate; |
| |
| class Q_CORE_EXPORT QTimeZone |
| { |
| public: |
| enum TimeType { |
| StandardTime = 0, |
| DaylightTime = 1, |
| GenericTime = 2 |
| }; |
| |
| enum NameType { |
| DefaultName = 0, |
| LongName = 1, |
| ShortName = 2, |
| OffsetName = 3 |
| }; |
| |
| struct OffsetData { |
| QString abbreviation; |
| QDateTime atUtc; |
| int offsetFromUtc; |
| int standardTimeOffset; |
| int daylightTimeOffset; |
| }; |
| typedef QVector<OffsetData> OffsetDataList; |
| |
| QTimeZone(); |
| explicit QTimeZone(const QByteArray &ianaId); |
| explicit QTimeZone(int offsetSeconds); |
| /*implicit*/ QTimeZone(const QByteArray &zoneId, int offsetSeconds, const QString &name, |
| const QString &abbreviation, QLocale::Country country = QLocale::AnyCountry, |
| const QString &comment = QString()); |
| QTimeZone(const QTimeZone &other); |
| ~QTimeZone(); |
| |
| QTimeZone &operator=(const QTimeZone &other); |
| #ifdef Q_COMPILER_RVALUE_REFS |
| QTimeZone &operator=(QTimeZone &&other) Q_DECL_NOTHROW { swap(other); return *this; } |
| #endif |
| |
| void swap(QTimeZone &other) Q_DECL_NOTHROW |
| { d.swap(other.d); } |
| |
| bool operator==(const QTimeZone &other) const; |
| bool operator!=(const QTimeZone &other) const; |
| |
| bool isValid() const; |
| |
| QByteArray id() const; |
| QLocale::Country country() const; |
| QString comment() const; |
| |
| QString displayName(const QDateTime &atDateTime, |
| QTimeZone::NameType nameType = QTimeZone::DefaultName, |
| const QLocale &locale = QLocale()) const; |
| QString displayName(QTimeZone::TimeType timeType, |
| QTimeZone::NameType nameType = QTimeZone::DefaultName, |
| const QLocale &locale = QLocale()) const; |
| QString abbreviation(const QDateTime &atDateTime) const; |
| |
| int offsetFromUtc(const QDateTime &atDateTime) const; |
| int standardTimeOffset(const QDateTime &atDateTime) const; |
| int daylightTimeOffset(const QDateTime &atDateTime) const; |
| |
| bool hasDaylightTime() const; |
| bool isDaylightTime(const QDateTime &atDateTime) const; |
| |
| OffsetData offsetData(const QDateTime &forDateTime) const; |
| |
| bool hasTransitions() const; |
| OffsetData nextTransition(const QDateTime &afterDateTime) const; |
| OffsetData previousTransition(const QDateTime &beforeDateTime) const; |
| OffsetDataList transitions(const QDateTime &fromDateTime, const QDateTime &toDateTime) const; |
| |
| static QByteArray systemTimeZoneId(); |
| static QTimeZone systemTimeZone(); |
| static QTimeZone utc(); |
| |
| static bool isTimeZoneIdAvailable(const QByteArray &ianaId); |
| |
| static QList<QByteArray> availableTimeZoneIds(); |
| static QList<QByteArray> availableTimeZoneIds(QLocale::Country country); |
| static QList<QByteArray> availableTimeZoneIds(int offsetSeconds); |
| |
| static QByteArray ianaIdToWindowsId(const QByteArray &ianaId); |
| static QByteArray windowsIdToDefaultIanaId(const QByteArray &windowsId); |
| static QByteArray windowsIdToDefaultIanaId(const QByteArray &windowsId, |
| QLocale::Country country); |
| static QList<QByteArray> windowsIdToIanaIds(const QByteArray &windowsId); |
| static QList<QByteArray> windowsIdToIanaIds(const QByteArray &windowsId, |
| QLocale::Country country); |
| |
| private: |
| QTimeZone(QTimeZonePrivate &dd); |
| #ifndef QT_NO_DATASTREAM |
| friend Q_CORE_EXPORT QDataStream &operator<<(QDataStream &ds, const QTimeZone &tz); |
| #endif |
| friend class QTimeZonePrivate; |
| friend class QDateTime; |
| friend class QDateTimePrivate; |
| QSharedDataPointer<QTimeZonePrivate> d; |
| }; |
| |
| Q_DECLARE_TYPEINFO(QTimeZone::OffsetData, Q_MOVABLE_TYPE); |
| Q_DECLARE_SHARED(QTimeZone) |
| |
| #ifndef QT_NO_DATASTREAM |
| Q_CORE_EXPORT QDataStream &operator<<(QDataStream &ds, const QTimeZone &tz); |
| Q_CORE_EXPORT QDataStream &operator>>(QDataStream &ds, QTimeZone &tz); |
| #endif |
| |
| #ifndef QT_NO_DEBUG_STREAM |
| Q_CORE_EXPORT QDebug operator<<(QDebug dbg, const QTimeZone &tz); |
| #endif |
| |
| QT_END_NAMESPACE |
| |
| #endif // QTIMEZONE_H |