QDateTime Class

Dokumentation der Mitgliedsfunktionen

Gibt die Datetime als Zeichenkette zurück. Der Parameter format bestimmt das Format der Ergebniszeichenkette. Wenn cal übergeben wird, bestimmt er den Kalender, der zur Darstellung des Datums verwendet wird; der Standardwert ist Gregorianisch. Vor Qt 5.14 gab es keinen cal Parameter und der Gregorianische Kalender wurde immer verwendet. Siehe QTime::toString() und QDate::toString() für die unterstützten Spezifizierer für Zeit bzw. Datum im Parameter format.

Jede in einfache Anführungszeichen eingeschlossene Zeichenfolge wird wortwörtlich in die Ausgabezeichenfolge aufgenommen (ohne Anführungszeichen), auch wenn sie Formatierungszeichen enthält. Zwei aufeinanderfolgende einfache Anführungszeichen ("''") werden in der Ausgabe durch ein einfaches Anführungszeichen ersetzt. Alle anderen Zeichen in der Formatzeichenfolge werden wortwörtlich in die Ausgabezeichenfolge übernommen.

Formate ohne Trennzeichen (z. B. "ddMM") werden unterstützt, müssen aber mit Vorsicht verwendet werden, da die resultierenden Zeichenketten nicht immer zuverlässig lesbar sind (wenn z. B. "dM" "212" ergibt, könnte dies entweder den 2. Dezember oder den 21. Februar bedeuten).

Beispiel für formatierte Zeichenfolgen (unter der Annahme, dass QDateTime der 21. Mai 2001 14:13:09.120 ist):

Wenn die Datumsangabe ungültig ist, wird eine leere Zeichenkette zurückgegeben.

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

[noexcept] QDateTime::QDateTime()

Konstruiert eine null datetime, die nominell die lokale Zeit verwendet.

Eine null datetime ist ungültig, da ihr Datum und ihre Uhrzeit ungültig sind.

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

[until 6.9] QDateTime::QDateTime(QDate date, QTime time, Qt::TimeSpec spec, int offsetSeconds = 0)

Diese Funktion soll in Version 6.9 nicht mehr verwendet werden.

Verwenden Sie QDateTime(date, time) oder QDateTime(date, time, QTimeZone::fromSecondsAheadOfUtc(offsetSeconds)).

Konstruiert eine Datetime mit den angegebenen date und time, wobei die Zeitdarstellung durch spec und offsetSeconds Sekunden impliziert wird.

Wenn date gültig ist und time nicht, wird die Zeit auf Mitternacht gesetzt.

Wenn spec nicht Qt::OffsetFromUTC ist, wird offsetSeconds ignoriert. Wenn spec gleich Qt::OffsetFromUTC und offsetSeconds gleich 0 ist, wird timeSpec() auf Qt::UTC gesetzt, d. h. ein Offset von 0 Sekunden.

Wenn spec Qt::TimeZone ist, wird die Angabe auf Qt::LocalTime gesetzt, d. h. auf die aktuelle Systemzeitzone. Um eine Qt::TimeZone datetime zu erstellen, verwenden Sie den richtigen Konstruktor.

Wenn date außerhalb des Bereichs der durch QDateTime darstellbaren Datumsangaben liegt, ist das Ergebnis ungültig. Wenn spec gleich Qt::LocalTime ist und die Zeitzone des Systems das angegebene Datum und die Uhrzeit überspringt, ist das Ergebnis ungültig.

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

Konstruiert eine Datetime mit den angegebenen date und time, wobei die durch timeZone beschriebene Zeitdarstellung verwendet wird.

Wenn date gültig ist und time nicht, wird die Uhrzeit auf Mitternacht gesetzt. Wenn timeZone ungültig ist, ist auch die Datetime ungültig. Wenn date und time einen Zeitpunkt beschreiben, der nahe an einem Übergang für timeZone liegt, steuert resolve, wie diese Situation aufgelöst wird.

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

Dies ist eine überladene Funktion.

Konstruiert eine Datetime mit den angegebenen date und time, wobei die lokale Zeit verwendet wird.

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

