QTime Class

Dokumentation zu Mitgliedsfunktionen

[constexpr] QTime::QTime()

Erzeugt ein Nullzeit-Objekt. Für eine Nullzeit gibt isNull() den Wert „ true “ zurück, und isValid() gibt den Wert „ false “ zurück. Wenn Sie eine Zeit von Null benötigen, verwenden Sie QTime(0, 0). Informationen zum Beginn eines Tages finden Sie unter QDate::startOfDay().

Siehe auch „ isNull()“ und „ isValid()“.

QTime::QTime(int h, int m, int s = 0, int ms = 0)

Erzeugt eine Zeitangabe mit der Stunde h, der Minute m, den Sekunden s und den Millisekunden ms.

h muss im Bereich von 0 bis 23 liegen, m und s müssen im Bereich von 0 bis 59 liegen und ms muss im Bereich von 0 bis 999 liegen.

Siehe auch isValid().

QTime QTime::addMSecs(int ms) const

Gibt ein „ QTime “-Objekt zurück, das einen Zeit ms -Millisekunden nach dem Zeitpunkt dieses Objekts enthält (oder früher, wenn „ ms “ negativ ist).

Beachten Sie, dass der Zeitpunkt zurückgesetzt wird, wenn er Mitternacht überschreitet. Ein Beispiel finden Sie unter ` addSecs()`.

Gibt eine Null-Zeit zurück, wenn diese Zeit ungültig ist.

Siehe auch addSecs(), msecsTo() und QDateTime::addMSecs().

QTime QTime::addSecs(int s) const

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

Beachten Sie, dass der Zeitpunkt zurückgesetzt wird, wenn er Mitternacht überschreitet.

Gibt einen Null-Zeitwert zurück, wenn diese Zeit ungültig ist.

Beispiel:

QTime n(14, 0, 0);                // n == 14:00:00
QTime t;
t = n.addSecs(70);                // t == 14:01:10
t = n.addSecs(-70);               // t == 13:58:50
t = n.addSecs(10 * 60 * 60 + 5);  // t == 00:00:05
t = n.addSecs(-15 * 60 * 60);     // t == 23:00:00

Siehe auch ` addMSecs()`, ` secsTo()` und ` QDateTime::addSecs()`.

[static] QTime QTime::currentTime()

Gibt die aktuelle Uhrzeit zurück, wie sie von der Systemuhr gemeldet wird.

Beachten Sie, dass die Genauigkeit von der Genauigkeit des zugrunde liegenden Betriebssystems abhängt; nicht alle Systeme bieten eine Genauigkeit von 1 Millisekunde.

Außerdem erhöht sich der Wert von currentTime() innerhalb eines Tages nur; er verringert sich jedes Mal um 24 Stunden, wenn Mitternacht vorüber ist; darüber hinaus entsprechen Änderungen dieses Werts möglicherweise nicht der verstrichenen Zeit, wenn eine Umstellung auf Sommerzeit stattfindet.

Siehe auch ` QDateTime::currentDateTime()` und ` QDateTime::currentDateTimeUtc()`.

[static constexpr] QTime QTime::fromMSecsSinceStartOfDay(int msecs)

Gibt eine neue „ QTime “-Instanz zurück, deren Zeit auf die Anzahl der „ msecs “ seit Tagesbeginn, d. h. seit 00:00:00, gesetzt ist.

Liegt ` msecs ` außerhalb des gültigen Bereichs, wird ein ungültiger ` QTime ` zurückgegeben.

Siehe auch msecsSinceStartOfDay().

[static] QTime QTime::fromString(const QString &string, const QString &format)

Gibt die durch die Zeichenfolge „ string “ dargestellte „ QTime “ unter Verwendung des angegebenen „ format “ zurück oder eine ungültige Zeit, falls die Zeichenfolge nicht geparst werden kann.

Folgende Ausdrücke können für das Format verwendet werden:

Jede nicht leere Zeichenfolge, die in einfache Anführungszeichen gesetzt 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. Zum Beispiel:

QTime time = QTime::fromString("1mm12car00", "m'mm'hcarss");
// time is 12:01.00

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

Wenn numerische Felder nebeneinander stehen und keine Trennzeichen vorhanden sind, um die Ziffernfolgen zu unterbrechen, 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 früheren Feldern zusätzliche Ziffern zugewiesen werden, anstatt sie späteren Feldern zuzuweisen, vorausgesetzt, die Daten bleiben konsistent. Zum Beispiel:

QTime time = QTime::fromString("00:710", "hh:ms"); // 7 mins, 10 secs after midnight

Jedes Feld, das in dem Format nicht vertreten ist, wird auf Null gesetzt. Beispiel:

QTime time = QTime::fromString("1.30", "m.s");
// time is 00:01:30.000

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

[static, since 6.0] QTime QTime::fromString(QStringView string, QStringView format)

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Gibt die im „ string “ dargestellte Zeit als „ QTime “ unter Verwendung des angegebenen „ format “ zurück oder, falls dies nicht möglich ist, eine ungültige Zeit.

Siehe auch ` toString()` und ` QLocale::toTime()`.

int QTime::hour() const

Gibt den Stundenanteil (0 bis 23) der Uhrzeit zurück.

Gibt -1 zurück, wenn die Uhrzeit ungültig ist.

Siehe auch minute(), second() und msec().

[constexpr] bool QTime::isNull() const

Gibt „ true “ zurück, wenn die Zeit null ist (d. h., das Objekt „ QTime “ wurde mit dem Standardkonstruktor erstellt); andernfalls wird „false“ zurückgegeben. Eine Null-Zeit ist ebenfalls eine ungültige Zeit.

Siehe auch isValid().

bool QTime::isValid() const

Gibt „ true “ zurück, wenn die Uhrzeit gültig ist; andernfalls wird „ false “ zurückgegeben. Beispielsweise ist die Uhrzeit 23:30:55,746 gültig, 24:12:30 hingegen ungültig.

Siehe auch isNull().

[static] bool QTime::isValid(int h, int m, int s, int ms = 0)

Gibt „ true “ zurück, wenn die angegebene Uhrzeit gültig ist; andernfalls wird „false“ zurückgegeben.

Die Uhrzeit ist gültig, wenn h im Bereich von 0 bis 23 liegt, m und s im Bereich von 0 bis 59 liegen und ms im Bereich von 0 bis 999 liegt.

Beispiel:

QTime::isValid(21, 10, 30); // returns true
QTime::isValid(22, 5,  62); // returns false

int QTime::minute() const

Gibt den Minutenteil (0 bis 59) der Uhrzeit zurück.

Gibt -1 zurück, wenn die Uhrzeit ungültig ist.

Siehe auch hour(), second() und msec().

int QTime::msec() const

Gibt den Millisekundenanteil (0 bis 999) der Zeit zurück.

Gibt -1 zurück, wenn die Zeit ungültig ist.

Siehe auch hour(), minute() und second().

[constexpr] int QTime::msecsSinceStartOfDay() const

Gibt die Anzahl der Millisekunden seit Beginn des Tages zurück, d. h. seit 00:00:00.

Siehe auch „ fromMSecsSinceStartOfDay()“.

int QTime::msecsTo(QTime t) const

Gibt die Anzahl der Millisekunden von diesem Zeitpunkt bis zum Zeitpunkt „ t “ zurück. Liegt „ t “ vor diesem Zeitpunkt, ist die zurückgegebene Anzahl der Millisekunden negativ.

Da „ QTime “ die Zeit innerhalb eines Tages misst und ein Tag 86.400 Sekunden hat, liegt das Ergebnis immer zwischen -86.400.000 und 86.400.000 ms.

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

