QTimeZone Class

Dokumentation zu den Mitgliedsfunktionen

[noexcept] QTimeZone::QTimeZone()

Erstellen Sie eine Instanz mit einer nicht vorhandenen bzw. ungültigen Zeitzone.

[noexcept, since 6.5] QTimeZone::QTimeZone(QTimeZone::Initialization spec)

Erstellt eine kompakte Instanz, die die UTC- oder Ortszeit beschreibt.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch fromSecondsAheadOfUtc(), asBackendZone(), utc() und systemTimeZone().

[explicit] QTimeZone::QTimeZone(const QByteArray &ianaId)

Erstellt eine Zeitzoneninstanz mit der angeforderten IANA-ID „ ianaId “.

Die ID muss eine der verfügbaren System-IDs oder eine gültige UTC-mit-Offset-ID sein, andernfalls wird eine ungültige Zeitzone zurückgegeben. Bei UTC-mit-Offset-IDs, die keine tatsächlichen IANA-IDs sind, kann die id() der resultierenden Instanz von der an den Konstruktor übergebenen ID abweichen.

Dieser Konstruktor ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch ` availableTimeZoneIds()` und ` id()`.

[explicit] QTimeZone::QTimeZone(int offsetSeconds)

Erstellt eine Zeitzoneninstanz mit dem angegebenen Offset ( offsetSeconds) gegenüber UTC.

Der Versatz „ offsetSeconds “ gegenüber UTC muss im Bereich von -16 bis +16 Stunden liegen, andernfalls wird eine ungültige Zeitzone zurückgegeben.

Dieser Konstruktor ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist. Die zurückgegebene Instanz entspricht der vereinfachten Zeitdarstellung „ QTimeZone::fromSecondsAheadOfUtc(offsetSeconds) “, ist jedoch als Zeitzone implementiert.

Siehe auch „ MinUtcOffsetSecs“ , „ MaxUtcOffsetSecs “ und „ id()“.

QTimeZone::QTimeZone(const QByteArray &zoneId, int offsetSeconds, const QString &name, const QString &abbreviation, QLocale::Territory territory = QLocale::AnyTerritory, const QString &comment = QString())

Erstellt eine benutzerdefinierte Zeitzoneninstanz mit einem festen Versatz gegenüber UTC.

Die zurückgegebene Zeitzone hat die ID „ zoneId “ und einen Versatz gegenüber UTC von „ offsetSeconds “. „ name “ ist der Name, der von „ displayName()“ für „ LongName “ verwendet wird, „ abbreviation “ wird von „ displayName()“ für „ ShortName “ sowie von „ abbreviation()“ verwendet, und das optionale „ territory “ wird von „ territory()“ verwendet. „ comment “ ist ein optionaler Hinweis, der in einer Benutzeroberfläche angezeigt werden kann, um Benutzern bei der Auswahl einer Zeitzone zu helfen.

Der „ offsetSeconds “ von UTC muss im Bereich von -16 Stunden bis +16 Stunden liegen. Die „ zoneId “ darf keine ID sein, für die „ isTimeZoneIdAvailable()“ wahr ist, es sei denn, es handelt sich um einen UTC-Offset-Namen, der nicht in „ availableTimeZoneIds()“ vorkommt.

Wenn die benutzerdefinierte Zeitzone kein bestimmtes Gebiet hat, setzen Sie sie auf den Standardwert „ QLocale::AnyTerritory “.

Dieser Konstruktor ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch id(), offsetFromUtc(), displayName(), abbreviation(), territory(), comment(), MinUtcOffsetSecs und MaxUtcOffsetSecs.

[noexcept] QTimeZone::QTimeZone(const QTimeZone &other)

Kopierkonstruktor: Kopiere „ other “ in „this“.

[noexcept] QTimeZone::QTimeZone(QTimeZone &&other)

Der Move-Konstruktor hierfür stammt von other.

[noexcept] QTimeZone::~QTimeZone()

Zerstört die Zeitzone.

QString QTimeZone::abbreviation(const QDateTime &atDateTime) const

Gibt die Zeitzonenabkürzung für die angegebene atDateTime zurück.

Die Abkürzung kann sich je nach Sommerzeit oder sogar aufgrund historischer Ereignisse ändern.