Diese Funktion wurde in Qt 6.5 eingeführt.

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

Konstruiert eine Kopie der other datetime.

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

Verschiebt den Inhalt des temporären other datetime in dieses Objekt und lässt other in einem nicht spezifizierten (aber korrekten) Zustand.

[noexcept] QDateTime::~QDateTime()

Zerstört die Zeitangabe.

QDateTime QDateTime::addDays(qint64 ndays) const

Gibt ein QDateTime Objekt zurück, das eine Datumszeit ndays Tage später als die Datumszeit dieses Objekts enthält (oder früher, wenn ndays negativ ist).

Wenn timeSpec() Qt::LocalTime oder Qt::TimeZone ist und das resultierende Datum und die Uhrzeit in die Stunde des Übergangs von der Standardzeit zur Sommerzeit fallen, dann liegt das Ergebnis genau hinter dieser Lücke, in Richtung der Umstellung. Wenn die Umstellung um 2 Uhr morgens erfolgt und die Uhr auf 3 Uhr vorwärts geht, wird das Ergebnis der Einstellung zwischen 2 und 3 Uhr so angepasst, dass es vor 2 Uhr (falls ndays < 0) oder nach 3 Uhr (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 einen Zeitpunkt msecs enthält, der um Millisekunden später als der Zeitpunkt dieses Objekts liegt (oder früher, wenn msecs negativ ist).

Wenn dieser Zeitpunkt ungültig ist, 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 einen Zeitpunkt msecs enthält, der um Millisekunden später als der Zeitpunkt dieses Objekts liegt (oder früher, wenn msecs negativ ist).

Wenn dieser Zeitpunkt ungültig ist, 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 eine Datumszeit nmonths Monate später als die Datumszeit dieses Objekts enthält (oder früher, wenn nmonths negativ ist).

Wenn timeSpec() Qt::LocalTime oder Qt::TimeZone ist und das resultierende Datum und die Uhrzeit in die Stunde des Übergangs von der Standardzeit zur Sommerzeit fallen, dann liegt das Ergebnis genau hinter dieser Lücke, in Richtung der Umstellung. Wenn die Umstellung um 2 Uhr morgens erfolgt und die Uhr auf 3 Uhr vorwärts geht, wird das Ergebnis der Einstellung zwischen 2 und 3 Uhr so angepasst, dass es vor 2 Uhr (falls nmonths < 0) oder nach 3 Uhr (ansonsten) liegt.

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

QDateTime QDateTime::addSecs(qint64 s) const

Gibt ein QDateTime Objekt zurück, das eine Datetime s Sekunden später als die Datetime dieses Objekts enthält (oder früher, wenn s negativ ist).

Ist diese Datumszeit ungültig, wird eine ungültige Datumszeit zurückgegeben.

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

QDateTime QDateTime::addYears(int nyears) const

Gibt ein QDateTime Objekt zurück, das eine Datumszeit nyears Jahre später als die Datumszeit dieses Objekts enthält (oder früher, wenn nyears negativ ist).

Wenn timeSpec() Qt::LocalTime oder Qt::TimeZone ist und das resultierende Datum und die Uhrzeit in die Stunde des Übergangs von der Standardzeit zur Sommerzeit fallen, dann liegt das Ergebnis genau hinter dieser Lücke, in Richtung der Umstellung. Wenn die Umstellung um 2 Uhr morgens erfolgt und die Uhr auf 3 Uhr vorgeht, wird das Ergebnis der Einstellung zwischen 2 Uhr und 3 Uhr so angepasst, dass es vor 2 Uhr (wenn nyears < 0) oder nach 3 Uhr (sonst) liegt.

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

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

Gibt die aktuelle Uhrzeit der Systemuhr zurück, unter Verwendung der durch zone beschriebenen Zeitdarstellung. Wenn zone nicht angegeben wird, wird die lokale Zeit verwendet.

Diese Funktion wurde in Qt 6.5 eingeführt.

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

[static] QDateTime QDateTime::currentDateTime()

Dies ist eine überladene Funktion.

[static] QDateTime QDateTime::currentDateTimeUtc()

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

Äquivalent zu currentDateTime(QTimeZone::UTC).

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

[static noexcept] qint64 QDateTime::currentMSecsSinceEpoch()

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

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

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

[static noexcept] qint64 QDateTime::currentSecsSinceEpoch()

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

Diese Zahl ist wie die POSIX-Variable time_t.

Siehe auch currentMSecsSinceEpoch().

QDate QDateTime::date() const

Gibt den Datumsteil von datetime zurück.

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

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

Gibt die Anzahl der Tage zwischen diesem Zeitpunkt und dem Zeitpunkt other zurück. Die Anzahl der Tage wird so gezählt, wie oft Mitternacht zwischen diesem Zeitpunkt und dem Zeitpunkt other erreicht wird. Das bedeutet, dass ein Unterschied von 10 Minuten zwischen 23:55 und 0:05 am nächsten Tag als ein Tag zählt.

Liegt der Zeitpunkt other vor diesem Zeitpunkt, ist der zurückgegebene Wert negativ.

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)

