QDateTime Class

Dokumentation der Member-Funktionen

QDateTime::QDateTime(QDate date, QTime time, const QTimeZone &timeZone, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

Erstellt ein Datums- und Zeitobjekt mit den angegebenen Werten „ date “ und „ time “ unter Verwendung der unter timeZone beschriebenen Zeitdarstellung.

Wenn „ date “ gültig ist und „ time “ nicht, wird die Uhrzeit auf Mitternacht gesetzt. Ist „ timeZone “ ungültig, ist das Datetime-Objekt ungültig. Beschreiben „ date “ und „ time “ einen Zeitpunkt nahe einem Übergang für „ timeZone “, steuert „ resolve “, wie diese Situation aufgelöst wird.

[noexcept] QDateTime::QDateTime()

Erzeugt ein Null-Datums-/Zeitformat, wobei nominell die Ortszeit verwendet wird.

Ein Null-Datums- und -Zeitwert ist ungültig, da sein Datum und seine Uhrzeit ungültig sind.

Siehe auch isValid(), setMSecsSinceEpoch(), setDate(), setTime() und setTimeZone().

[since 6.5] QDateTime::QDateTime(QDate date, QTime time, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

Erstellt ein Datums- und Zeitobjekt mit den angegebenen Werten „ date “ und „ time “ unter Verwendung der Ortszeit.

Wenn „ date “ gültig ist und „ time “ nicht, wird Mitternacht als Zeitpunkt verwendet. Wenn „ date “ und „ time “ einen Zeitpunkt beschreiben, der nahe an einem Übergang der Ortszeit liegt, steuert „ resolve “, wie diese Situation aufgelöst wird.

Diese Funktion wurde in Qt 6.5 eingeführt.

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

Erstellt eine Kopie des Datums- und Zeitwerts „ other “.

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

Verschiebt den Inhalt des temporären Datums- und Zeitobjekts „ other “ in dieses Objekt und versetzt „ other “ in einen nicht näher bezeichneten (aber korrekten) Zustand.

[noexcept] QDateTime::~QDateTime()

Löscht das Datums- und Zeitangabe-Objekt.

QDateTime QDateTime::addDays(qint64 ndays) const

Gibt ein „ QDateTime “-Objekt zurück, das ein Datums- und Zeitangabe-Objekt („datetime“ ndays ) enthält, das so viele Tage später liegt als die Datums- und Zeitangabe dieses Objekts (oder früher, wenn „ ndays “ negativ ist).

Wenn „ timeSpec()“ auf „ Qt::LocalTime “ oder „ Qt::TimeZone “ gesetzt ist und das resultierende Datum und die Uhrzeit in die Stunde des Übergangs von Standardzeit zu Sommerzeit fallen, liegt das Ergebnis knapp jenseits dieser Lücke in Richtung der Zeitumstellung. Wenn die Umstellung um 2 Uhr morgens erfolgt und die Uhr auf 3 Uhr morgens vorgestellt wird, wird das Ergebnis einer Zielzeit zwischen 2 und 3 Uhr morgens so angepasst, dass es vor 2 Uhr morgens (wenn ndays < 0) oder nach 3 Uhr morgens (ansonsten) liegt.

Siehe auch daysTo(), addMonths(), addYears(), addSecs() und Timezone transitions.

[since 6.4] QDateTime QDateTime::addDuration(std::chrono::milliseconds msecs) const

Gibt ein „ QDateTime “-Objekt zurück, das ein Datums- und Zeit msecs enthält, das um die angegebene Anzahl an Millisekunden nach dem Datums- und Zeit dieses Objekts liegt (oder früher, falls „ msecs “ negativ ist).

Ist dieser Zeitpunkt ungültig, wird ein ungültiger Zeitpunkt zurückgegeben.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch addMSecs(), msecsTo(), addDays(), addMonths() und addYears().

QDateTime QDateTime::addMSecs(qint64 msecs) const

Gibt ein „ QDateTime “-Objekt zurück, das ein Datums- und Zeit msecs enthält, das um die angegebene Anzahl an Millisekunden nach dem Datums- und Zeit dieses Objekts liegt (oder früher, falls „ msecs “ negativ ist).

Ist dieser Zeitpunkt ungültig, wird ein ungültiger Zeitpunkt zurückgegeben.

Siehe auch addSecs(), msecsTo(), addDays(), addMonths() und addYears().

QDateTime QDateTime::addMonths(int nmonths) const

Gibt ein „ QDateTime “-Objekt zurück, das ein Datums- und Zeit nmonths enthält, das Monate nach dem Datums- und Zeit dieses Objekts liegt (oder früher, wenn „ nmonths “ negativ ist).

Wenn „ timeSpec()“ auf „ Qt::LocalTime “ oder „ Qt::TimeZone “ gesetzt ist und das resultierende Datum und die Uhrzeit in die Stunde des Übergangs von Standardzeit zu Sommerzeit fallen, liegt das Ergebnis knapp jenseits dieser Lücke in Richtung der Zeitumstellung. Wenn die Umstellung um 2 Uhr morgens erfolgt und die Uhr auf 3 Uhr morgens vorgestellt wird, wird das Ergebnis einer Zielangabe zwischen 2 und 3 Uhr morgens so angepasst, dass es vor 2 Uhr morgens (wenn „ nmonths < 0 “) oder nach 3 Uhr morgens (ansonsten) liegt.

Siehe auch daysTo(), addDays(), addYears(), addSecs() und Timezone transitions.

QDateTime QDateTime::addSecs(qint64 s) const

Gibt ein „ QDateTime “-Objekt zurück, das ein Datums- und Zeit s -Objekt enthält, das Sekunden nach dem Datums- und Zeit dieses Objekts liegt (oder früher, wenn „ s “ negativ ist).

Ist dieser Zeitpunkt ungültig, wird ein ungültiger Zeitpunkt zurückgegeben.

Siehe auch addMSecs(), secsTo(), addDays(), addMonths() und addYears().

QDateTime QDateTime::addYears(int nyears) const

Gibt ein ` QDateTime `-Objekt zurück, das ein `datetime`- nyears enthält, das Jahre später liegt als der `datetime`-Wert dieses Objekts (oder früher, falls ` nyears ` negativ ist).

Wenn „ timeSpec()“ auf „ Qt::LocalTime “ oder „ Qt::TimeZone “ gesetzt ist und das resultierende Datum und die Uhrzeit in die Stunde des Übergangs von Standardzeit zu Sommerzeit fallen, liegt das Ergebnis knapp jenseits dieser Lücke in Richtung der Zeitumstellung. Wenn die Umstellung um 2 Uhr morgens erfolgt und die Uhr auf 3 Uhr morgens vorgestellt wird, wird das Ergebnis einer Zielangabe zwischen 2 Uhr und 3 Uhr morgens so angepasst, dass es vor 2 Uhr morgens (wenn nyears < 0) oder nach 3 Uhr morgens (ansonsten) liegt.

Siehe auch daysTo(), addDays(), addMonths(), addSecs() und Timezone transitions.

[static, since 6.5] QDateTime QDateTime::currentDateTime(const QTimeZone &zone)

Gibt das aktuelle Datum und die aktuelle Uhrzeit der Systemuhr zurück, wobei die unter zone beschriebene Zeitdarstellung verwendet wird. Wird zone weggelassen, wird die Ortszeit verwendet.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch currentDateTimeUtc(), QDate::currentDate(), QTime::currentTime() und toTimeZone().

[static] QDateTime QDateTime::currentDateTime()

[static] QDateTime QDateTime::currentDateTimeUtc()

Gibt das aktuelle Datum und die aktuelle Uhrzeit der Systemuhr zurück, ausgedrückt in UTC.

Entspricht ` currentDateTime(QTimeZone::UTC)`.

Siehe auch currentDateTime(), QDate::currentDate(), QTime::currentTime() und toTimeZone().

[static noexcept] qint64 QDateTime::currentMSecsSinceEpoch()

Gibt die aktuelle Anzahl an Millisekunden seit dem Beginn des Jahres 1970 in UTC zurück.

Diese Zahl entspricht der POSIX-Variablen `time_t`, wird jedoch in Millisekunden statt in Sekunden angegeben.

Siehe auch currentDateTime(), currentDateTimeUtc() und toTimeZone().

[static noexcept] qint64 QDateTime::currentSecsSinceEpoch()

Gibt die Anzahl der Sekunden seit dem Beginn des Jahres 1970 in UTC zurück.

Diese Zahl entspricht der POSIX-Variablen `time_t`.

Siehe auch ` currentMSecsSinceEpoch()`.

QDate QDateTime::date() const

Gibt den Datumsanteil des Datums- und Zeitwerts zurück.

Siehe auch setDate(), time() und timeRepresentation().

qint64 QDateTime::daysTo(const QDateTime &other) const

Gibt die Anzahl der Tage von diesem Datums- und Zeitwert bis zum Datums- und Zeitwert „ other “ zurück.

Die Anzahl der Tage wird als die Anzahl der Male gezählt, die zwischen diesem Zeitpunkt und dem Zeitpunkt „ other “ Mitternacht erreicht wird. Das bedeutet, dass eine Differenz von 10 Minuten zwischen 23:55 Uhr und 0:05 Uhr des nächsten Tages als ein Tag zählt.

Liegt der Zeitpunkt „ other “ vor diesem Zeitpunkt, ist der zurückgegebene Wert negativ. Ist einer der beiden Zeitpunkte ungültig, ist der Wert 0.

Beispiel:

QDateTime startDate(QDate(2012, 7, 6), QTime(8, 30, 0));
QDateTime endDate(QDate(2012, 7, 7), QTime(16, 30, 0));
qDebug() << "Days from startDate to endDate: " << startDate.daysTo(endDate);

startDate = QDateTime(QDate(2012, 7, 6), QTime(23, 55, 0));
endDate = QDateTime(QDate(2012, 7, 7), QTime(0, 5, 0));
qDebug() << "Days from startDate to endDate: " << startDate.daysTo(endDate);

qSwap(startDate, endDate); // Make endDate before startDate.
qDebug() << "Days from startDate to endDate: " << startDate.daysTo(endDate);

Siehe auch addDays(), secsTo() und msecsTo().

[static] QDateTime QDateTime::fromCFDate(CFDateRef date)

Erstellt ein neues ` QDateTime `-Objekt, das eine Kopie des `CFDate`-Objekts date enthält.

Siehe auch toCFDate().

[static] QDateTime QDateTime::fromMSecsSinceEpoch(qint64 msecs, const QTimeZone &timeZone)

Gibt ein Datums- und Zeitformat zurück, das einen Zeitpunkt darstellt, der der angegebenen Anzahl von Millisekunden msecs nach dem Beginn des Jahres 1970 in UTC entspricht, wie unter timeZone beschrieben. Die Standardzeitdarstellung ist die Ortszeit.

Beachten Sie, dass es mögliche Werte für ` msecs ` gibt, die außerhalb des gültigen Bereichs von ` QDateTime` liegen, sowohl negative als auch positive. Das Verhalten dieser Funktion ist für diese Werte undefiniert.

Siehe auch fromSecsSinceEpoch(), toMSecsSinceEpoch() und setMSecsSinceEpoch().

[static] QDateTime QDateTime::fromMSecsSinceEpoch(qint64 msecs)

[static] QDateTime QDateTime::fromNSDate(const NSDate *date)

Erstellt ein neues ` QDateTime `, das eine Kopie des `NSDate`-Objekts ` date` enthält.

Siehe auch toNSDate().

[static] QDateTime QDateTime::fromSecsSinceEpoch(qint64 secs, const QTimeZone &timeZone)

Gibt einen Datums- und Zeitwert zurück, der einen Zeitpunkt darstellt, der der angegebenen Anzahl von Sekunden secs nach dem Beginn des Jahres 1970 in UTC entspricht, wie unter timeZone beschrieben. Die Standardzeitdarstellung ist die Ortszeit.

Beachten Sie, dass es mögliche Werte für ` secs ` gibt, die außerhalb des gültigen Bereichs von ` QDateTime` liegen, sowohl negative als auch positive. Das Verhalten dieser Funktion ist für diese Werte undefiniert.

Siehe auch fromMSecsSinceEpoch(), toSecsSinceEpoch() und setSecsSinceEpoch().

[static] QDateTime QDateTime::fromSecsSinceEpoch(qint64 secs)

[static, since 6.4] QDateTime QDateTime::fromStdLocalTime(const std::chrono::local_time<std::chrono::milliseconds> &time)

Erzeugt ein Datums- und Zeitobjekt, dessen Datum und Uhrzeit der Anzahl der Millisekunden entsprechen, die durch time dargestellt werden, gezählt ab dem 01.01.1970 00:00:00.000 in Ortszeit (Qt::LocalTime).

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch ` toStdSysMilliseconds()` und ` fromMSecsSinceEpoch()`.

[static, since 6.4] template <typename Clock, typename Duration> QDateTime QDateTime::fromStdTimePoint(const std::chrono::time_point<Clock, Duration> &time) requires requires(const std::chrono::time_point<Clock, Duration> &t) { // the clock can be converted to system_clock std::chrono::clock_cast<std::chrono::system_clock>(t); // after the conversion to system_clock, the duration type // we get is convertible to milliseconds requires std::is_convertible_v< system_clock_cast_duration<Clock, Duration>, std::chrono::milliseconds >; }

Erzeugt ein Datums- und Zeitobjekt, das denselben Zeitpunkt wie time darstellt, wobei Qt::UTC als Zeitdarstellung verwendet wird.

Die Uhr von time muss mit std::chrono::system_clock kompatibel sein; insbesondere muss eine von std::chrono::clock_cast unterstützte Konvertierung vorhanden sein. Nach der Konvertierung muss der Dauer-Typ des Ergebnisses in std::chrono::milliseconds konvertierbar sein.

Ist dies nicht der Fall, muss der Aufrufer die erforderliche Uhrzeitkonvertierung in Richtung std::chrono::system_clock sowie die erforderliche Konvertierung des Dauer-Typs (Cast/Round/Floor/Ceil/...) durchführen, damit die Eingabe für diese Funktion die oben genannten Einschränkungen erfüllt.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch ` toStdSysMilliseconds()` und ` fromMSecsSinceEpoch()`.

[static, since 6.4] QDateTime QDateTime::fromStdTimePoint(const std::chrono::local_time<std::chrono::milliseconds> &time)

Erzeugt ein Datums- und Zeitobjekt, dessen Datum und Uhrzeit der Anzahl der Millisekunden entsprechen, die durch time dargestellt werden, gezählt ab dem 01.01.1970 00:00:00.000 in Ortszeit (Qt::LocalTime).

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch ` toStdSysMilliseconds()` und ` fromMSecsSinceEpoch()`.

[static, since 6.4] QDateTime QDateTime::fromStdTimePoint(std::chrono::time_point<std::chrono::system_clock, std::chrono::milliseconds> time)

Erzeugt ein Datums- und Zeitobjekt, das denselben Zeitpunkt wie ` time` darstellt, wobei ` Qt::UTC ` als Zeitdarstellung verwendet wird.

Diese Funktion wurde in Qt 6.4 eingeführt.

[static, since 6.4] QDateTime QDateTime::fromStdZonedTime(const std::chrono::zoned_time<std::chrono::milliseconds, const std::chrono::time_zone *> &time)

Erzeugt ein Datums- und Zeitobjekt, das denselben Zeitpunkt wie time darstellt. Das Ergebnis wird in der Zeitzone von time angegeben.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch QTimeZone, toStdSysMilliseconds() und fromMSecsSinceEpoch().

[static] QDateTime QDateTime::fromString(const QString &string, const QString &format, int baseYear, QCalendar cal)

Gibt den durch die Zeichenfolge „ string “ dargestellten Kalender „ QDateTime “ unter Verwendung des angegebenen Datumsformats „ format “ zurück oder eine ungültige Datums- und Uhrzeitangabe, falls die Zeichenfolge nicht geparst werden kann.

Verwendet den Kalender cal, falls angegeben, andernfalls den gregorianischen Kalender.

Wenn „ format “ nur die letzten beiden Ziffern eines Jahres angibt, werden zunächst die 100 Jahre, beginnend mit „ baseYear “, als Kandidaten berücksichtigt. Vor Version 6.7 gab es keinen Parameter „ baseYear “ und es wurde immer das Jahr 1900 verwendet. Dies ist die Standardeinstellung für „ baseYear “, wobei ein Jahr zwischen diesem Zeitpunkt und 1999 ausgewählt wird. In einigen Fällen können andere Felder dazu führen, dass das nächste oder vorherige Jahrhundert ausgewählt wird, um ein Ergebnis zu erhalten, das mit allen angegebenen Feldern konsistent ist. Weitere Informationen finden Sie unter „ QDate::fromString()“.

Zusätzlich zu den Ausdrücken, die in der Formatzeichenfolge zur Darstellung von Teilen des Datums und der Uhrzeit von QDate::fromString() und QTime::fromString() erkannt werden, unterstützt diese Methode:

Wenn kein Formatbezeichner „t“ vorhanden ist, wird die lokale Zeitzone des Systems verwendet. Die Standardwerte aller anderen Felder finden Sie unter QDate::fromString() und QTime::fromString().

Beispiel:

QDateTime dateTime = QDateTime::fromString("1.30.1", "M.d.s");
// dateTime is January 30 in 1900 at 00:00:01.
dateTime = QDateTime::fromString("12", "yy");
// dateTime is January 1 in 1912 at 00:00:00.

Jede nicht leere Zeichenfolge, die in einfache Anführungszeichen eingeschlossen ist, wird ebenfalls (ohne die Anführungszeichen) als Text behandelt und nicht als Ausdruck interpretiert. Zwei aufeinanderfolgende einfache Anführungszeichen („''“) werden als ein einfaches Anführungszeichen interpretiert, das in der Eingabe gefunden werden soll, und nicht als Beginn oder Ende einer wörtlichen Sequenz. Alle anderen Eingabezeichen werden als wörtlicher Text behandelt, der in der Eingabezeichenfolge gefunden werden soll. Beispiel:

QTime time1 = QTime::fromString("131", "HHh");
// time1 is 13:00:00
QTime time2 = QTime::fromString("1apA", "1amAM");
// time2 is 01:00:00

QDateTime dateTime2 = QDateTime::fromString("M1d1y9800:01:02",
                                            "'M'M'd'd'y'yyhh:mm:ss");
// dateTime is 1 January 1998 00:01:02

Wird das Format nicht eingehalten, wird ein ungültiger „ QDateTime “ zurückgegeben.

Wenn numerische Felder nebeneinander stehen und keine Trennzeichen vorhanden sind, um die Ziffernfolgen voneinander zu trennen, kann es zu Unklarheiten kommen, ob einige Felder, die einstellig sein dürfen, zwei Ziffern verwenden (da der darzustellende Wert größer als 9 ist). Wenn die Zuweisung von zwei Ziffern zu einem solchen Feld zu wenige Ziffern für andere Felder übrig lassen würde und die einstellige Lesart mit anderen Feldern übereinstimmt, kann diese Mehrdeutigkeit aufgelöst werden. Andernfalls (wenn mehr als ein Feld nur eine Ziffer haben darf und Ziffern übrig blieben, wenn jedes Feld nur eine Ziffer bekäme) wird eine Lösung bevorzugt, bei der den früheren Feldern zusätzliche Ziffern zugewiesen werden, anstatt den späteren Feldern, vorausgesetzt, die Daten bleiben konsistent. Zum Beispiel:

Die Ausdrücke ohne führende Nullen (d, M, h, m, s, z) verhalten sich „gierig“. Das bedeutet, dass sie zwei Stellen (bzw. drei im Fall von z) belegen, selbst wenn sie dadurch den zulässigen Bereich überschreiten und/oder zu wenige Stellen für andere Abschnitte übrig bleiben.

QDateTime dateTime = QDateTime::fromString("130", "Mm"); // January, 30 mins

Dies hätte 1. Januar 00:30.00 bedeuten können, aber das Feld „M“ beansprucht zwei Stellen.

Falsch angegebene Felder der „ string “ führen dazu, dass ein ungültiges „ QDateTime “ zurückgegeben wird. Es werden nur Datums- und Zeitangaben zwischen dem lokalen Jahresanfang 100 und dem Jahresende 9999 unterstützt. Beachten Sie, dass Datums- und Zeitangaben nahe den Grenzen dieses Bereichs in anderen Zeitzonen, insbesondere einschließlich UTC, je nach lokaler Zeitzone außerhalb des Bereichs liegen können (und somit als ungültig behandelt werden).

Siehe auch toString(), QDate::fromString(), QTime::fromString() und QLocale::toDateTime().

[static, since 6.0] QDateTime QDateTime::fromString(QStringView string, Qt::DateFormat format = Qt::TextDate)

Diese Funktion wurde in Qt 6.0 eingeführt.

[static] QDateTime QDateTime::fromString(const QString &string, Qt::DateFormat format = Qt::TextDate)

Gibt die durch „ string “ dargestellte „ QDateTime “ unter Verwendung der angegebenen „ format “ zurück oder, falls dies nicht möglich ist, ein ungültiges Datums- und Zeitformat.

Hinweis zu „ Qt::TextDate “: Es werden nur englische Kurzbezeichnungen für Monate (z. B. „Jan“ in der Kurzform oder „January“ in der Langform) erkannt.

Siehe auch „ toString()“ und „ QLocale::toDateTime()“.

[static, since 6.0] QDateTime QDateTime::fromString(QStringView string, QStringView format, QCalendar cal)

Diese Funktion wurde in Qt 6.0 eingeführt.

[static, since 6.7] QDateTime QDateTime::fromString(QStringView string, QStringView format, int baseYear = QLocale::DefaultTwoDigitBaseYear)

Verwendet ein standardmäßig konstruiertes ` QCalendar`.

Diese Funktion wurde in Qt 6.7 eingeführt.

[static, since 6.0] QDateTime QDateTime::fromString(const QString &string, QStringView format, QCalendar cal)

Diese Funktion wurde in Qt 6.0 eingeführt.

[static, since 6.7] QDateTime QDateTime::fromString(const QString &string, QStringView format, int baseYear = QLocale::DefaultTwoDigitBaseYear)

Verwendet ein standardmäßig initialisiertes ` QCalendar`.

Diese Funktion wurde in Qt 6.7 eingeführt.

[static] QDateTime QDateTime::fromString(const QString &string, const QString &format, QCalendar cal)

[static, since 6.7] QDateTime QDateTime::fromString(const QString &string, const QString &format, int baseYear = QLocale::DefaultTwoDigitBaseYear)

Verwendet ein standardmäßig konstruiertes ` QCalendar`.

Diese Funktion wurde in Qt 6.7 eingeführt.

[static, since 6.7] QDateTime QDateTime::fromString(QStringView string, QStringView format, int baseYear, QCalendar cal)

Diese Funktion wurde in Qt 6.7 eingeführt.

[static, since 6.0] QDateTime QDateTime::fromString(const QString &string, QStringView format, int baseYear, QCalendar cal)

Diese Funktion wurde in Qt 6.0 eingeführt.

bool QDateTime::isDaylightTime() const

Gibt zurück, ob dieses Datums- und Zeitangabe in die Sommerzeit fällt.

Wenn der „ Qt::TimeSpec “ nicht „ Qt::LocalTime “ oder „ Qt::TimeZone “ ist, wird immer „false“ zurückgegeben.

Siehe auch timeSpec().

bool QDateTime::isNull() const

Gibt „ true “ zurück, wenn sowohl das Datum als auch die Uhrzeit null sind; andernfalls wird „ false “ zurückgegeben. Ein null-Datum/Uhrzeit-Wert ist ungültig.

Siehe auch QDate::isNull(), QTime::isNull() und isValid().

bool QDateTime::isValid() const

Gibt „ true “ zurück, wenn dieses Datums- und Zeitangabe einen bestimmten Zeitpunkt darstellt, andernfalls „ false “.

Ein Datums- und Zeitwert ist gültig, wenn sowohl das Datum als auch die Uhrzeit gültig sind und die verwendete Zeitdarstellung ihrer Kombination eine gültige Bedeutung verleiht. Wenn es sich bei der Zeitdarstellung um eine bestimmte Zeitzone oder Ortszeit handelt, kann es an manchen Tagen vorkommen, dass die Zeitzone in ihrer Darstellung bestimmte Zeitpunkte überspringt, beispielsweise wenn bei der Umstellung auf Sommerzeit eine Stunde übersprungen wird (typischerweise während einer Nacht im Frühjahr). Wenn beispielsweise die Sommerzeit um 2:00 Uhr endet und die Uhr auf 3:00 Uhr vorgestellt wird, sind Datums- und Zeitangaben von 02:00:00 bis 02:59:59,999 an diesem Tag ungültig.

Siehe auch QDateTime::YearRange, QDate::isValid() und QTime::isValid().

qint64 QDateTime::msecsTo(const QDateTime &other) const

Gibt die Anzahl der Millisekunden zwischen diesem Datums-/Zeitwert und dem Datums-/Zeitwert „ other “ zurück.

Vor dem Vergleich werden die beiden Datums- und Zeitangaben in „ Qt::UTC “ umgewandelt, um sicherzustellen, dass das Ergebnis korrekt ist, falls für eine der beiden Datums- und Zeitangaben die Sommerzeit (DST) gilt, für die andere jedoch nicht.

Wenn der Datums- und Zeitwert „ other “ vor diesem Datums- und Zeitwert liegt, ist der zurückgegebene Wert negativ. Gibt 0 zurück, wenn einer der beiden Datums- und Zeitwerte ungültig ist.

Siehe auch addMSecs(), daysTo() und QTime::msecsTo().

int QDateTime::offsetFromUtc() const

Gibt den Offset dieses Datums- und Zeitwerts gegenüber UTC in Sekunden zurück.

Das Ergebnis hängt von ` timeSpec()` ab:

• Qt::UTC Der Offset beträgt 0.
• Qt::OffsetFromUTC Der Offset entspricht dem ursprünglich festgelegten Wert.
• Qt::LocalTime Der Offset der Ortszeit gegenüber UTC wird zurückgegeben.
• Qt::TimeZone Der von der Zeitzone verwendete Versatz wird zurückgegeben.

Bei den letzten beiden Fällen wird der Offset zum aktuellen Datum und zur aktuellen Uhrzeit unter Berücksichtigung der Sommerzeit-Verschiebung zurückgegeben. Der Offset ist die Differenz zwischen der Ortszeit oder der Zeit in der angegebenen Zeitzone und der UTC-Zeit; er ist positiv in Zeitzonen, die vor der UTC liegen (östlich des Nullmeridians), und negativ in Zeitzonen, die hinter der UTC liegen (westlich des Nullmeridians).

Siehe auch setTimeZone().

qint64 QDateTime::secsTo(const QDateTime &other) const

Gibt die Anzahl der Sekunden zwischen diesem Datums- und Zeitwert und dem Datums- und Zeitwert „ other “ zurück.

Vor dem Vergleich werden die beiden Datums- und Zeitangaben in „ Qt::UTC “ umgewandelt, um sicherzustellen, dass das Ergebnis korrekt ist, falls für eine der beiden Datums- und Zeitangaben die Sommerzeit (DST) gilt, für die andere jedoch nicht.

Wenn der Zeitpunkt „ other “ vor diesem Zeitpunkt liegt, ist der zurückgegebene Wert negativ. Es wird 0 zurückgegeben, wenn einer der beiden Zeitpunkte ungültig ist.

Beispiel:

QDateTime now = QDateTime::currentDateTime();
QDateTime xmas(QDate(now.date().year(), 12, 25).startOfDay());
qDebug("There are %d seconds to Christmas", now.secsTo(xmas));

Siehe auch addSecs(), daysTo() und QTime::secsTo().

void QDateTime::setDate(QDate date, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

Setzt den Datumsanteil dieses Datums- und Zeitwerts auf „ date “.

Wenn noch keine Uhrzeit festgelegt ist, wird diese auf Mitternacht gesetzt. Ist date ungültig, wird diese QDateTime ungültig.

Wenn „ date “ und „ time()“ einen Zeitpunkt beschreiben, der nahe an einem Übergang in der Zeitdarstellung dieses Datums- und Zeitwerts liegt, steuert „ resolve “, wie diese Situation aufgelöst wird.

Siehe auch date(), setTime() und setTimeZone().

void QDateTime::setMSecsSinceEpoch(qint64 msecs)

Legt das Datums- und Zeitformat so fest, dass es einen Zeitpunkt darstellt, der eine bestimmte Anzahl von Millisekunden ( msecs) nach dem Beginn des Jahres 1970 in UTC liegt.

Auf Systemen, die keine Zeitzonen unterstützen, verhält sich diese Funktion so, als ob die Ortszeit Qt::UTC wäre.

Beachten Sie, dass die Übergabe des Minimums von qint64 (std::numeric_limits<qint64>::min()) an msecs zu undefiniertem Verhalten führt.

Siehe auch setSecsSinceEpoch(), toMSecsSinceEpoch() und fromMSecsSinceEpoch().

void QDateTime::setSecsSinceEpoch(qint64 secs)

Legt das Datums- und Zeitformat so fest, dass es einen Zeitpunkt darstellt, der eine bestimmte Anzahl von Sekunden ( secs) nach dem Beginn des Jahres 1970 in UTC liegt.

Auf Systemen, die keine Zeitzonen unterstützen, verhält sich diese Funktion so, als ob die Ortszeit Qt::UTC wäre.

Siehe auch setMSecsSinceEpoch(), toSecsSinceEpoch() und fromSecsSinceEpoch().

void QDateTime::setTime(QTime time, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

Setzt den Zeitanteil dieses Datums/Zeitpunkts auf time. Ist time ungültig, setzt diese Funktion den Wert auf Mitternacht. Daher ist es möglich, jede in einem QDateTime festgelegte Zeit zu löschen, indem man sie auf den Standardwert QTime setzt:

QDateTime dt = QDateTime::currentDateTime();
dt.setTime(QTime());

Wenn „ date()“ und „ time “ einen Zeitpunkt beschreiben, der nahe an einem Übergang für die Zeitdarstellung dieses Datums und dieser Uhrzeit liegt, steuert „ resolve “, wie diese Situation aufgelöst wird.

Siehe auch time(), setDate() und setTimeZone().

void QDateTime::setTimeZone(const QTimeZone &toZone, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

Setzt die in diesem Datums- und Zeitwert verwendete Zeitzone auf „ toZone “.

Das Datums- und Zeitobjekt kann sich auf einen anderen Zeitpunkt beziehen. Es verwendet die Zeitdarstellung von toZone, was die Bedeutung der unveränderten Methoden date() und time() verändern kann.

Ist toZone ungültig, ist auch die Datums- und Zeitangabe ungültig. Andernfalls stimmt der Wert von timeSpec() dieser Datums- und Zeitangabe nach dem Aufruf mit toZone.timeSpec() überein.

Wenn date() und time() einen Zeitpunkt beschreiben, der nahe an einem Übergang für toZone liegt, steuert resolve, wie diese Situation aufgelöst wird.

Siehe auch timeRepresentation(), timeZone() und Qt::TimeSpec.

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

Tauscht dieses Datums- und Zeitangabe mit „ other “ aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

QTime QDateTime::time() const

Gibt den Zeitanteil des Datums- und Zeitwerts zurück.

Siehe auch setTime(), date() und timeRepresentation().

[since 6.5] QTimeZone QDateTime::timeRepresentation() const

Gibt einen „ QTimeZone “ zurück, der angibt, wie diese Datums- und Zeitangabe die Zeit darstellt.

Der Wert von ` timeSpec()` des zurückgegebenen ` QTimeZone ` stimmt mit dem dieses Datums- und Zeitwerts überein; wenn er nicht ` Qt::TimeZone ` ist, dann ist das zurückgegebene ` QTimeZone ` eine Zeitdarstellung. Wenn ihr ` timeSpec()` den Wert ` Qt::OffsetFromUTC` hat, liefert die Methode `fixedSecondsAheadOfUtc()` des zurückgegebenen ` QTimeZone` den Offset. Wenn ` timeSpec()` den Wert ` Qt::TimeZone` hat, ist das ` QTimeZone `-Objekt selbst die vollständige Darstellung dieser Zeitzone.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch ` timeZone()`, ` setTimeZone()` und ` QTimeZone::asBackendZone()`.

Qt::TimeSpec QDateTime::timeSpec() const

Gibt die Zeitangabe des Datums- und Zeitwerts zurück.

Dabei wird die Zeitdarstellung als Ortszeit, UTC, als fester Versatz gegenüber UTC (ohne Angabe des Versatzes) oder als Zeitzone (ohne Angabe der Details dieser Zeitzone) klassifiziert. Entspricht timeRepresentation().timeSpec().

Siehe auch „ setTimeZone()“, „ timeRepresentation()“, „ date()“ und „ time()“.

QTimeZone QDateTime::timeZone() const

Gibt die Zeitzone des Datums- und Zeitwerts zurück.

Das Ergebnis entspricht dem von ` timeRepresentation().asBackendZone()`. In allen Fällen ist das Ergebnis von ` timeSpec()` ` Qt::TimeZone`.

Wenn ` timeSpec()` ` Qt::LocalTime` ist, beschreibt das Ergebnis die Ortszeit zum Zeitpunkt des Aufrufs dieser Methode. Es spiegelt keine späteren Änderungen der Systemzeitzone wider, selbst wenn das ` QDateTime `, aus dem es gewonnen wurde, dies tut.

Siehe auch ` timeRepresentation()`, ` setTimeZone()`, ` Qt::TimeSpec` und ` QTimeZone::asBackendZone()`.

QString QDateTime::timeZoneAbbreviation() const

Gibt die Zeitzonenabkürzung für diesen Datums- und Zeitwert zurück.

Die zurückgegebene Zeichenfolge hängt von ` timeSpec()` ab:

• Bei ` Qt::UTC ` lautet sie „UTC“.
• Bei ` Qt::OffsetFromUTC ` hat sie das Format „UTC±00:00“.
• Bei ` Qt::LocalTime` wird das Hostsystem abgefragt.
• Bei ` Qt::TimeZone` wird das zugehörige ` QTimeZone `-Objekt abgefragt.

Siehe auch timeSpec() und QTimeZone::abbreviation().

CFDateRef QDateTime::toCFDate() const

Erstellt ein CFDate-Objekt aus einem „ QDateTime “.

Der Aufrufer ist Eigentümer des CFDate-Objekts und für dessen Freigabe verantwortlich.

Siehe auch fromCFDate().

QDateTime QDateTime::toLocalTime() const

Gibt eine Kopie dieses Datums- und Zeitwerts zurück, der in die Ortszeit umgerechnet wurde.

Das Ergebnis stellt denselben Zeitpunkt dar wie diese Datums- und Uhrzeitangabe und entspricht dieser.

Beispiel:

QDateTime UTC(QDateTime::currentDateTimeUtc());
QDateTime local(UTC.toLocalTime());
qDebug() << "UTC time is:" << UTC;
qDebug() << "Local time is:" << local;
qDebug() << "No difference between times:" << UTC.secsTo(local);

Siehe auch toTimeZone(), toUTC() und toOffsetFromUtc().

qint64 QDateTime::toMSecsSinceEpoch() const

Gibt das Datums- und Zeitformat als Anzahl der Millisekunden seit dem Beginn des Jahres 1970 in UTC zurück.

Auf Systemen, die keine Zeitzonen unterstützen, verhält sich diese Funktion so, als wäre die Ortszeit „ Qt::UTC “.

Das Verhalten dieser Funktion ist undefiniert, wenn das in diesem Objekt gespeicherte Datums- und Zeitformat ungültig ist. Für alle gültigen Datumsangaben gibt diese Funktion jedoch einen eindeutigen Wert zurück.

Siehe auch toSecsSinceEpoch(), setMSecsSinceEpoch() und fromMSecsSinceEpoch().

NSDate *QDateTime::toNSDate() const

Erstellt ein NSDate-Objekt aus einem „ QDateTime “.

Das NSDate-Objekt wird automatisch freigegeben.

Siehe auch ` fromNSDate()`.

QDateTime QDateTime::toOffsetFromUtc(int offsetSeconds) const

Gibt eine Kopie dieses Datums- und Zeitwerts zurück, der gemäß der Spezifikation „ Qt::OffsetFromUTC “ mit dem angegebenen „ offsetSeconds “ konvertiert wurde. Entspricht „ toTimeZone(QTimeZone::fromSecondsAheadOfUtc(offsetSeconds)) “.

Wenn der Wert von ` offsetSeconds ` gleich 0 ist, wird ein UTC-Datums- und Zeitwert zurückgegeben.

Das Ergebnis stellt denselben Zeitpunkt dar wie dieses Datums- und Zeitangabe und ist mit dieser identisch.

Siehe auch offsetFromUtc() und toTimeZone().

qint64 QDateTime::toSecsSinceEpoch() const

Gibt das Datums- und Zeitformat als Anzahl der Sekunden seit dem Beginn des Jahres 1970 in UTC zurück.

Auf Systemen, die keine Zeitzonen unterstützen, verhält sich diese Funktion so, als ob die Ortszeit „ Qt::UTC “ wäre.

Das Verhalten dieser Funktion ist undefiniert, wenn das in diesem Objekt gespeicherte Datums- und Zeitformat ungültig ist. Für alle gültigen Datumsangaben gibt diese Funktion jedoch einen eindeutigen Wert zurück.

Siehe auch toMSecsSinceEpoch(), fromSecsSinceEpoch() und setSecsSinceEpoch().

[since 6.4] std::chrono::sys_time<std::chrono::milliseconds> QDateTime::toStdSysMilliseconds() const

Wandelt dieses Datetime-Objekt in den entsprechenden Zeitpunkt um, ausgedrückt in Millisekunden, wobei „ std::chrono::system_clock “ als Uhr verwendet wird.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch „ fromStdTimePoint()“ und „ toMSecsSinceEpoch()“.

[since 6.4] std::chrono::sys_seconds QDateTime::toStdSysSeconds() const

Wandelt dieses Datetime-Objekt in den entsprechenden, in Sekunden ausgedrückten Zeitpunkt um, wobei „ std::chrono::system_clock “ als Uhr verwendet wird.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch „ fromStdTimePoint()“ und „ toSecsSinceEpoch()“.

Gibt das Datums- und Zeitformat als Zeichenkette zurück. Der Parameter „ format “ bestimmt das Format der Ergebniszeichenkette. Wird „ cal “ angegeben, legt dieser Parameter den Kalender fest, der zur Darstellung des Datums verwendet wird; standardmäßig ist dies der gregorianische Kalender. Vor Qt 5.14 gab es keinen „ cal “-Parameter, und es wurde stets der gregorianische Kalender verwendet. Siehe QTime::toString() und QDate::toString() für die unterstützten Spezifizierer für Uhrzeit bzw. Datum im Parameter „ format “.

Jede nicht leere Zeichenfolge, die in einfache Anführungszeichen gesetzt ist, wird wörtlich in die Ausgabekette übernommen (ohne die Anführungszeichen), selbst wenn sie Formatierungszeichen enthält. Zwei aufeinanderfolgende einfache Anführungszeichen („''“) werden in der Ausgabe durch ein einzelnes einfaches Anführungszeichen ersetzt, anstatt eine wörtliche Zeichenfolge einzuleiten oder zu beenden. Alle anderen Zeichen in der Formatzeichenfolge werden wörtlich in die Ausgabekette übernommen.

Formate ohne Trennzeichen (z. B. „ddMM“) werden unterstützt, müssen jedoch mit Vorsicht verwendet werden, da die resultierenden Zeichenfolgen nicht immer zuverlässig lesbar sind (wenn beispielsweise „dM“ zu „212“ führt, könnte dies sowohl den 2. Dezember als auch den 21. Februar bedeuten).

Beispiele für Formatzeichenfolgen (unter der Annahme, dass das „ QDateTime “ 21. Mai 2001 14:13:09.120 lautet):

Ist das Datums- und Zeitformat ungültig, wird eine leere Zeichenkette zurückgegeben.

Siehe auch fromString(), QDate::toString(), QTime::toString() und QLocale::toString().

QString QDateTime::toString(QStringView format) const

QString QDateTime::toString(Qt::DateFormat format = Qt::TextDate) const

Gibt das Datums- und Zeitformat als Zeichenkette in dem angegebenen Format „ format “ zurück.

format Wenn das Format „ Qt::TextDate “ lautet, wird die Zeichenkette standardmäßig formatiert. Die Namen der Tage und Monate werden auf Englisch angezeigt. Ein Beispiel für diese Formatierung ist „Wed May 20 03:40:13 1998“. Informationen zur lokalisierten Formatierung finden Sie unter QLocale::toString().

Wenn der Wert von ` format ` ` Qt::ISODate` ist, entspricht das Zeichenfolgenformat der erweiterten ISO 8601-Spezifikation für die Darstellung von Datums- und Zeitangaben und hat die Form `yyyy-MM-ddTHH:mm:ss[Z|±HH:mm]`, abhängig vom Wert von ` timeSpec()` des Parameters ` QDateTime`. Wenn der Wert von ` timeSpec()` Qt::UTC ist, wird „Z“ an die Zeichenkette angehängt; wenn der Wert von ` timeSpec()` Qt::OffsetFromUTC ist, wird der Offset in Stunden und Minuten gegenüber UTC an die Zeichenkette angehängt. Um Millisekunden in das ISO-8601-Datum einzubeziehen, verwenden Sie den Befehl „ format “ Qt::ISODateWithMs, der dem Format „yyyy-MM-ddTHH:mm:ss.zzz[Z|±HH:mm]“ entspricht.

Wenn der Parameter „ format “ auf „ Qt::RFC2822Date “ gesetzt ist, wird die Zeichenkette gemäß RFC 2822 formatiert.

Ist das Datums- und Zeitformat ungültig, wird eine leere Zeichenkette zurückgegeben.

Siehe auch fromString(), QDate::toString(), QTime::toString() und QLocale::toString().

QString QDateTime::toString(const QString &format) const

QDateTime QDateTime::toTimeZone(const QTimeZone &timeZone) const

Gibt eine Kopie dieses Datums- und Zeitwerts zurück, der in das angegebene Format „ timeZone “ konvertiert wurde.

Das Ergebnis stellt denselben Zeitpunkt dar wie diese Datums- und Uhrzeitangabe und ist mit ihr identisch.

Das Ergebnis beschreibt den Zeitpunkt anhand der Zeitdarstellung von „ timeZone “. Zum Beispiel:

QDateTime local(QDateTime::currentDateTime());
QDateTime UTC(local.toTimeZone(QTimeZone::UTC));
qDebug() << "Local time is:" << local;
qDebug() << "UTC time is:" << UTC;
qDebug() << "No difference between times represented:" << local.secsTo(UTC);

Wenn „ timeZone “ ungültig ist, ist auch das Datums- und Zeitformat ungültig. Andernfalls stimmt die Funktion „ timeSpec()“ des zurückgegebenen Datums- und Zeitformats mit „ timeZone.timeSpec() “ überein.

Siehe auch timeRepresentation(), toLocalTime(), toUTC() und toOffsetFromUtc().

QDateTime QDateTime::toUTC() const

Gibt eine Kopie dieses Datums- und Zeitwerts zurück, der in UTC umgewandelt wurde.

Das Ergebnis stellt denselben Zeitpunkt dar wie diese Datums- und Uhrzeitangabe und entspricht dieser.

Beispiel:

QDateTime local(QDateTime::currentDateTime());
QDateTime UTC(local.toUTC());
qDebug() << "Local time is:" << local;
qDebug() << "UTC time is:" << UTC;
qDebug() << "No difference between times:" << local.secsTo(UTC);

Siehe auch toTimeZone(), toLocalTime() und toOffsetFromUtc().

[since 6.4] QDateTime &QDateTime::operator+=(std::chrono::milliseconds duration)

Ändert dieses Datetime-Objekt, indem die angegebene Zeitverschiebung „ duration “ hinzugefügt wird.

Das aktualisierte Objekt liegt später, wenn ` duration ` positiv ist, oder früher, wenn es negativ ist. Gibt eine Referenz auf dieses Datetime-Objekt zurück.

Ist dieses Datetime-Objekt ungültig, hat diese Funktion keine Auswirkung.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch ` addMSecs()`.

[since 6.4] QDateTime &QDateTime::operator-=(std::chrono::milliseconds duration)

Ändert dieses Datetime-Objekt, indem der angegebene Wert „ duration “ abgezogen wird.

Das aktualisierte Objekt liegt früher, wenn „ duration “ positiv ist, oder später, wenn es negativ ist. Gibt eine Referenz auf dieses Datetime-Objekt zurück.

Ist dieses Datetime-Objekt ungültig, hat diese Funktion keine Auswirkung.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch ` addMSecs`.

[noexcept] QDateTime &QDateTime::operator=(const QDateTime &other)

Kopiert das Datums- und Zeitangabe-Objekt „ other “ in dieses Objekt und gibt diese Kopie zurück.