Diese Methode ist nur verfügbar, wenn die Funktion ` timezone ` aktiviert ist.

Siehe auch „ displayName()“.

[since 6.5] QTimeZone QTimeZone::asBackendZone() const

Wandelt dieses „ QTimeZone “ in ein Element um, dessen „ timeSpec()“ den Wert „ Qt::TimeZone “ ergibt.

In allen Fällen ist das Ergebnis von timeSpec() Qt::TimeZone. Wenn das timeSpec() dieses QTimeZone Qt::TimeZone ist, wird dieses QTimeZone selbst zurückgegeben. Ist timeSpec() Qt::LocalTime, dann wird systemTimeZone() zurückgegeben.

Wenn timeSpec() Qt::UTC lautet, wird QTimeZone::utc() zurückgegeben. Wenn es Qt::OffsetFromUTC lautet, wird QTimeZone(int) mit dem entsprechenden Offset übergeben und das Ergebnis zurückgegeben.

Bei der Verwendung einer vereinfachten Zeitdarstellung – Ortszeit, UTC-Zeit oder Zeit mit einem festen Offset gegenüber UTC – kann die Verwendung von Methoden, die nur bei aktivierter Funktion „ timezone “ unterstützt werden, aufwendiger sein als die Verwendung einer entsprechenden Zeitzone. Diese Methode ordnet eine vereinfachte Zeitdarstellung einer entsprechenden Zeitzone zu – das heißt, einer Instanz, die auf vom System bereitgestellten oder Standarddaten basiert.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch „ QTimeZone“ (QTimeZone::Initialization) und „ fromSecondsAheadOfUtc “ ().

[static] QList<QByteArray> QTimeZone::availableTimeZoneIds()

Gibt eine Liste der auf diesem System verfügbaren Zeitzonen-IDs zurück.

Dazu gehören eine IANA-ID für jede Zone, die von der Zeitzonen-Informationsquelle des Systems unterstützt wird, sowie einige Aliase dieser IDs und eine begrenzte Anzahl häufig verwendeter UTC-Offset-IDs.

Der Konstruktor ` QTimeZone ` akzeptiert auch einige UTC-Offset-IDs, die nicht in der zurückgegebenen Liste enthalten sind – es wäre unpraktisch, alle möglichen UTC-Offset-IDs aufzulisten. Er akzeptiert zudem bekannte Aliase für unterstützte IANA-IDs, von denen einige möglicherweise nicht in dieser Liste aufgeführt sind. Solche IDs werden auch von ` isTimeZoneIdAvailable()` akzeptiert.

Wenn das „Common Locale Data Repository“ (CLDR) des Unicode-Konsortiums eine unterstützte IANA-ID als Alias für den stabilen Namen der Zone betrachtet, so wird dieser stabile Name für die Zone ebenfalls in die Liste aufgenommen (auch wenn er möglicherweise veraltet ist) – sowohl aus Gründen der Stabilität als auch als plattformübergreifende gemeinsame Grundlage, wenn verschiedene Systemquellen für Zeitzoneninformationen unterschiedliche Aliase für dieselbe Zone verwenden.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch „ isTimeZoneIdAvailable “ () und „ hasAlternativeName “ ().

[static] QList<QByteArray> QTimeZone::availableTimeZoneIds(QLocale::Territory territory)

Gibt eine Liste aller verfügbaren IANA-Zeitzonen-IDs für eine bestimmte „ territory “ zurück.

Als Sonderfall wählt ein „ territory “ von „ AnyTerritory “ jene Zeitzonen aus, die nicht an ein bestimmtes Gebiet gebunden sind, wie beispielsweise UTC, während „ World “ jene Zeitzonen auswählt, für die es eine globale Standard-IANA-ID gibt. Wenn Sie eine Liste aller Zeitzonen-IDs für alle Gebiete benötigen, verwenden Sie die Standardmethode „availableTimeZoneIds()“.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch „ isTimeZoneIdAvailable()“ und „ territory()“.

[static] QList<QByteArray> QTimeZone::availableTimeZoneIds(int offsetSeconds)

Gibt eine Liste aller verfügbaren IANA-Zeitzonen-IDs mit einem bestimmten Standardzeitversatz von offsetSeconds zurück.