Konstruiert ein neues QDateTime, das eine Kopie des CFDate date enthält.

Siehe auch toCFDate().

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

Gibt eine Datetime zurück, die einen Zeitpunkt mit der angegebenen Anzahl msecs von Millisekunden nach dem Beginn des Jahres 1970 in UTC darstellt, wie durch 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 negativ als auch positiv. Das Verhalten dieser Funktion ist für diese Werte undefiniert.

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

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

Dies ist eine überladene Funktion.

[static, until 6.9] QDateTime QDateTime::fromMSecsSinceEpoch(qint64 msecs, Qt::TimeSpec spec, int offsetSeconds = 0)

Diese Funktion soll in Version 6.9 veraltet sein.

Dies ist eine überladene Funktion.

Übergeben Sie stattdessen QTimeZone, oder lassen Sie spec und offsetSeconds weg.

Gibt eine Datetime zurück, die einen Zeitpunkt mit der angegebenen Anzahl msecs von Millisekunden nach dem Beginn des Jahres 1970 in UTC darstellt, wie durch spec und offsetSeconds beschrieben.

Beachten Sie, dass es für msecs mögliche Werte 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.

Wenn spec nicht Qt::OffsetFromUTC ist, wird offsetSeconds ignoriert. Wenn spec gleich Qt::OffsetFromUTC und offsetSeconds gleich 0 ist, wird Qt::UTC als spec verwendet, da UTC einen Null-Offset hat.

Wenn spec Qt::TimeZone ist, wird Qt::LocalTime an seiner Stelle verwendet, was der Verwendung der aktuellen Systemzeitzone entspricht (aber anders dargestellt wird).

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

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

Konstruiert ein neues QDateTime, das eine Kopie des NSDate date enthält.

Siehe auch toNSDate().

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

Gibt eine Datetime zurück, die einen Zeitpunkt mit der angegebenen Anzahl secs von Sekunden nach dem Beginn des Jahres 1970 in UTC darstellt, wie durch 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 negativ als auch positiv. Das Verhalten dieser Funktion ist für diese Werte undefiniert.

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

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

Dies ist eine überladene Funktion.

[static, until 6.9] QDateTime QDateTime::fromSecsSinceEpoch(qint64 secs, Qt::TimeSpec spec, int offsetSeconds = 0)

Diese Funktion soll in Version 6.9 veraltet sein.

Dies ist eine überladene Funktion.

Übergeben Sie stattdessen QTimeZone, oder lassen Sie spec und offsetSeconds weg.

Gibt einen Zeitpunkt zurück, der die angegebene Anzahl secs von Sekunden nach dem Beginn des Jahres 1970 in UTC darstellt, wie durch spec und offsetSeconds beschrieben.

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

Wenn spec nicht Qt::OffsetFromUTC ist, wird offsetSeconds ignoriert. Wenn spec gleich Qt::OffsetFromUTC und offsetSeconds gleich 0 ist, wird Qt::UTC als spec verwendet, da UTC einen Null-Offset hat.

