QTime Class

멤버 함수 문서

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

format 매개 변수에 따라 결과 문자열의 형식이 결정됩니다. 시간이 유효하지 않으면 빈 문자열이 반환됩니다.

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

시간대를 확인할 수 없거나 적절한 시간대 표현이 없는 경우에는 t 형식을 건너뛸 수 있습니다. 빈 문자열을 반환하는 경우에 대한 자세한 내용은 QTimeZone::displayName()를 참조하세요.

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

구분 기호가 없는 형식(예: "ddMM")은 지원되지만 결과 문자열을 항상 안정적으로 읽을 수 있는 것은 아니므로 주의해서 사용해야 합니다(예: "dM"이 "212"를 생성하면 12월 2일 또는 2월 21일을 의미할 수 있음).

형식 문자열 예시( QTime 가 14:13:09.042라고 가정)

fromString(), QDate::toString(), QDateTime::toString() 및 QLocale::toString()도 참조하세요 .

[constexpr] QTime::QTime()

널 시간 객체를 구축합니다. 널 시간의 경우 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, Qt::DateFormat format = Qt::TextDate)

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

toString() 및 QLocale::toTime()도 참조하세요 .

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

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

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

그 외의 모든 입력 문자는 텍스트로 처리됩니다. 작은따옴표로 묶인 비어 있지 않은 문자 시퀀스도 표현식으로 해석되지 않고 (따옴표가 제거된) 텍스트로 처리됩니다.

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

형식이 충족되지 않으면 잘못된 QTime 이 반환됩니다. 선행 0이 주어질 것으로 예상되지 않는 표현식(h, m, s 및 z)은 욕심이 많습니다. 즉, 허용되는 값의 범위를 벗어나 다른 섹션에 너무 적은 숫자가 남더라도 두 자리(z의 경우 세 자리)를 사용합니다. 예를 들어 다음 문자열은 00:07:10을 의미할 수 있지만 m이 두 자리 숫자를 가져가므로 잘못된 시간이 됩니다:

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

형식에 표시되지 않는 모든 필드는 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에 도입되었습니다.

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()도 참조하세요 .

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 날짜에 밀리초를 포함하려면 HH:mm:ss.zzz에 해당하는 format Qt::ISODateWithMs 을 사용합니다.

format 이 Qt::RFC2822Date 인 경우 문자열은 RFC 2822와 호환되는 방식으로 형식이 지정됩니다. 이 형식의 예는 "23:59:20"입니다.

시간이 유효하지 않으면 빈 문자열이 반환됩니다.

fromString(), QDate::toString(), QDateTime::toString() 및 QLocale::toString()도 참조하세요 .