Sofern der angegebene Versatz unterstützt wird, wird „ QTimeZone(offsetSeconds).id() “ in die Liste aufgenommen, auch wenn es sich dabei nicht um eine IANA-ID handelt. Dies tritt nur dann auf, wenn es keine IANA-UTC-Versatz-ID mit dem angegebenen Versatz gibt.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch „ isTimeZoneIdAvailable()“ und „ QTimeZone(int)“.

QString QTimeZone::comment() const

Gibt einen Kommentar zur Zeitzone zurück.

Ein Kommentar kann von der Host-Plattform bereitgestellt werden, um Benutzern bei der Auswahl der richtigen Zeitzone zu helfen. Je nach Plattform ist dieser möglicherweise nicht lokalisiert.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

int QTimeZone::daylightTimeOffset(const QDateTime &atDateTime) const

Gibt den Sommerzeit-Offset für die angegebene Zeitzone „ atDateTime “ zurück, d. h. die Anzahl der Sekunden, die zum Standardzeit-Offset addiert werden müssen, um die lokale Sommerzeit zu erhalten.

Beispielsweise beträgt der Sommerzeit-Offset für die Zeitzone „Europe/Berlin“ +3600 Sekunden. Während der Standardzeit gibt daylightTimeOffset() den Wert 0 zurück, während der Sommerzeit hingegen den Wert +3600.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch „ offsetFromUtc()“ und „ standardTimeOffset()“.

QString QTimeZone::displayName(QTimeZone::TimeType timeType, QTimeZone::NameType nameType = DefaultName, const QLocale &locale = QLocale()) const

Gibt den lokalisierten Namen der Zeitzone zurück.

Der zurückgegebene Name ist derjenige für die angegebene „ locale “, der gilt, wenn die angegebene „ timeType “ in Kraft ist, und der die in „ nameType “ angegebene Form aufweist. Falls sich die Anzeigenamen der Zeitzonen im Laufe der Zeit geändert haben, werden die aktuellen Namen verwendet. Ist kein entsprechend lokalisierter Name des angegebenen Typs verfügbar, kann ein anderer Namenstyp verwendet oder eine leere Zeichenkette zurückgegeben werden.

Wird die „ locale “ nicht angegeben, wird die Standard-Locale der Anwendung verwendet. Für benutzerdefinierte Zeitzonen, die durch Client-Code erstellt wurden, werden die an den Konstruktor übergebenen Daten verwendet, da hierfür keine Lokalisierungsdaten verfügbar sind. Ist diese Zeitzone ungültig, wird eine leere Zeichenkette zurückgegeben. Dies kann auch bei der Darstellung der Ortszeit auftreten, wenn die Ermittlung der Systemzeitzone fehlschlägt.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch „ abbreviation()“.

QString QTimeZone::displayName(const QDateTime &atDateTime, QTimeZone::NameType nameType = DefaultName, const QLocale &locale = QLocale()) const

Gibt den lokalisierten Anzeigenamen der Zeitzone zurück.

Der zurückgegebene Name ist derjenige für die angegebene „ locale “, der an der angegebenen „ atDateTime “ gilt und die durch „ nameType “ angegebene Form hat. Der Anzeigename kann sich je nach Sommerzeit oder historischen Ereignissen ändern. Wenn kein entsprechend lokalisierter Name des angegebenen Typs verfügbar ist, kann ein anderer Namentyp verwendet oder eine leere Zeichenfolge zurückgegeben werden.

Wird die „ locale “ nicht angegeben, wird die Standard-Locale der Anwendung verwendet. Für benutzerdefinierte Zeitzonen, die durch Client-Code erstellt wurden, werden die an den Konstruktor übergebenen Daten verwendet, da hierfür keine Lokalisierungsdaten verfügbar sind. Ist diese Zeitzone ungültig, wird eine leere Zeichenfolge zurückgegeben. Dies kann auch bei der Darstellung der Ortszeit auftreten, wenn die Ermittlung der Systemzeitzone fehlschlägt.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch „ abbreviation()“.

[constexpr noexcept, since 6.5] int QTimeZone::fixedSecondsAheadOfUtc() const