Wenn spec Qt::TimeZone ist, wird Qt::LocalTime an seiner Stelle verwendet, was der Verwendung der aktuellen Systemzeitzone entspricht (aber anders dargestellt wird).

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

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

Konstruiert eine datetime, deren Datum und Uhrzeit die durch time dargestellte Anzahl von Millisekunden sind, gezählt seit 1970-01-01T00:00:00.000 in lokaler Zeit (Qt::LocalTime).

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)

Konstruiert eine datetime, deren Datum und Uhrzeit die durch time dargestellte Anzahl von Millisekunden sind, gezählt seit 1970-01-01T00:00:00.000 in lokaler Zeit (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)

Konstruiert eine Datetime, die 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 existieren. Nach der Konvertierung muss der Dauertyp des Ergebnisses in std::chrono::milliseconds konvertierbar sein.

Ist dies nicht der Fall, muss der Aufrufer die notwendige Taktkonvertierung zu std::chrono::system_clock und die notwendige Konvertierung des Dauertyps (Cast/Round/Floor/Eceil/...) durchführen, so dass die Eingabe dieser Funktion die obigen Bedingungen erfüllt.

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)

Dies ist eine überladene Funktion.

Konstruiert eine datetime, die denselben Zeitpunkt wie time repräsentiert, wobei Qt::UTC als Zeitdarstellung verwendet wird.

Diese Funktion wurde in Qt 6.4 eingeführt.

[static, since 6.4] QDateTime QDateTime::fromStdZonedTime(const int &time)

Konstruiert eine Datetime, die denselben Zeitpunkt wie time darstellt. Das Ergebnis wird in der Zeitzone von time ausgedrückt.

Diese Funktion wurde in Qt 6.4 eingeführt.

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

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

Gibt die QDateTime zurück, die durch string repräsentiert wird, unter Verwendung der angegebenen format, oder eine ungültige Datumsangabe, wenn dies nicht möglich ist.

Hinweis für Qt::TextDate: Es werden nur englische kurze Monatsnamen (z. B. "Jan" in Kurzform oder "January" in Langform) erkannt.

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

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

Gibt die QDateTime zurück, die durch string repräsentiert wird, unter Verwendung der angegebenen format, oder eine ungültige Datetime, wenn die Zeichenkette nicht geparst werden kann.

Verwendet den Kalender cal, falls angegeben, sonst Gregorianisch.

Wenn format nur die letzten beiden Ziffern eines Jahres angibt, werden die 100 Jahre ab baseYear als erste Kandidaten berücksichtigt. Vor 6.7 gab es keinen Parameter baseYear und es wurde immer 1900 verwendet. Dies ist die Standardeinstellung für baseYear, wobei ein Jahr von damals bis 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. Siehe QDate::fromString() für Details.

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

Wenn der Formatierer "t" nicht vorhanden ist, wird die lokale Zeitzone des Systems verwendet. Für die Standardwerte aller anderen Felder siehe QDate::fromString() und QTime::fromString().

Ein 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.

Alle anderen Eingabezeichen werden als Text behandelt. Jede nicht leere Folge von Zeichen, die in einfache Anführungszeichen eingeschlossen sind, wird ebenfalls (ohne die Anführungszeichen) als Text behandelt und nicht als Ausdruck interpretiert.

QTime time1 = QTime::fromString("131", "HHh");
// time1 is 13:00:00
QTime time1 = QTime::fromString("1apA", "1amAM");
// time1 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

Wenn das Format nicht erfüllt ist, wird ein ungültiger QDateTime zurückgegeben. Wenn das Format erfüllt ist, aber string einen ungültigen Zeitpunkt darstellt (z. B. in einer Lücke, die durch einen Zeitzonenwechsel übersprungen wurde), wird ein gültiger QDateTime zurückgegeben, der einen nahegelegenen, gültigen Zeitpunkt darstellt.

Die Ausdrücke, die keine führenden Nullen haben (d, M, h, m, s, z), sind gierig. Das bedeutet, dass sie zwei Ziffern (oder drei für z) verwenden, auch wenn sie dadurch außerhalb des Bereichs liegen und/oder zu wenige Ziffern für andere Abschnitte übrig bleiben.

