QTime Class

멤버 함수 설명서

[constexpr] QTime::QTime()

null 시간 객체를 생성합니다. null 시간의 경우, ` isNull()`는 ` true `을 반환하고, ` isValid()`는 ` false`을 반환합니다. 0 시간을 사용해야 하는 경우 `QTime(0, 0)`을 사용하십시오. 하루의 시작에 대해서는 ` QDate::startOfDay()`을 참조하십시오.

isNull() 및 isValid()도 참조하십시오 .

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

시간을 구성할 때, 시( h), 분( m), 초( s ), 밀리초( ms)를 지정합니다.

h 는 0에서 23 사이의 값이어야 하며, m 과 s 는 0에서 59 사이의 값이어야 하고, ms 는 0에서 999 사이의 값이어야 합니다.

isValid()도 참조하십시오 .

QTime QTime::addMSecs(int ms) const

이 객체의 시간보다 ms 밀리초 뒤( ms 가 음수인 경우 그 이전)의 시간을 포함하는 QTime 객체를 반환합니다.

시간이 자정을 넘기면 시간이 랩핑된다는 점에 유의하십시오. 예제는 addSecs()을 참조하십시오.

이 시간이 유효하지 않은 경우 null 시간을 반환합니다.

addSecs(), msecsTo(), QDateTime::addMSecs()도 참조하십시오 .

QTime QTime::addSecs(int s) const

이 객체의 시간보다 s 초 뒤( s 가 음수인 경우 그 이전)의 시간을 포함하는 ` QTime ` 객체를 반환합니다.

자정을 넘기면 시간이 랩핑된다는 점에 유의하십시오.

이 시간이 유효하지 않은 경우 null 시간을 반환합니다.

예:

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

addMSecs(), secsTo(), QDateTime::addSecs()도 참조하십시오 .

[static] QTime QTime::currentTime()

시스템 시계에서 보고하는 현재 시간을 반환합니다.

정확도는 기본 운영 체제의 정확도에 따라 달라지므로, 모든 시스템이 1밀리초 단위의 정확도를 제공하는 것은 아닙니다.

또한, currentTime()은 하루 내에서만 증가하며, 자정이 지날 때마다 24시간씩 감소합니다. 아울러, 일광 절약 시간제 전환이 발생하는 경우, 이 값의 변화가 경과 시간과 일치하지 않을 수 있습니다.

QDateTime::currentDateTime() 및 QDateTime::currentDateTimeUtc()도 참조하십시오 .

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

오늘 하루가 시작된 시점, 즉 00:00:00부터 경과한 시간( msecs )을 시간으로 설정한 새로운 ` QTime ` 인스턴스를 반환합니다.

msecs 가 유효한 범위를 벗어날 경우, 유효하지 않은 QTime 가 반환됩니다.

msecsSinceStartOfDay()도 참조하십시오 .

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

string 로 표현된 QTime 를, 주어진 format 를 사용하여 반환하거나, 해당 문자열을 구문 분석할 수 없는 경우 유효하지 않은 시간을 반환합니다.

다음 표현식을 형식에 사용할 수 있습니다:

작은 따옴표로 묶인 비어 있지 않은 문자열은 (따옴표를 제거한 후) 표현식으로 해석되지 않고 텍스트로 처리됩니다. 연속된 두 개의 작은 따옴표("''")는 문자 그대로의 문자열을 시작하거나 끝내는 것이 아니라, 입력과 일치할 작은 따옴표 하나로 인식됩니다. 그 외의 모든 입력 문자는 입력 문자열에서 일치해야 할 문자 그대로의 텍스트로 처리됩니다. 예:

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

형식이 충족되지 않으면 무효한 ` QTime `가 반환됩니다.

숫자 필드가 나란히 배치되어 있고, 숫자 시퀀스를 구분하는 구분자가 없는 경우, 한 자릿수로 허용되는 일부 필드가 두 자릿수를 사용하는지(표현할 값이 9를 초과하기 때문)에 대한 모호성이 발생할 수 있습니다. 이러한 필드에 두 자리 숫자를 할당할 경우 다른 필드에 할당할 자리가 부족해지고, 한 자리 숫자 표기가 다른 필드들과 일관성이 있다면 이 모호성을 해소할 수 있습니다. 그렇지 않은 경우(하나 이상의 필드에 한 자리 수만 허용되고, 각 필드에 한 자리씩만 할당하면 남은 자릿수가 생기는 경우), 데이터의 일관성이 유지된다는 전제 하에, 뒤쪽 필드에 여분의 자릿수를 할당하는 방식보다는 앞쪽 필드에 여분의 자릿수를 할당하는 방식이 선호됩니다. 예를 들어:

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

해당 형식에 포함되지 않은 필드는 모두 0으로 설정됩니다. 예를 들어:

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

toString(), QDateTime::fromString(), QDate::fromString(), QLocale::toTime(), QLocale::toDateTime()도 참조하십시오 .

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

이 함수는 Qt 6.0에서 도입되었습니다.

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

이 함수는 Qt 6.0에서 도입되었습니다.

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

이 함수는 Qt 6.0에서 도입되었습니다.

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

string 에 표시된 시간을, 주어진 format 를 사용하여 QTime 형식으로 반환하거나, 이것이 불가능할 경우 유효하지 않은 시간을 반환합니다.

toString() 및 QLocale::toTime()도 참조하십시오 .

int QTime::hour() const

시간의 시간 부분(0~23)을 반환합니다.

시간이 유효하지 않은 경우 -1을 반환합니다.

minute(), second() 및 msec()도 참조하십시오 .

[constexpr] bool QTime::isNull() const