Für eine leichtgewichtige Zeitdarstellung, deren ` timeSpec()` den Wert ` Qt::OffsetFromUTC` hat, gibt diese Funktion den festgelegten Versatz gegenüber UTC zurück, den sie beschreibt. Für jede andere Zeitdarstellung gibt sie 0 zurück, selbst wenn diese Zeitdarstellung einen konstanten Versatz gegenüber UTC aufweist.

Diese Funktion wurde in Qt 6.5 eingeführt.

[static] QTimeZone QTimeZone::fromCFTimeZone(CFTimeZoneRef timeZone)

Erstellt ein neues ` QTimeZone `-Objekt, das eine Kopie des `CFTimeZone`-Objekts ` timeZone` enthält.

Siehe auch toCFTimeZone().

Gibt eine Zeitangabe in einer festen Zeitzone „ offset “ in Sekunden vor UTC zurück.

Der Versatz ( offset ) gegenüber UTC muss im Bereich von -16 Stunden bis +16 Stunden liegen, andernfalls wird eine ungültige Zeitzone zurückgegeben. Die zurückgegebene Instanz „ QTimeZone “ ist eine vereinfachte Zeitdarstellung und keine Zeitzone (die auf vom System bereitgestellten oder Standarddaten basiert).

Ist der Offset 0, ist der Wert von ` timeSpec()` der zurückgegebenen Instanz ` Qt::UTC`. Andernfalls, sofern ` offset ` gültig ist, ist der Wert von ` timeSpec()` ` Qt::OffsetFromUTC`. Bei Rückgabe einer ungültigen Zeitzone ist der Wert von ` timeSpec()` ` Qt::TimeZone `.

Diese Funktionen wurden in Qt 6.5 eingeführt.

Siehe auch „ QTimeZone“ (int), „ asBackendZone “ (), „ fixedSecondsAheadOfUtc “ (), „ MinUtcOffsetSecs “ und „ MaxUtcOffsetSecs “.

[static] QTimeZone QTimeZone::fromNSTimeZone(const NSTimeZone *timeZone)

Erstellt ein neues ` QTimeZone `-Objekt, das eine Kopie des `NSTimeZone`-Objekts ` timeZone` enthält.

Siehe auch toNSTimeZone().

[static, since 6.4] QTimeZone QTimeZone::fromStdTimeZonePtr(const std::chrono::time_zone *timeZone)

Gibt ein „ QTimeZone “-Objekt zurück, das dieselbe Zeitzone wie „ timeZone “ darstellt. Die IANA-ID von „ timeZone “ muss eine der verfügbaren System-IDs sein, andernfalls wird eine ungültige Zeitzone zurückgegeben.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Diese Funktion wurde in Qt 6.4 eingeführt.

[since 6.8] bool QTimeZone::hasAlternativeName(QByteArrayView alias) const

Gibt „ true “ zurück, wenn „ alias “ ein alternativer Name für diese Zeitzone ist.

Die IANA-Datenbank (ehemals Olson) hat im Laufe ihrer Geschichte einige Zeitzonen umbenannt. Es gibt auch einige Zeitzonen, die sich vor 1970 unterschieden, nun aber als Synonyme behandelt werden. Einige Backends verfügen möglicherweise über Daten, die bis vor 1970 zurückreichen, und erzeugen im letzteren Fall unterschiedliche Zeitzonen. Andere erzeugen möglicherweise Zeitzonen, die sich nur durch id() unterscheiden lassen. Diese Methode ermittelt, ob sich eine ID (zumindest seit 1970) auf dieselbe Zeitzone bezieht, die dieses Zeitzonenobjekt beschreibt.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch „ isTimeZoneIdAvailable“ ().

bool QTimeZone::hasDaylightTime() const

Gibt „ true “ zurück, wenn in der Zeitzone zu irgendeinem Zeitpunkt die Sommerzeit angewendet wurde.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch „ isDaylightTime()“ und „ daylightTimeOffset()“.

bool QTimeZone::hasTransitions() const

Gibt „ true “ zurück, wenn das System-Backend das Abrufen von Zeitumstellungen unterstützt.

Zeitumstellungen sind Änderungen der Zeitzone: Diese treten auf, wenn die Sommerzeit ein- oder ausgeschaltet wird und wenn Behörden die Zeitverschiebungen für die Zeitzone anpassen.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch ` nextTransition()`, ` previousTransition()` und ` transitions()`.