QDateTime dateTime = QDateTime::fromString("130", "Mm"); // invalid

Dies hätte 1. Januar 00:30.00 bedeuten können, aber das M nimmt zwei Ziffern.

Falsch angegebene Felder der string führen dazu, dass eine ungültige QDateTime zurückgegeben wird. Es werden nur Datumsangaben zwischen der Ortszeit Anfang des Jahres 100 und Ende des Jahres 9999 unterstützt. Beachten Sie, dass Datumsangaben in der Nähe der Enden dieses Bereichs in anderen Zeitzonen, insbesondere einschließlich UTC, je nach lokaler Zeitzone außerhalb des Bereichs liegen können (und daher 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)

Dies ist eine überladene Funktion.

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Dies ist eine überladene Funktion.

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Dies ist eine überladene Funktion.

Verwendet eine standardmäßig konstruierte QCalendar.

Diese Funktion wurde in Qt 6.7 eingeführt.

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

Dies ist eine überladene Funktion.

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)

Dies ist eine überladene Funktion.

Verwendet eine standardmäßig konstruierte QCalendar.

Diese Funktion wurde in Qt 6.7 eingeführt.

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

Dies ist eine überladene Funktion.

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

Dies ist eine überladene Funktion.

Verwendet eine standardmäßig konstruierte 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)

Dies ist eine überladene Funktion.

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)

Dies ist eine überladene Funktion.

Diese Funktion wurde in Qt 6.0 eingeführt.

bool QDateTime::isDaylightTime() const

Gibt zurück, ob dieser Zeitpunkt in die Sommerzeit fällt.

Wenn 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 datetime ist ungültig.

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

bool QDateTime::isValid() const

Gibt true zurück, wenn diese Datetime einen bestimmten Zeitpunkt darstellt, andernfalls false.

Eine Datetime 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 Daten Zeiten geben, die die Zone in ihrer Darstellung überspringt, z. B. wenn eine Sommerzeitumstellung eine Stunde überspringt (typischerweise während einer Nacht im Frühling). Wenn beispielsweise die Sommerzeit um 2 Uhr morgens endet und die Uhr auf 3 Uhr vorrückt, sind Datumsangaben 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 Zeitpunkt und dem Zeitpunkt other zurück. Wenn der Zeitpunkt other vor diesem Zeitpunkt liegt, ist der zurückgegebene Wert negativ.

Vor dem Vergleich werden die beiden Datumszeiten in Qt::UTC konvertiert, um sicherzustellen, dass das Ergebnis korrekt ist, wenn für eine der beiden Datumszeiten die Sommerzeit gilt, für die andere jedoch nicht.

Gibt 0 zurück, wenn eine der beiden Datumszeiten ungültig ist.

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

int QDateTime::offsetFromUtc() const

Gibt den Offset dieser Datetime von UTC in Sekunden zurück.

Das Ergebnis hängt von timeSpec() ab:

• Qt::UTC Der Versatz ist 0.
• Qt::OffsetFromUTC Der Offset ist der ursprünglich eingestellte Wert.
• Qt::LocalTime Der Offset der lokalen Zeit von UTC wird zurückgegeben.
• Qt::TimeZone Es wird der von der Zeitzone verwendete Offset zurückgegeben.

Bei den letzten beiden wird der Offset zu diesem Datum und dieser Uhrzeit zurückgegeben, wobei die Sommerzeitverschiebung berücksichtigt wird. Der Offset ist die Differenz zwischen der Ortszeit oder der Zeit in der angegebenen Zeitzone und der UTC-Zeit; er ist positiv für Zeitzonen vor UTC (östlich des Nullmeridians), negativ für solche hinter UTC (westlich des Nullmeridians).

Siehe auch setOffsetFromUtc().

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

Gibt die Anzahl der Sekunden zwischen diesem Zeitpunkt und dem Zeitpunkt other zurück. Wenn der Zeitpunkt other vor diesem Zeitpunkt liegt, ist der zurückgegebene Wert negativ.