시간이 null인 경우(즉, ` QTime ` 객체가 기본 생성자를 사용하여 생성된 경우) ` true `을 반환하고, 그렇지 않은 경우 `false`를 반환합니다. null인 시간도 유효하지 않은 시간입니다.

isValid()도 참조하십시오 .

bool QTime::isValid() const

시간이 유효한 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다. 예를 들어, 23:30:55.746은 유효한 시간이지만, 24:12:30은 유효하지 않은 시간입니다.

isNull()도 참조하십시오 .

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

지정된 시간이 유효한 경우 ` true `를 반환하고, 그렇지 않은 경우 `false`를 반환합니다.

h 가 0에서 23 사이의 범위이고, m 및 s 가 0에서 59 사이의 범위이며, ms 가 0에서 999 사이의 범위일 때 해당 시간은 유효합니다.

예시:

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

int QTime::minute() const

시간의 분 단위(0~59)를 반환합니다.

시간이 유효하지 않은 경우 -1을 반환합니다.

hour(), second(), msec()도 참조하십시오 .

int QTime::msec() const

시간의 밀리초 부분(0~999)을 반환합니다.

시간이 유효하지 않은 경우 -1을 반환합니다.

hour(), minute(), second()도 참조하십시오 .

[constexpr] int QTime::msecsSinceStartOfDay() const

오늘 하루가 시작된 시점, 즉 00:00:00부터 경과한 시간을 밀리초 단위로 반환합니다.

fromMSecsSinceStartOfDay()도 참조하십시오 .

int QTime::msecsTo(QTime t) const

현재 시각부터 t 까지의 밀리초 수를 반환합니다. t 가 현재 시각보다 이른 경우, 반환되는 밀리초 수는 음수입니다.

QTime 는 하루 내의 시간을 측정하며, 하루는 86400초이므로 결과는 항상 -86400000~86400000 ms 범위 내에 있습니다.

두 시간 중 하나라도 유효하지 않은 경우 0을 반환합니다.

secsTo(), addMSecs(), QDateTime::msecsTo()도 참조하십시오 .

int QTime::second() const

시간의 두 번째 부분(0~59)을 반환합니다.

시간이 유효하지 않은 경우 -1을 반환합니다.

hour(), minute(), msec()도 참조하십시오 .

int QTime::secsTo(QTime t) const

현재 시각부터 ‘ t ’까지의 초 수를 반환합니다. ‘ t ’가 현재 시각보다 이른 경우, 반환되는 초 수는 음수가 됩니다.

QTime 는 하루 내의 시간을 측정하며, 하루에는 86400초가 있으므로 결과는 항상 -86400에서 86400 사이의 값이 됩니다.

secsTo()는 밀리초를 고려하지 않습니다.

두 시간 중 하나라도 유효하지 않은 경우 0을 반환합니다.

addSecs() 및 QDateTime::secsTo()도 참조하십시오 .

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

시간을 시( h), 분( m), 초( s ) 및 밀리초( ms)로 설정합니다.

h 는 0에서 23 사이의 값이어야 하며, m 및 s 는 0에서 59 사이의 값이어야 하고, ms 는 0에서 999 사이의 값이어야 합니다. 설정된 시간이 유효하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

isValid()도 참조하십시오 .

시간을 나타내는 문자열을 반환합니다.

format 매개변수는 결과 문자열의 형식을 결정합니다. 시간이 유효하지 않은 경우, 빈 문자열이 반환됩니다.

다음과 같은 표현식을 사용할 수 있습니다:

시간대를 확인할 수 없거나 적절한 표현 형식이 없는 경우, 이를 나타내는 t 형식은 생략될 수 있습니다. 이 함수가 빈 문자열을 반환하는 경우에 대한 자세한 내용은 QTimeZone::displayName()을 참조하십시오.

작은 따옴표로 묶인 비어 있지 않은 문자열은 서식 지정 문자가 포함되어 있더라도 (따옴표는 제거된 채) 출력 문자열에 그대로 포함됩니다. 연속된 두 개의 작은 따옴표("''")는 출력 시 문자 그대로의 시퀀스를 시작하거나 끝내는 것이 아니라, 하나의 작은 따옴표로 대체됩니다. 포맷 문자열에 포함된 그 외의 모든 문자는 출력 문자열에 그대로 포함됩니다.

구분 기호가 없는 형식(예: "hhmm")도 지원되지만, 결과 문자열이 항상 신뢰할 수 있게 읽히지는 않으므로 주의해서 사용해야 합니다(예: "Hm"이 "212"를 생성하는 경우, 이는 02:12 또는 21:02를 의미할 수 있음).

포맷 문자열 예시 ( QTime 가 14:13:09.042라고 가정할 때)

fromString(), QDate::toString(), QDateTime::toString(), QLocale::toString()도 참조하십시오 .

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

시간을 문자열로 반환합니다. ` format ` 매개변수는 문자열의 형식을 결정합니다.

format 가 Qt::TextDate 인 경우, 문자열 형식은 HH:mm:ss입니다. 예를 들어, 자정 1초 전은 "23:59:59"가 됩니다.

format 가 Qt::ISODate 인 경우, 문자열 형식은 날짜 표기를 위한 ISO 8601 확장 사양에 따르며, HH:mm:ss로 표시됩니다. ISO 8601 날짜에 밀리초를 포함하려면 format Qt::ISODateWithMs 를 사용하십시오. 이는 HH:mm:ss.zzz에 해당합니다.

format 가 Qt::RFC2822Date 인 경우, 문자열은 RFC 2822와 호환되는 방식으로 포맷됩니다. 이 포맷의 예로는 "23:59:20"이 있습니다.

시간이 유효하지 않은 경우, 빈 문자열이 반환됩니다.

fromString(), QDate::toString(), QDateTime::toString() 및 QLocale::toString()도 참조하십시오 .