[static] QByteArray QTimeZone::ianaIdToWindowsId(const QByteArray &ianaId)

Gibt die Windows-ID zurück, die dem angegebenen „ ianaId “ entspricht.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch „ windowsIdToDefaultIanaId()“ und „ windowsIdToIanaIds()“.

QByteArray QTimeZone::id() const

Gibt die IANA-ID für die Zeitzone zurück.

IANA-IDs werden auf allen Plattformen verwendet. Unter Windows werden diese von der Windows-ID in die am besten passende IANA-ID für die Zeitzone und das Gebiet übersetzt.

Wenn diese Zeitzoneninstanz nicht anhand einer IANA-ID erstellt wurde, richtet sich ihre ID danach, wie sie erstellt wurde. In den meisten Fällen wird die ID verwendet, die beim Erstellen der Instanz übergeben wurde. (Der Konstruktor für eine benutzerdefinierte Zeitzone verwendet die ihm übergebene ID, die keine IANA-ID sein darf.) Es gibt zwei Ausnahmen.

• Instanzen, die durch die Übergabe eines UTC-Offsets in Sekunden erstellt wurden, erhalten bei der Erstellung keine ID.
• Der Konstruktor, der nur eine IANA-ID akzeptiert, akzeptiert auch einige UTC-Offset-IDs, die eigentlich keine IANA-IDs sind: Die Behandlung dieser IDs entspricht der Übergabe des entsprechenden Offsets in Sekunden, wie bei der ersten Ausnahme.

In den beiden Ausnahmefällen verwendet die erstellte Instanz, sofern es eine IANA-Zeitzone mit dem angegebenen UTC-Offset gibt, die ID dieser IANA-Zeitzone, auch wenn diese von der an den Konstruktor übergebenen (Nicht-IANA-)UTC-Offset-ID abweichen kann. Andernfalls verwendet die Instanz eine aus ihrem Offset synthetisierte ID in der Form UTC±hh:mm:ss, wobei ein nachgestelltes :00 für null Sekunden oder Minuten weggelassen wird. Auch dies kann von der an den Konstruktor übergebenen UTC-Offset-ID abweichen.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

bool QTimeZone::isDaylightTime(const QDateTime &atDateTime) const

Gibt „ true “ zurück, wenn zum angegebenen Zeitpunkt „ atDateTime “ die Sommerzeit galt.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch „ hasDaylightTime()“ und „ daylightTimeOffset()“.

[static] bool QTimeZone::isTimeZoneIdAvailable(QByteArrayView ianaId)

Gibt „ true “ zurück, wenn eine bestimmte Zeitzone ianaId auf diesem System verfügbar ist.

Dies kann bei einigen Texten der Fall sein, die eigentlich keine IANA-IDs sind, insbesondere bei UTC-Offset-IDs und bekannten Aliasen für unterstützte IANA-IDs, die nicht in availableTimeZoneIds() aufgeführt sind.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch „ availableTimeZoneIds “ () und „ hasAlternativeName “ ().

[constexpr noexcept, since 6.5] bool QTimeZone::isUtcOrFixedOffset() const

Gibt „ true “ zurück, wenn „ timeSpec()“ den Wert „ Qt::UTC “ oder „ Qt::OffsetFromUTC “ ergibt.

Ist dies der Fall, ändert sich die Zeitbeschreibung im Laufe der Zeit nicht, wie es beispielsweise bei saisonalen Umstellungen auf Sommerzeit der Fall sein kann, die bei der Ortszeit oder einer Zeitzone auftreten können. Diese Information kann dem aufrufenden Code verschiedene weitere Überprüfungen ersparen.

Diese Funktion wurde in Qt 6.5 eingeführt.

[static constexpr noexcept, since 6.5] bool QTimeZone::isUtcOrFixedOffset(Qt::TimeSpec spec)

Gibt „ true “ zurück, wenn „ spec “ entweder „ Qt::UTC “ oder „ Qt::OffsetFromUTC “ ist.

Diese Funktion wurde in Qt 6.5 eingeführt.

bool QTimeZone::isValid() const

Gibt „ true “ zurück, wenn diese Zeitzone gültig ist.

QTimeZone::OffsetData QTimeZone::nextTransition(const QDateTime &afterDateTime) const