Vor dem Vergleich werden die beiden Datumszeiten in Qt::UTC umgewandelt, um sicherzustellen, dass das Ergebnis korrekt ist, wenn für eine der beiden Datumszeiten die Sommerzeit gilt, für die andere jedoch nicht.

Gibt 0 zurück, wenn eine der beiden Datumszeiten 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 Datumsteil dieser Datetime auf date.

Wenn noch keine Zeit eingestellt ist, wird sie auf Mitternacht gesetzt. Wenn date ungültig ist, wird QDateTime ungültig.

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

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

void QDateTime::setMSecsSinceEpoch(qint64 msecs)

Setzt den Zeitpunkt so, dass er 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 einem undefinierten Verhalten führt.

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

[until 6.9] void QDateTime::setOffsetFromUtc(int offsetSeconds)

Diese Funktion soll in Version 6.9 abgeschafft werden.

Verwenden Sie stattdessen setTimeZone(QTimeZone::fromSecondsAheadOfUtc(offsetSeconds))

Setzt den timeSpec() auf Qt::OffsetFromUTC und den Offset auf offsetSeconds. Die Datetime kann sich auf einen anderen Zeitpunkt beziehen.

Der maximale und minimale Versatz beträgt 14 positive oder negative Stunden. Wenn offsetSeconds größer oder kleiner als dieser Wert ist, ist das Ergebnis undefiniert.

Wenn offsetSeconds 0 ist, wird timeSpec() auf Qt::UTC gesetzt.

Siehe auch setTimeZone(), isValid(), offsetFromUtc(), und toOffsetFromUtc().

void QDateTime::setSecsSinceEpoch(qint64 secs)

Stellt die Datetime so ein, dass sie eine bestimmte Anzahl von Sekunden ( secs) nach dem Beginn des Jahres 1970 in UTC darstellt.

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

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

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

Setzt den Zeitteil dieser Datumsangabe auf time. Wenn time nicht gültig ist, setzt diese Funktion sie auf Mitternacht. Daher ist es möglich, jede eingestellte Zeit in QDateTime zu löschen, indem sie auf einen Standardwert QTime gesetzt wird:

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

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

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

[until 6.9] void QDateTime::setTimeSpec(Qt::TimeSpec spec)

Diese Funktion soll in Version 6.9 abgeschafft werden.

Verwenden Sie stattdessen setTimeZone()

Setzt die in dieser datetime verwendete Zeitangabe auf spec. Die datetime kann sich auf einen anderen Zeitpunkt beziehen.

Wenn spec Qt::OffsetFromUTC ist, wird timeSpec() auf Qt::UTC gesetzt, d. h. ein effektiver Versatz von 0.

Wenn spec gleich Qt::TimeZone ist, wird die Angabe auf Qt::LocalTime gesetzt, d. h. auf die aktuelle Systemzeitzone.

Beispiel:

QDateTime local(QDateTime::currentDateTime());qDebug() << "Local time is:" << local;

QDateTime UTC(local); UTC.setTimeSpec(Qt::UTC);qDebug() << "UTC time is:" << UTC;

qDebug() << "There are" << local.secsTo(UTC) << "seconds difference between the datetimes.";

Siehe auch setTimeZone(), timeSpec(), toTimeSpec(), setDate(), und setTime().

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

Setzt die in dieser Datetime verwendete Zeitzone auf toZone.

Die Datetime kann sich auf einen anderen Zeitpunkt beziehen. Sie verwendet die Zeitdarstellung von toZone, wodurch sich die Bedeutung der unveränderten date() und time() ändern kann.

Wenn toZone ungültig ist, ist auch die Datetime ungültig. Andernfalls entspricht timeSpec() dieser Datumsangabe nach dem Aufruf toZone.timeSpec().

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 diesen Zeitpunkt mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

QTime QDateTime::time() const

Gibt den Zeitteil der Datetime zurück.

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

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

Gibt eine QTimeZone zurück, die angibt, wie diese Datetime die Zeit darstellt.

