QTime Class

メンバ関数ドキュメント

時刻を表す文字列を返す。

format パラメータは、結果の文字列のフォーマットを決定します。時刻が無効な場合は、空の文字列が返されます。

以下の式を使用できます：

タイムゾーンを決定できない場合、またはタイムゾーンの適切な表現がない場合、t 形式でタイムゾーンを表現することは省略できる。空文字列を返す場合の詳細については、QTimeZone::displayName()を参照のこと。

一重引用符で囲まれた空でない文字列は、それが書式文字を含んでいたとしても、 出力文字列にそのまま含まれる（引用符は取り除かれる）。連続する2つの一重引用符（"''）は、出力では一重引用符に置き換えられる。書式文字列内のその他の文字は、出力文字列にそのまま含まれます。

セパレータのない書式（例えば "ddMM"）はサポートされていますが、結果の文字列が必ずしも確実に読めるとは限らないので、注意して使用する必要があります（例えば、"dM "が "212 "を生成する場合、それは12月2日または2月21日のどちらかを意味する可能性があります）。

フォーマット文字列の例（QTime が 14:13:09.042 の場合）

fromString()、QDate::toString()、QDateTime::toString()、QLocale::toString()も参照のこと 。

[constexpr] QTime::QTime()

null time オブジェクトを構築する。ヌル時刻の場合、isNull() はtrue を返し、isValid() はfalse を返します。ゼロ時刻が必要な場合は、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 の範囲、 と は 0 から 59 の範囲、 は 0 から 999 の範囲でなければならない。m s ms

isValid()も参照のこと 。

QTime QTime::addMSecs(int ms) const

このオブジェクトの時刻よりms ミリ秒後の時刻を含むQTime オブジェクトを返します（ms が負の場合はそれより前の時刻）。

時刻が真夜中を過ぎると折り返されることに注意。例については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()は1日の中でしか増加しない。真夜中が経過するたびに24時間分ずつ減少する。

QDateTime::currentDateTime() およびQDateTime::currentDateTimeUtc()も参照の こと。

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

時刻を、その日の開始からのmsecs の数、つまり 00:00:00 以降に設定した新しい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 。先頭のゼロを期待しない式（h、m、s、z）は貪欲である。これは、2桁（zの場合は3桁）を使用することを意味し、たとえそれが許容される値の範囲外となり、他のセクションのための桁数が少なすぎるとしても使用されます。例えば、以下の文字列は00:07:10を意味する可能性があるが、mは2桁を取得し、結果として無効な時刻となる：

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

フォーマットで表現されないフィールドは、すべてゼロに設定されます。例えば

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 を返します。そうでない場合は 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 は1日内の時間を計測し、1日は86400秒であるため、結果は常に-86400000～86400000ミリ秒となる。

いずれかの時刻が無効な場合は 0 を返す。

secsTo()、addMSecs()、QDateTime::msecsTo()も参照 。

int QTime::second() const

時刻の後半部分（0～59）を返す。

時刻が無効な場合は -1 を返す。

hour()、minute() およびmsec()も参照 。

int QTime::secsTo(QTime t) const

この時刻からt までの秒数を返します。t がこの時刻より早い場合、返される秒数は負になります。

QTime は 1 日内の時間を計測し、1 日には 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 の範囲、 と は 0 から 59 の範囲、 は 0 から 999 の範囲でなければならない。設定された時刻が有効な場合は を返し、そうでない場合は を返す。m s ms true false

isValid()も参照のこと 。

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

これはオーバーロードされた関数である。

時刻を文字列として返す。format パラメータは文字列のフォーマットを決定します。

format がQt::TextDate の場合、文字列の書式は HH:mm:ss となります。例えば、午前0時の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()も参照のこと 。