Gibt den ersten Zeitzonenübergang nach dem angegebenen afterDateTime zurück. Dies ist besonders nützlich, wenn Sie einen Übergangszeitpunkt haben und den darauf folgenden Übergang ermitteln möchten.

Wenn nach dem angegebenen „ afterDateTime “ kein Übergang folgt, wird ein ungültiges „ OffsetData “ mit einem ungültigen „ QDateTime “ als „ atUtc “ zurückgegeben.

Die angegebene „ afterDateTime “ ist exklusiv.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch hasTransitions(), previousTransition() und transitions().

QTimeZone::OffsetData QTimeZone::offsetData(const QDateTime &forDateTime) const

Gibt die Details zum effektiven Offset an der angegebenen Adresse forDateTime zurück.

Dies entspricht dem Aufruf von ` abbreviation()` sowie der einzelnen Aufrufe aller drei Offset-Funktionen, ist jedoch möglicherweise effizienter und liefert unter Umständen eine andere Lokalisierung für die Abkürzung. Sind diese Daten für den angegebenen Datums- und Zeitwert nicht verfügbar, wird ein ungültiger ` OffsetData ` mit einem ungültigen ` QDateTime ` als ` atUtc` zurückgegeben.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch offsetFromUtc(), standardTimeOffset(), daylightTimeOffset() und abbreviation().

int QTimeZone::offsetFromUtc(const QDateTime &atDateTime) const

Gibt den gesamten effektiven Zeitversatz für die angegebene Zeitangabe „ atDateTime “ zurück, d. h. die Anzahl der Sekunden, die zur UTC-Zeit addiert werden müssen, um die Ortszeit zu erhalten. Dies umfasst auch einen eventuell geltenden Sommerzeitversatz, d. h., es handelt sich um die Summe aus standardTimeOffset() und daylightTimeOffset() für die angegebene Zeitangabe.

Beispielsweise beträgt für die Zeitzone „Europe/Berlin“ der Standard-Zeitversatz +3600 Sekunden und der Sommerzeit-Versatz +3600 Sekunden. Während der Standardzeit gibt offsetFromUtc() +3600 (UTC+01:00) zurück, während der Sommerzeit hingegen +7200 (UTC+02:00).

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch „ standardTimeOffset()“ und „ daylightTimeOffset()“.

QTimeZone::OffsetData QTimeZone::previousTransition(const QDateTime &beforeDateTime) const

Gibt den ersten Zeitzonenübergang vor dem angegebenen „ beforeDateTime “ zurück. Dies ist besonders nützlich, wenn Sie eine Übergangszeit haben und den Übergang davor ermitteln möchten.

Wenn es keinen Übergang vor dem angegebenen „ beforeDateTime “ gibt, wird ein ungültiges „ OffsetData “ mit einem ungültigen „ QDateTime “ als „ atUtc “ zurückgegeben.

Der angegebene „ beforeDateTime “ ist exklusiv.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch „ hasTransitions()“, „ nextTransition()“ und „ transitions()“.

int QTimeZone::standardTimeOffset(const QDateTime &atDateTime) const

Gibt den Standard-Zeitversatz für die angegebene atDateTime zurück, d. h. die Anzahl der Sekunden, die zur UTC hinzugefügt werden müssen, um die lokale Standardzeit zu erhalten. Dabei wird ein eventuell geltender Sommerzeitversatz nicht berücksichtigt.

Beispielsweise beträgt der Standardzeitversatz für die Zeitzone „Europe/Berlin“ +3600 Sekunden. Sowohl während der Standardzeit als auch während der Sommerzeit gibt offsetFromUtc() den Wert +3600 (UTC+01:00) zurück.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch offsetFromUtc() und daylightTimeOffset().

[noexcept] void QTimeZone::swap(QTimeZone &other)

Tauscht diese Zeitzoneninstanz gegen „ other “ aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

[static] QTimeZone QTimeZone::systemTimeZone()

Gibt ein „ QTimeZone “-Objekt zurück, das die lokale Systemzeit beschreibt.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist. Die zurückgegebene Instanz entspricht in der Regel der vereinfachten Zeitdarstellung „ QTimeZone(QTimeZone::LocalTime) “, ist jedoch als Zeitzone implementiert.