Die timeSpec() der zurückgegebenen QTimeZone stimmt mit der dieser Datetime überein; wenn sie nicht Qt::TimeZone ist, ist die zurückgegebene QTimeZone eine Zeitdarstellung. Wenn timeSpec() Qt::OffsetFromUTC ist, liefert das zurückgegebene QTimeZone's fixedSecondsAheadOfUtc() den Offset. Wenn timeSpec() Qt::TimeZone ist, 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 der datetime zurück.

Diese klassifiziert ihre Zeitdarstellung als Ortszeit, UTC, einen festen Offset von UTC (ohne Angabe des Offsets) oder eine Zeitzone (ohne Angabe der Details dieser Zeitzone). Äquivalent zu timeRepresentation().timeSpec().

Siehe auch setTimeSpec(), timeRepresentation(), date(), und time().

QTimeZone QDateTime::timeZone() const

Gibt die Zeitzone der Datetime zurück.

Das Ergebnis ist dasselbe wie timeRepresentation().asBackendZone(). In allen Fällen ist timeSpec() des Ergebnisses Qt::TimeZone.

Wenn timeSpec() Qt::LocalTime ist, beschreibt das Ergebnis die Ortszeit zum Zeitpunkt des Aufrufs dieser Methode. Es wird spätere Änderungen der Systemzeitzone nicht widerspiegeln, auch wenn die QDateTime, von der es bezogen wurde, dies tut.

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

QString QDateTime::timeZoneAbbreviation() const

Gibt die Zeitzonenabkürzung für diesen Zeitpunkt zurück.

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

• Für Qt::UTC ist es "UTC".
• Für Qt::OffsetFromUTC wird sie im Format "UTC±00:00" zurückgegeben.
• Für Qt::LocalTime wird das Hostsystem abgefragt.
• Für Qt::TimeZone wird das zugehörige Objekt QTimeZone abgefragt.

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

CFDateRef QDateTime::toCFDate() const

Erzeugt ein CFDate aus einem QDateTime.

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

Siehe auch fromCFDate().

QDateTime QDateTime::toLocalTime() const

Gibt eine in die Ortszeit umgewandelte Kopie dieser Datumszeit zurück.

Das Ergebnis stellt denselben Zeitpunkt dar wie diese Datumsangabe und ist gleich 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 die Datumszeit als Anzahl von Millisekunden nach 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 lokale Zeit Qt::UTC wäre.

Das Verhalten dieser Funktion ist undefiniert, wenn die in diesem Objekt gespeicherte Datumszeit 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

Erzeugt ein NSDate aus einem QDateTime.

Das NSDate-Objekt wird automatisch wieder freigegeben.

Siehe auch fromNSDate().

QDateTime QDateTime::toOffsetFromUtc(int offsetSeconds) const

Gibt eine Kopie dieses Datums zurück, die in eine Spezifikation von Qt::OffsetFromUTC mit dem angegebenen offsetSeconds konvertiert wurde. Äquivalent zu toTimeZone(QTimeZone::fromSecondsAheadOfUtc(offsetSeconds)).

Wenn offsetSeconds gleich 0 ist, wird eine UTC-Datetime zurückgegeben.

Das Ergebnis stellt denselben Zeitpunkt wie diese Datetime dar und ist gleich.

Siehe auch setOffsetFromUtc(), offsetFromUtc(), und toTimeZone().

qint64 QDateTime::toSecsSinceEpoch() const

Gibt die Datumszeit als Anzahl von Sekunden nach 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 lokale Zeit Qt::UTC wäre.

Das Verhalten dieser Funktion ist undefiniert, wenn die in diesem Objekt gespeicherte Datumsangabe 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

Konvertiert dieses datetime-Objekt in den entsprechenden Zeitpunkt, ausgedrückt in Millisekunden, unter Verwendung von std::chrono::system_clock als Uhr.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch fromStdTimePoint() und toMSecsSinceEpoch().

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

Konvertiert dieses datetime-Objekt in den entsprechenden Zeitpunkt, ausgedrückt in Sekunden, unter Verwendung von std::chrono::system_clock als Uhr.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch fromStdTimePoint() und toSecsSinceEpoch().

QString QDateTime::toString(QStringView format) const

