QTime Class

メンバ関数ドキュメント

時刻を文字列として返す。format パラメータは、結果の文字列の書式を決定する。

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

一重引用符で囲まれた空でない文字列は、書式文字を含んでいても、（引用符を 取り除いた）出力文字列にそのまま含まれる。連続する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 秒遅い時刻を含むQTime オブジェクトを返します （s が負の場合はそれより早い時刻）。

時刻が真夜中を過ぎると折り返されることに注意。

この時刻が無効な場合は 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日の中で増加するだけであり、午前0時を過ぎるたびに24時間ずつ減少する。また、夏時間の移行が介在する場合、currentTime()の変化は経過時間と一致しないことがある。

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 を返す。ヌル時刻は無効な時刻でもあります。

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

時刻の第2部（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 となる。例えば、真夜中の 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()も参照のこと 。