Das zurückgegebene Objekt ändert sich nicht, um spätere Änderungen der Systemzeitzone widerzuspiegeln. Es repräsentiert die Ortszeit, die zum Zeitpunkt des Aufrufs von ` asBackendZone()` gültig war. Auf falsch konfigurierten Systemen, beispielsweise solchen, denen die Zeitzonendaten fehlen, auf die das Backend zurückgreift, für das Qt kompiliert wurde, kann es ungültig sein. In einem solchen Fall wird eine Warnung ausgegeben.

Siehe auch „ utc()“, „ Initialization “, „ asBackendZone()“ und „ systemTimeZoneId()“.

[static] QByteArray QTimeZone::systemTimeZoneId()

Gibt die IANA-ID der aktuellen Systemzeitzone zurück.

Entspricht dem Aufruf von ` systemTimeZone()`. `id()`, kann jedoch einige Berechnungen zur Ermittlung der Zeitzone überspringen. Das Erstellen eines ` QTimeZone ` aus dem zurückgegebenen Byte-Array liefert dasselbe Ergebnis wie ` systemTimeZone()`.

Wenn das Backend die richtige Systemzeitzone nicht ermitteln kann, ist das Ergebnis leer. In diesem Fall ist systemTimeZone().isValid() falsch, und es wird eine Warnung ausgegeben, wenn entweder diese Methode oder systemTimeZone() aufgerufen wird.

