QTime Class

Dokumentation der Mitgliedsfunktionen

Gibt eine Zeichenkette zurück, die die Zeit angibt.

Der Parameter format bestimmt das Format der Ergebniszeichenkette. Wenn die Zeit ungültig ist, wird eine leere Zeichenkette zurückgegeben.

Diese Ausdrücke können verwendet werden:

Wenn die Zeitzone nicht bestimmt werden kann oder keine geeignete Darstellung verfügbar ist, können die t -Formate zur Darstellung der Zeitzone übersprungen werden. Siehe QTimeZone::displayName() für Details, wenn es eine leere Zeichenkette zurückgibt.

Jede nicht leere Folge von Zeichen, die in einfache Anführungszeichen eingeschlossen ist, wird wortwörtlich in die Ausgabezeichenkette 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 die Formatierung von Zeichenfolgen (unter der Annahme, dass die QTime 14:13:09.042 ist)

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

[constexpr] QTime::QTime()

Konstruiert ein Null-Zeit-Objekt. Für eine Nullzeit gibt isNull() true und isValid() false zurück. Wenn Sie eine Nullzeit benötigen, verwenden Sie QTime(0, 0). Für den Beginn eines Tages, siehe QDate::startOfDay().

Siehe auch isNull() und isValid().

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

Konstruiert eine Zeit mit Stunde h, Minute m, Sekunden s und Millisekunden ms.

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

Siehe auch isValid().

QTime QTime::addMSecs(int ms) const

Gibt ein QTime Objekt zurück, das eine Zeit ms Millisekunden später als die Zeit dieses Objekts enthält (oder früher, wenn ms negativ ist).

Beachten Sie, dass die Zeit einen Umbruch erfährt, wenn sie Mitternacht überschreitet. Siehe addSecs() für ein Beispiel.

Gibt eine Nullzeit 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 eine Zeit s Sekunden später als die Zeit dieses Objekts enthält (oder früher, wenn s negativ ist).

Beachten Sie, dass die Zeit umbrochen wird, wenn sie Mitternacht überschreitet.

Gibt eine Nullzeit 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 Zeit 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 currentTime() nur innerhalb eines Tages; sie sinkt jedes Mal um 24 Stunden, wenn Mitternacht vorbei ist; und außerdem entsprechen Änderungen in ihr möglicherweise nicht der verstrichenen Zeit, wenn eine Sommerzeitumstellung dazwischen liegt.

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

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

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

Wenn msecs außerhalb des gültigen Bereichs liegt, wird eine ungültige QTime zurückgegeben.

Siehe auch msecsSinceStartOfDay().

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

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

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

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

Gibt die QTime zurück, die durch string repräsentiert wird, wobei die angegebene format verwendet wird, oder eine ungültige Zeit, wenn die Zeichenkette nicht geparst werden kann.

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

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 time = QTime::fromString("1mm12car00", "m'mm'hcarss");
// time is 12:01.00

Wenn das Format nicht erfüllt ist, wird ein ungültiger QTime zurückgegeben. Ausdrücke, die keine führenden Nullen erwarten (h, m, s und z), sind gierig. Das bedeutet, dass sie zwei Ziffern (oder drei für z) verwenden, auch wenn sie dadurch außerhalb des zulässigen Wertebereichs liegen und zu wenige Ziffern für andere Abschnitte übrig bleiben. Die folgende Zeichenkette könnte zum Beispiel 00:07:10 bedeuten, aber m nimmt zwei Ziffern, was zu einer ungültigen Zeit führt:

QTime time = QTime::fromString("00:710", "hh:ms"); // invalid

Jedes Feld, das nicht im Format enthalten ist, wird auf Null gesetzt. Ein 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)

Dies ist eine überladene Funktion.

Diese Funktion wurde in Qt 6.0 eingeführt.

[static, since 6.0] QTime QTime::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] QTime QTime::fromString(const QString &string, QStringView format)

Dies ist eine überladene Funktion.

Diese Funktion wurde in Qt 6.0 eingeführt.

int QTime::hour() const

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

Gibt -1 zurück, wenn die Zeit 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 QTime Objekt wurde mit dem Standardkonstruktor erstellt); andernfalls wird false zurückgegeben. Eine Nullzeit ist auch eine ungültige Zeit.

Siehe auch isValid().

bool QTime::isValid() const

Gibt true zurück, wenn die Zeit gültig ist; andernfalls wird false zurückgegeben. Zum Beispiel ist die Zeit 23:30:55.746 gültig, aber 24:12:30 ist ungültig.

Siehe auch isNull().

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

Dies ist eine überladene Funktion.

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

Die Zeit ist gültig, wenn h im Bereich von 0 bis 23, m und s im Bereich von 0 bis 59 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 Zeit 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

Liefert die Anzahl der msecs seit Tagesbeginn, d.h. seit 00:00:00.

Siehe auch fromMSecsSinceStartOfDay().

int QTime::msecsTo(QTime t) const

Gibt die Anzahl der Millisekunden von diesem Zeitpunkt bis t zurück. Wenn t vor diesem Zeitpunkt liegt, ist die zurückgegebene Anzahl der Millisekunden negativ.

Da QTime die Zeit innerhalb eines Tages misst und ein Tag aus 86400 Sekunden besteht, liegt das Ergebnis immer zwischen -86400000 und 86400000 ms.

Gibt 0 zurück, wenn eine der beiden Zeiten 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 t zurück. Wenn t vor diesem Zeitpunkt liegt, ist die zurückgegebene Anzahl der Sekunden negativ.

Da QTime die Zeit innerhalb eines Tages misst und ein Tag aus 86400 Sekunden besteht, liegt das Ergebnis immer zwischen -86400 und 86400.

secsTo() nimmt keine Rücksicht auf Millisekunden.

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

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

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

Setzt die Zeit auf Stunde h, Minute m, Sekunden s und Millisekunden ms.

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

Siehe auch isValid().

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

Dies ist eine überladene Funktion.

Gibt die Zeit als Zeichenkette zurück. Der Parameter format bestimmt das Format des Strings.

Wenn format Qt::TextDate ist, ist das String-Format HH:mm:ss; z. B. wäre 1 Sekunde vor Mitternacht "23:59:59".

Wenn format Qt::ISODate ist, entspricht das Format der Zeichenkette der erweiterten Spezifikation von ISO 8601 für die Darstellung von Datumsangaben, dargestellt durch HH:mm:ss. Um Millisekunden in das ISO 8601-Datum aufzunehmen, verwenden Sie format Qt::ISODateWithMs , was HH:mm:ss.zzz entspricht.

Wenn format Qt::RFC2822Date ist, wird die Zeichenfolge in einer RFC 2822-kompatiblen Weise formatiert. Ein Beispiel für diese Formatierung ist "23:59:20".

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

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