Dies ist eine überladene Funktion.

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

Dies ist eine überladene Funktion.

Gibt die Datetime als String in der angegebenen format zurück.

Wenn format Qt::TextDate ist, wird die Zeichenkette in der Standardform formatiert. Die Tages- und Monatsnamen sind in Englisch. Ein Beispiel für diese Formatierung ist "Wed May 20 03:40:13 1998". Für eine lokalisierte Formatierung siehe QLocale::toString().

Wenn format Qt::ISODate ist, entspricht das Format der Zeichenkette der erweiterten Spezifikation von ISO 8601 für Datums- und Zeitangaben in der Form yyyy-MM-ddTHH:mm:ss[Z|±HH:mm], abhängig von timeSpec() von QDateTime. Wenn timeSpec() Qt::UTC ist, wird Z an die Zeichenkette angehängt; wenn timeSpec() Qt::OffsetFromUTC ist, wird die Abweichung in Stunden und Minuten von UTC an die Zeichenkette angehängt. Um Millisekunden in das ISO 8601-Datum aufzunehmen, verwenden Sie format Qt::ISODateWithMs , was yyyy-MM-ddTHH:mm:ss.zzz[Z|±HH:mm] entspricht.

Wenn format Qt::RFC2822Date ist, wird die Zeichenfolge gemäß RFC 2822 formatiert.

Wenn die Datumsangabe ungültig ist, wird eine leere Zeichenkette zurückgegeben.

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

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

Dies ist eine überladene Funktion.

[until 6.9] QDateTime QDateTime::toTimeSpec(Qt::TimeSpec spec) const

Diese Funktion soll in Version 6.9 abgeschafft werden.

Verwenden Sie stattdessen toTimeZone().

Gibt eine Kopie dieser Datetime zurück, konvertiert in die angegebene Zeit spec.

Das Ergebnis stellt denselben Zeitpunkt dar wie diese Datetime und ist gleich dieser Zeit.

Wenn spec gleich Qt::OffsetFromUTC ist, wird es auf Qt::UTC gesetzt. Um eine feste Abweichung von UTC zu erhalten, verwenden Sie toTimeZone() oder toOffsetFromUtc().

Wenn spec gleich Qt::TimeZone ist, wird er auf Qt::LocalTime gesetzt, d. h. auf die lokale Zeitzone. Um eine bestimmte Zeitzone einzustellen, verwenden Sie toTimeZone().

Beispiel:

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

Siehe auch setTimeSpec(), timeSpec(), und toTimeZone().

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

Gibt eine Kopie dieser Datetime zurück, die in die angegebene timeZone konvertiert wurde.

Das Ergebnis stellt denselben Zeitpunkt wie diese Datetime dar und entspricht ihr.

Das Ergebnis beschreibt den Zeitpunkt in Form der Zeitdarstellung von timeZone. Zum Beispiel:

QDateTime local(QDateTime::currentDateTime());QDateTime UTC(local.toTimeSpec(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 die Datumsangabe ungültig. Andernfalls stimmt die zurückgegebene Datumsangabe timeSpec() mit timeZone.timeSpec() überein.

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

QDateTime QDateTime::toUTC() const

Gibt eine in UTC konvertierte Kopie dieser Datumszeit zurück.

Das Ergebnis stellt denselben Zeitpunkt wie diese Datetime dar und entspricht ihr.

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 durch Hinzufügen der angegebenen duration. Das aktualisierte Objekt wird später sein, wenn duration positiv ist, oder früher, wenn es negativ ist.

Wenn diese Datetime ungültig ist, hat diese Funktion keine Wirkung.

Gibt eine Referenz auf dieses datetime-Objekt zurück.

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 durch Subtraktion des angegebenen duration. Das aktualisierte Objekt wird früher liegen, wenn duration positiv ist, oder später, wenn es negativ ist.

Wenn diese datetime ungültig ist, hat diese Funktion keine Wirkung.

Gibt eine Referenz auf dieses datetime-Objekt zurück.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch addMSecs.

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

Kopiert die other datetime in this und gibt diese Kopie zurück.