Wenn das Backend die richtige Systemzone ermitteln kann, jedoch nicht deren Namen, wird ein leeres Byte-Array zurückgegeben. Unter Windows wird beispielsweise die systemeigene ID in eine IANA-ID umgewandelt – ist die System-ID dem internen Übersetzungscode nicht bekannt, muss das Ergebnis leer sein. In diesem Fall ist „ systemTimeZone()“ („isValid(“) wahr.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch systemTimeZone().

[since 6.2] QLocale::Territory QTimeZone::territory() const

Gibt das Gebiet der Zeitzone zurück.

Die Rückgabe von „ AnyTerritory “ bedeutet, dass für die Zeitzone kein bekanntes Gebiet zugeordnet ist. In einigen Fällen kann dies daran liegen, dass die Zeitzone keinem Gebiet zugeordnet ist – zum Beispiel UTC – oder dass die Zeitzone in mehreren Gebieten verwendet wird – zum Beispiel MEZ. In anderen Fällen weiß das „ QTimeZone “-Backend möglicherweise nicht, welchem Gebiet die Zeitzone zugeordnet ist – zum Beispiel, weil sie nicht die primäre Zeitzone des Gebiets ist, in dem sie verwendet wird.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Diese Funktion wurde in Qt 6.2 eingeführt.

[constexpr noexcept, since 6.5] Qt::TimeSpec QTimeZone::timeSpec() const

Gibt einen „ Qt::TimeSpec “ zurück, der den Typ der Zeitdarstellung angibt.

Ist das Ergebnis „ Qt::TimeZone “, handelt es sich bei dieser Zeitbeschreibung um eine Zeitzone (gestützt auf vom System bereitgestellte oder Standarddaten); andernfalls handelt es sich um eine vereinfachte Zeitdarstellung. Ist das Ergebnis „ Qt::LocalTime “, beschreibt es die Ortszeit: Weitere Informationen finden Sie unter Qt::TimeSpec.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch fixedSecondsAheadOfUtc() und asBackendZone().

CFTimeZoneRef QTimeZone::toCFTimeZone() const

Erstellt ein CFTimeZone-Objekt aus einem „ QTimeZone “-Objekt.

Der Aufrufer ist Eigentümer des CFTimeZone-Objekts und dafür verantwortlich, es freizugeben.

Siehe auch fromCFTimeZone().

NSTimeZone *QTimeZone::toNSTimeZone() const

Erstellt eine `NSTimeZone` aus einem ` QTimeZone`.

Das NSTimeZone-Objekt wird automatisch freigegeben.

Siehe auch ` fromNSTimeZone()`().

QTimeZone::OffsetDataList QTimeZone::transitions(const QDateTime &fromDateTime, const QDateTime &toDateTime) const

Gibt eine Liste aller Zeitzonenwechsel zwischen den angegebenen Datums- und Zeitangaben zurück.

Die angegebenen Werte „ fromDateTime “ und „ toDateTime “ sind inklusive. Das Element „ atUtc “ jedes Eintrags beschreibt den Zeitpunkt des Wechsels, zu dem die durch andere Elemente angegebenen Offsets und Abkürzungen wirksam werden.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch hasTransitions(), nextTransition() und previousTransition().

[static] QTimeZone QTimeZone::utc()

Gibt ein „ QTimeZone “-Objekt zurück, das UTC als Zeitzone beschreibt.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist. Sie entspricht der Übergabe von 0 an „ QTimeZone(int offsetSeconds)“ und an die vereinfachte Zeitdarstellung „ QTimeZone(QTimeZone::UTC)“, ist jedoch im Gegensatz zu letzterer als Zeitzone implementiert.

Siehe auch systemTimeZone(), Initialization und asBackendZone().

[static] QByteArray QTimeZone::windowsIdToDefaultIanaId(const QByteArray &windowsId)

Gibt die Standard-IANA-ID für eine bestimmte „ windowsId “ zurück.

Da eine Windows-ID mehrere IANA-IDs in verschiedenen Regionen abdecken kann, gibt diese Funktion die am häufigsten verwendete IANA-ID zurück, ohne die Region zu berücksichtigen, und sollte daher mit Bedacht verwendet werden. In der Regel ist es am besten, die Standard-ID für eine bestimmte Region abzufragen.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch „ ianaIdToWindowsId()“ und „ windowsIdToIanaIds()“.

[static] QByteArray QTimeZone::windowsIdToDefaultIanaId(const QByteArray &windowsId, QLocale::Territory territory)

Gibt die Standard-IANA-ID für eine bestimmte „ windowsId “ und „ territory “ zurück.

Da eine Windows-ID mehrere IANA-IDs innerhalb eines bestimmten Gebiets abdecken kann, wird die in diesem Gebiet am häufigsten verwendete IANA-ID zurückgegeben.

Als Sonderfall gibt „ AnyTerritory “ die Standard-IANA-ID derjenigen IANA-IDs zurück, die keine territoriale Zuordnung haben, während „ World “ die Standard-IANA-ID für die angegebene „ windowsId “ in Gebieten zurückgibt, die keine spezifische Zuordnung dazu haben.

Ist das Ergebnis leer, gibt es keine für das angegebene „ territory “ spezifische IANA-ID für dieses „ windowsId “. In diesem Fall ist es sinnvoll, auf „ windowsIdToDefaultIanaId(windowsId) “ zurückzugreifen.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch ianaIdToWindowsId(), windowsIdToIanaIds() und territory().

[static] QList<QByteArray> QTimeZone::windowsIdToIanaIds(const QByteArray &windowsId)

Gibt alle IANA-IDs für eine bestimmte „ windowsId “ zurück.

Die zurückgegebene Liste ist alphabetisch sortiert.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch „ ianaIdToWindowsId()“ und „ windowsIdToDefaultIanaId()“.

[static] QList<QByteArray> QTimeZone::windowsIdToIanaIds(const QByteArray &windowsId, QLocale::Territory territory)

Gibt alle IANA-IDs für eine bestimmte „ windowsId “ und „ territory “ zurück.

Als Sonderfall wählt AnyTerritory jene IANA-IDs aus, die keinen territorialen Bezug haben, während World den Standardwert für die angegebene windowsId in Gebieten auswählt, die keinen spezifischen Bezug dazu haben.

Die zurückgegebene Liste ist nach der Häufigkeit der Verwendung sortiert, d. h., größere Zonen innerhalb eines Gebiets werden zuerst aufgeführt.

Diese Methode ist nur verfügbar, wenn die Funktion „ timezone “ aktiviert ist.

Siehe auch ianaIdToWindowsId(), windowsIdToDefaultIanaId() und territory().

[noexcept] QTimeZone &QTimeZone::operator=(QTimeZone &&other)

Mit „Move-Assign“ wird „ other “ dieser „ QTimeZone “-Instanz zugewiesen, wodurch das Eigentumsrecht an den Daten auf diese Instanz übertragen wird.

QTimeZone &QTimeZone::operator=(const QTimeZone &other)

Zuweisungsoperator: Weise „ other “ diesem Element zu.