Siehe auch „ secsTo()“, „ addMSecs()“ und „ QDateTime::msecsTo()“.

int QTime::second() const

Gibt den zweiten Teil (0 bis 59) der Uhrzeit zurück.

Gibt -1 zurück, wenn die Zeit ungültig ist.

Siehe auch hour(), minute() und msec().

int QTime::secsTo(QTime t) const

Gibt die Anzahl der Sekunden von diesem Zeitpunkt bis zu t zurück. Liegt t vor diesem Zeitpunkt, ist die zurückgegebene Sekundenzahl negativ.

Da „ QTime “ die Zeit innerhalb eines Tages misst und ein Tag 86.400 Sekunden hat, liegt das Ergebnis immer zwischen -86.400 und 86.400.

secsTo() berücksichtigt keine Millisekunden.

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

Siehe auch „ addSecs()“ und „ QDateTime::secsTo()“.

bool QTime::setHMS(int h, int m, int s, int ms = 0)

Legt die Zeit fest: Stunde h, Minute m, Sekunden s und Millisekunden ms.

h muss im Bereich von 0 bis 23 liegen, m und s müssen im Bereich von 0 bis 59 liegen und ms muss im Bereich von 0 bis 999 liegen. Gibt true zurück, wenn die eingestellte Zeit gültig ist; andernfalls wird false zurückgegeben.

Siehe auch isValid().

Gibt eine Zeichenkette zurück, die die Uhrzeit darstellt.

Der Parameter „ format “ bestimmt das Format der Ergebniszeichenfolge. Ist die Zeitangabe ungültig, wird eine leere Zeichenfolge zurückgegeben.

Folgende Ausdrücke können verwendet werden:

Wenn die Zeitzone nicht ermittelt werden kann oder keine geeignete Darstellung dafür verfügbar ist, können die Formate zur Darstellung der Zeitzone ( t ) übersprungen werden. Unter QTimeZone::displayName() finden Sie Details dazu, wann die Funktion eine leere Zeichenkette zurückgibt.

Jede nicht leere Zeichenfolge, die in einfache Anführungszeichen eingeschlossen 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 Sequenz einzuleiten oder zu beenden. Alle anderen Zeichen in der Formatzeichenfolge werden wörtlich in die Ausgabekette übernommen.

Formate ohne Trennzeichen (z. B. „hhmm“) werden unterstützt, müssen jedoch mit Bedacht verwendet werden, da die resultierenden Zeichenfolgen nicht immer zuverlässig lesbar sind (wenn beispielsweise „Hm“ zu „212“ führt, könnte dies entweder 02:12 oder 21:02 bedeuten).

Beispiele für Formatzeichenfolgen (unter der Annahme, dass der „ QTime “ 14:13:09.042 lautet)

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

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

Gibt die Uhrzeit als Zeichenfolge zurück. Der Parameter „ format “ bestimmt das Format der Zeichenfolge.

Ist „ format “ auf „ Qt::TextDate “ gesetzt, lautet das Zeichenfolgenformat „HH:mm:ss“; beispielsweise würde 1 Sekunde vor Mitternacht als „23:59:59“ dargestellt werden.

Ist „ format “ auf „ Qt::ISODate “ gesetzt, entspricht das Zeichenfolgenformat der erweiterten ISO 8601-Spezifikation für die Darstellung von Datumsangaben, dargestellt als HH:mm:ss. Um Millisekunden in das ISO 8601-Datum einzubeziehen, verwenden Sie den Parameter „ format “ mit dem Wert „ Qt::ISODateWithMs “, was dem Format HH:mm:ss.zzz entspricht.

Wenn der Parameter „ format “ auf „ Qt::RFC2822Date “ gesetzt ist, wird die Zeichenkette RFC 2822 -kompatibel formatiert. Ein Beispiel für diese Formatierung ist „23:59:20“.

Ist die Zeit ungültig, wird eine leere Zeichenkette zurückgegeben.

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