Qtにおける時間処理：QTime, QDateTimeの使い方徹底解説

By /

はい、承知いたしました。Qtにおける時間処理、特にQTimeとQDateTimeの使い方について、約5000語の詳細な解説記事を作成します。

Qtにおける時間処理：QTime, QDateTimeの使い方徹底解説

第1章 はじめに

ソフトウェア開発において、時間処理は非常に基本的ながら重要な要素です。ログの記録、イベントのスケジューリング、処理時間の計測、ユーザーインターフェースでの日付・時刻表示、異なるタイムゾーン間での時刻変換など、様々な場面で正確な時間管理が求められます。

Qtフレームワークは、これらの時間処理を行うための強力で使いやすいクラスを提供しています。主要なクラスとしては、日付のみを扱うQDate、時刻のみを扱うQTime、そして日付と時刻の両方をタイムゾーン情報と共に扱うQDateTimeがあります。さらに、タイムゾーンの詳細な情報を提供するQTimeZoneや、高精度な時間計測のためのQElapsedTimer、一定時間後に処理を実行するためのQTimerといった関連クラスも存在します。

この記事では、特に利用頻度の高いQTimeとQDateTimeクラスに焦点を当て、その基本的な使い方から、比較、演算、文字列との変換、そしてタイムゾーンの扱いといった応用的な内容までを、豊富なコード例と共に徹底的に解説します。補足としてQDateやQTimeZoneについても触れ、Qtでの時間処理全体を網羅的に理解することを目指します。

対象読者は、Qtを使った開発経験がある方、あるいはQtで時間処理を実装する必要があるエンジニアです。この記事を通じて、Qtの柔軟で強力な時間処理機能を自在に使いこなし、より信頼性の高いアプリケーションを開発できるようになることを願っています。

第2章 Qtにおける時刻管理の基本：QTime

QTimeクラスは、日付情報を含まず、時刻（時、分、秒、ミリ秒）のみを管理するために設計されています。これは、単に現在の時刻を表示したい場合や、経過時間を計測したい場合などに非常に便利です。QTimeは内部的に、その日の開始（00:00:00.000）からの経過ミリ秒数として時刻を保持しています。最大値は23時間59分59秒999ミリ秒です。

2.1 QTimeオブジェクトの生成

QTimeオブジェクトを生成するにはいくつかの方法があります。

現在のシステム時刻を取得する

静的メソッドであるcurrentTime()を使用すると、システムの現在の時刻に基づいたQTimeオブジェクトを取得できます。これは最もよく使われる生成方法の一つです。

“`cpp

include

include

int main() {
QTime currentTime = QTime::currentTime();
qDebug() << “Current time:” << currentTime.toString(“hh:mm:ss.zzz”);
return 0;
}
“`

toString("hh:mm:ss.zzz")については後述しますが、これは時刻を指定したフォーマットで文字列に変換するメソッドです。

指定した時刻でオブジェクトを生成する

時、分、秒、ミリ秒を指定してQTimeオブジェクトを作成することもできます。コンストラクタを使用します。ミリ秒は省略可能で、その場合は0が設定されます。

“`cpp

include

include

int main() {
QTime specificTime(10, 30, 15, 500); // 10時30分15秒500ミリ秒
qDebug() << “Specific time:” << specificTime.toString(“hh:mm:ss.zzz”);

QTime anotherTime(23, 59, 59); // 23時59分59秒000ミリ秒
qDebug() << "Another time:" << anotherTime.toString("hh:mm:ss.zzz");

// 無効な時刻を指定した場合 (例: 時が24以上)
QTime invalidTime(25, 0, 0);
qDebug() << "Invalid time:" << invalidTime.toString("hh:mm:ss.zzz"); // 通常、null文字列か無効を示す表示になる
qDebug() << "Is invalid time valid?" << invalidTime.isValid(); // false
return 0;

}
“`

時、分、秒、ミリ秒が有効な範囲（時: 0-23, 分: 0-59, 秒: 0-59, ミリ秒: 0-999）を超えている場合、作成されるQTimeオブジェクトは無効（Invalid）となります。

無効なQTimeオブジェクトを生成する

デフォルトコンストラクタQTime()を使用して、無効なQTimeオブジェクトを作成できます。これは、初期値として無効な状態を持たせたい場合などに使用します。

“`cpp

include

include

int main() {
QTime nullTime; // 無効なQTimeオブジェクト
qDebug() << “Is null time valid?” << nullTime.isValid(); // false
return 0;
}
“`

2.2 時刻要素の取得

作成したQTimeオブジェクトから、それぞれの時刻要素（時、分、秒、ミリ秒）を取り出すには、対応するメソッドを使用します。

“`cpp

include

include

int main() {
QTime time(14, 5, 8, 123);
qDebug() << “Hour:” << time.hour(); // 14
qDebug() << “Minute:” << time.minute(); // 5
qDebug() << “Second:” << time.second(); // 8
qDebug() << “Millisecond:” << time.msec(); // 123

// オブジェクトが有効かどうかの確認
qDebug() << "Is time valid?" << time.isValid(); // true

QTime invalidTime(30, 0, 0);
qDebug() << "Is invalidTime valid?" << invalidTime.isValid(); // false
// 無効なオブジェクトから要素を取得しようとすると、-1などの無効な値が返される
qDebug() << "Hour of invalidTime:" << invalidTime.hour(); // -1
return 0;

}
“`

isValid()メソッドは、そのQTimeオブジェクトが有効な時刻を表しているかどうかを判定します。無効なオブジェクトから時刻要素を取得しようとすると、通常は-1などのエラーを示す値が返されます。

2.3 時刻の比較

二つのQTimeオブジェクトは、標準の比較演算子 (<, <=, >, >=, ==, !=) を使って直接比較できます。比較は時刻の順序に基づいて行われます。

“`cpp

include

include

int main() {
QTime time1(10, 30, 0);
QTime time2(11, 0, 0);
QTime time3(10, 30, 0);

qDebug() << "time1:" << time1.toString("hh:mm:ss");
qDebug() << "time2:" << time2.toString("hh:mm:ss");
qDebug() << "time3:" << time3.toString("hh:mm:ss");

qDebug() << "time1 < time2:" << (time1 < time2);   // true
qDebug() << "time1 == time3:" << (time1 == time3); // true
qDebug() << "time2 > time1:" << (time2 > time1);   // true

// 無効な時刻との比較
QTime invalidTime;
qDebug() << "time1 == invalidTime:" << (time1 == invalidTime); // false
qDebug() << "invalidTime == invalidTime:" << (invalidTime == invalidTime); // true (無効なオブジェクト同士は等しいとされる)
return 0;

}
“`

また、二つの時刻間の差分を秒数またはミリ秒数で取得することもできます。これにはsecsTo()またはmsecsTo()メソッドを使用します。これらのメソッドは、呼び出し元オブジェクトから引数で指定された時刻までの差分を計算します。

“`cpp

include

include

int main() {
QTime time1(10, 30, 0);
QTime time2(11, 0, 0);
QTime time3(10, 0, 0);

// time1 から time2 までの秒数
qDebug() << "Seconds from time1 to time2:" << time1.secsTo(time2); // 1800 (30分 = 1800秒)

// time1 から time3 までのミリ秒数 (time3はtime1より早い時刻)
qDebug() << "Milliseconds from time1 to time3:" << time1.msecsTo(time3); // -1800000 (30分 = 1800000ミリ秒)

// 無効な時刻との差分計算は無効な結果を返す
QTime invalidTime;
qDebug() << "Seconds from time1 to invalidTime:" << time1.secsTo(invalidTime); // 0 (無効なQTimeに対するsecsTo/msecsToの戻り値は0となる)
return 0;

}
“`

secsTo()とmsecsTo()は、差分が負になることもあります（呼び出し元オブジェクトが引数より遅い時刻の場合）。無効なQTimeに対してこれらのメソッドを呼び出すと、結果は保証されず、通常は0が返されます。

2.4 時刻の演算

QTimeオブジェクトに対して、秒数またはミリ秒数を加算/減算して新しいQTimeオブジェクトを作成できます。これにはaddSecs()またはaddMSecs()メソッドを使用します。

“`cpp

include

include

int main() {
QTime time(10, 30, 0); // 10:30:00

// 30分 (1800秒) 加算
QTime addedTime = time.addSecs(1800);
qDebug() << time.toString("hh:mm:ss") << "+ 1800 secs =" << addedTime.toString("hh:mm:ss"); // 11:00:00

// 1時間30分 (90分 * 60秒 = 5400秒) 減算
QTime subtractedTime = time.addSecs(-5400);
qDebug() << time.toString("hh:mm:ss") << "- 5400 secs =" << subtractedTime.toString("hh:mm:ss"); // 09:00:00

// ミリ秒単位での加算
QTime timeWithMs(10, 30, 0, 500); // 10:30:00.500
QTime addedMsTime = timeWithMs.addMSecs(750); // 750ミリ秒加算
qDebug() << timeWithMs.toString("hh:mm:ss.zzz") << "+ 750 msecs =" << addedMsTime.toString("hh:mm:ss.zzz"); // 10:30:01.250

// 24時間を超える加算（ラップアラウンド）
QTime eveningTime(23, 0, 0); // 23:00:00
QTime overnightTime = eveningTime.addSecs(3600); // 1時間 (3600秒) 加算
// QTimeは日付情報を持たないので、24時を超えると00:00から再開（ラップアラウンド）します。
qDebug() << eveningTime.toString("hh:mm:ss") << "+ 3600 secs =" << overnightTime.toString("hh:mm:ss"); // 00:00:00

return 0;

}
“`

addSecs()やaddMSecs()は、結果として24時間を超える時刻になった場合、時刻が00:00:00.000から再開される（ラップアラウンドする）点に注意が必要です。これはQTimeが日付情報を持たないためです。日付を考慮した演算が必要な場合は、QDateTimeを使用する必要があります。

2.5 経過時間の計測

QTimeは、簡単な処理の経過時間を計測する用途にも使用できます。これにはstart(), elapsed(), restart()メソッドを使います。

  • start(): タイマーを開始します。内部的に現在の時刻を記録します。
  • elapsed(): start()またはrestart()が最後に呼び出されてからの経過ミリ秒数を返します。
  • restart(): タイマーをリセットして再開し、リセット前の経過ミリ秒数を返します。

“`cpp

include

include

include // シミュレーション用の遅延のため

int main() {
QTime timer;
timer.start(); // タイマー開始

// 何らかの処理...
QThread::msleep(150); // 150ミリ秒待機（処理のシミュレーション）

int elapsedMs = timer.elapsed(); // 経過時間を取得
qDebug() << "Elapsed time (first part):" << elapsedMs << "ms"; // およそ150ms

// さらに別の処理...
QThread::msleep(100); // 100ミリ秒待機

elapsedMs = timer.elapsed(); // 再び経過時間を取得 (startからの合計時間)
qDebug() << "Elapsed time (total):" << elapsedMs << "ms"; // およそ250ms

// タイマーをリセットして再開
int elapsedBeforeRestart = timer.restart(); // restartを呼び出した時点までの経過時間を取得し、タイマーを再開
qDebug() << "Elapsed time before restart:" << elapsedBeforeRestart << "ms"; // およそ250ms

// 別の処理...
QThread::msleep(50); // 50ミリ秒待機

elapsedMs = timer.elapsed(); // restartからの経過時間を取得
qDebug() << "Elapsed time after restart:" << elapsedMs << "ms"; // およそ50ms

return 0;

}
“`

QTimeのelapsed()による計測は、システムクロックの分解能に依存し、それほど高精度ではありません。ミリ秒単位の精度が必要な場合に適しています。マイクロ秒やナノ秒といったより高い精度で時間計測を行いたい場合は、QElapsedTimerクラスを使用することを検討してください。QElapsedTimerはシステムの高精度タイマーを利用可能な場合にそちらを使用します。

2.6 文字列との変換

QTimeオブジェクトと文字列との相互変換は、表示や入出力において非常に重要です。

QTimeから文字列へ

toString()メソッドは、QTimeオブジェクトを指定したフォーマットの文字列に変換します。フォーマット文字列には、以下のような要素を含めることができます。

要素 意味 例 (時刻 14:05:08.123, AM/PMあり)
h 時 (0-23) 14
hh 時 (00-23), 0埋め 14
H 時 (1-12), AM/PMなし 2
HH 時 (01-12), AM/PMなし, 0埋め 02
m 分 (0-59) 5
mm 分 (00-59), 0埋め 05
s 秒 (0-59) 8
ss 秒 (00-59), 0埋め 08
z ミリ秒 (0-999), 0埋めなし 123
zzz ミリ秒 (000-999), 0埋め 123
AP AMまたはPM PM
ap amまたはpm pm
'文字' シングルクォートで囲まれた文字はそのまま表示される ‘:’,’.’ など

よく使われるフォーマット例:

  • "hh:mm:ss": 0埋めされた時:分:秒 (例: 14:05:08)
  • "h:m:s": 0埋めなしの時:分:秒 (例: 14:5:8)
  • "hh:mm:ss.zzz": 時:分:秒.ミリ秒 (例: 14:05:08.123)
  • "h:m:s.z": 時:分:秒.ミリ秒 (例: 14:5:8.123)
  • "HH:mm AP": 12時間制、AM/PM付き (例: 02:05 PM)

また、定義済みのQt::DateFormat enumを使用することもできますが、これらは主にQDateTimeで日付と共に使われるものです。QTime単体でよく使うのはカスタムフォーマット文字列です。

“`cpp

include

include

int main() {
QTime time(14, 5, 8, 123);

qDebug() << "hh:mm:ss   :" << time.toString("hh:mm:ss");
qDebug() << "h:m:s      :" << time.toString("h:m:s");
qDebug() << "hh:mm:ss.zzz:" << time.toString("hh:mm:ss.zzz");
qDebug() << "h:m:s.z    :" << time.toString("h:m:s.z");
qDebug() << "HH:mm AP   :" << time.toString("HH:mm AP"); // Note: The output depends on whether the time is in the AM or PM range. 14 is PM.
qDebug() << "HH:mm ap   :" << time.toString("HH:mm ap");

QTime amTime(9, 30, 0);
qDebug() << "09:30 AM/PM:" << amTime.toString("HH:mm AP"); // 09:30 AM

// 無効な時刻を文字列に変換すると、空文字列や特定の表示になる
QTime invalidTime;
qDebug() << "Invalid time string:" << invalidTime.toString("hh:mm:ss"); // 通常は空文字列
return 0;

}
“`

無効なQTimeオブジェクトに対してtoString()を呼び出すと、通常は空の文字列が返されます。

文字列からQTimeへ

静的メソッドであるfromString()は、指定されたフォーマット文字列に基づいて、文字列をQTimeオブジェクトに変換します。変換が成功した場合は有効なQTimeオブジェクトが、失敗した場合は無効なQTimeオブジェクトが返されます。

“`cpp

include

include

int main() {
QString timeString1 = “10:30:15”;
QString format1 = “hh:mm:ss”;
QTime time1 = QTime::fromString(timeString1, format1);
qDebug() << “String:” << timeString1 << “Format:” << format1 << “Valid:” << time1.isValid() << “Time:” << time1.toString(format1);

QString timeString2 = "2:05 PM";
QString format2 = "HH:mm AP"; // 12時間制のフォーマット
QTime time2 = QTime::fromString(timeString2, format2);
qDebug() << "String:" << timeString2 << "Format:" << format2 << "Valid:" << time2.isValid() << "Time:" << time2.toString(format2); // toStringも同じフォーマットを使うのが安全

QString timeString3 = "10-30-15"; // フォーマットと合わない文字列
QString format3 = "hh:mm:ss";
QTime time3 = QTime::fromString(timeString3, format3);
qDebug() << "String:" << timeString3 << "Format:" << format3 << "Valid:" << time3.isValid(); // Valid: false

return 0;

}
“`

fromString()を使う際は、文字列のフォーマットと指定するフォーマット文字列が正確に一致している必要があります。一致しない場合や、有効な時刻を表さない文字列（例: “25:00:00″）の場合は、無効なQTimeオブジェクトが返されます。

2.7 QTimeの例題

QTimeを使った簡単な例をいくつか示します。

例1：シンプルなストップウォッチ

QTimeのstart()とelapsed()を使って、簡単なストップウォッチをシミュレーションします。（GUIアプリケーションではQTimerと連携してUIを更新しますが、ここではコンソールで概念を示します。）

“`cpp

include

include

include // より正確な計測のため、こちらの方が適切だが、ここではQTimeのelapsedを使う例として示す

include

int main() {
QTime timer;
qDebug() << “Press Enter to start…”;
QTextStream cin(stdin);
cin.readLine();

timer.start(); // 計測開始
qDebug() << "Started! Press Enter to stop...";

cin.readLine();
int elapsedMs = timer.elapsed(); // 計測終了

qDebug() << "Stopped!";
qDebug() << "Elapsed time:" << elapsedMs << "ms";

// QTime::elapsed()の精度はシステム依存です。
// より高精度が必要な場合はQElapsedTimerを使用してください。
// 簡単な比較
QElapsedTimer highResTimer;
highResTimer.start();
QThread::msleep(100);
qDebug() << "QTime elapsed for 100ms sleep:" << QTime().restart() << "ms"; // restart()は経過時間取得とリセットを同時に行う
qDebug() << "QElapsedTimer elapsed for 100ms sleep:" << highResTimer.elapsed() << "ms";

return 0;

}
“`

この例ではQTimeを使っていますが、高精度なストップウォッチやタイマーが必要な場合は、QElapsedTimerクラスを使う方が適切です。QElapsedTimerはシステムが提供する高精度タイマーを利用可能な場合にそちらを使用します。

例2：特定の時間範囲内かどうかの判定

ある時刻が、一日の特定の時間範囲内にあるかどうかを判定します。

“`cpp

include

include

int main() {
QTime currentTime = QTime::currentTime(); // 現在時刻を取得

QTime startTime(9, 0, 0);  // 午前9時00分00秒
QTime endTime(17, 0, 0);   // 午後5時00分00秒 (17時)

qDebug() << "Current time:" << currentTime.toString("hh:mm:ss");
qDebug() << "Start time:" << startTime.toString("hh:mm:ss");
qDebug() << "End time:" << endTime.toString("hh:mm:ss");

// 開始時刻 <= 現在時刻 < 終了時刻 で判定 (終了時刻ちょうどは含まない場合)
// 終了時刻を含める場合は <= を使用します。
if (currentTime >= startTime && currentTime < endTime) {
    qDebug() << "Current time is within the working hours (9:00 - 17:00).";
} else {
    qDebug() << "Current time is outside the working hours.";
}

// 別の日を跨ぐ時間範囲 (例: 22:00 から 翌日 06:00) の判定
// QTime単体では日付を考慮しないため、少し工夫が必要です。
// 22:00 - 23:59 の範囲 または 00:00 - 06:00 の範囲
QTime overnightStart(22, 0, 0); // 22:00
QTime overnightEnd(6, 0, 0);   // 06:00 (翌日)

qDebug() << "\nChecking for overnight range (22:00 to 06:00):";
qDebug() << "Current time:" << currentTime.toString("hh:mm:ss");
qDebug() << "Overnight start:" << overnightStart.toString("hh:mm:ss");
qDebug() << "Overnight end:" << overnightEnd.toString("hh:mm:ss");

bool isOvernight = false;
if (overnightStart < overnightEnd) { // 開始時刻 < 終了時刻 (日を跨がない)
     if (currentTime >= overnightStart && currentTime < overnightEnd) {
         isOvernight = true;
     }
} else { // 開始時刻 >= 終了時刻 (日を跨ぐ)
     if (currentTime >= overnightStart || currentTime < overnightEnd) {
         isOvernight = true;
     }
}

if (isOvernight) {
    qDebug() << "Current time is within the overnight range.";
} else {
    qDebug() << "Current time is outside the overnight range.";
}


return 0;

}
“`

日を跨ぐ時間範囲の判定は、QTime単体では少し複雑になります。よりシンプルに日付と時刻を考慮した時間範囲の判定を行う場合は、QDateTimeを使用するのがより自然です。

第3章 Qtにおける日付と時刻の管理：QDateTime

QDateTimeクラスは、日付と時刻の両方の情報、そしてタイムゾーン情報を持つオブジェクトを扱います。ログのタイムスタンプ、ファイルシステムの更新日時、イベントの発生時刻など、日付と時刻の両方が必要なあらゆる場面で使用されます。

QDateTimeは内部的に、Unix epoch（1970年1月1日 00:00:00 UTC）からの経過ミリ秒数として日付と時刻を保持しており、これにタイムゾーン情報やUTCからのオフセット情報を紐づけて管理します。

3.1 QDateTimeオブジェクトの生成

QDateTimeオブジェクトを作成する方法は多様です。

現在のシステム日付時刻を取得する

静的メソッドcurrentDateTime()は、システムのローカルタイムゾーンでの現在の日付と時刻を含むQDateTimeオブジェクトを返します。currentDateTimeUtc()は、UTC（協定世界時）での現在の日付と時刻を返します。

“`cpp

include

include

int main() {
QDateTime currentLocal = QDateTime::currentDateTime();
qDebug() << “Current local date and time:” << currentLocal.toString(Qt::ISODate);

QDateTime currentUtc = QDateTime::currentDateTimeUtc();
qDebug() << "Current UTC date and time:" << currentUtc.toString(Qt::ISODate);

return 0;

}
“`

toString(Qt::ISODate)は、日付と時刻をISO 8601形式（例: “YYYY-MM-DDTHH:mm:ss”）で文字列に変換する便利な方法です。

Unix epochからの秒数/ミリ秒数で生成する

Unix epoch（1970年1月1日 00:00:00 UTC）からの経過秒数またはミリ秒数を指定してQDateTimeオブジェクトを作成できます。これは、ファイルシステムのタイムスタンプやネットワークプロトコルなどでよく使用される形式です。静的メソッドfromSecsSinceEpoch()またはfromMSecsSinceEpoch()を使用します。

“`cpp

include

include

int main() {
qint64 unixTimeSecs = 1678886400; // 例: 2023-03-15 00:00:00 UTC
QDateTime dateTimeFromSecs = QDateTime::fromSecsSinceEpoch(unixTimeSecs);
qDebug() << “From Unix seconds:” << dateTimeFromSecs.toString(Qt::ISODate); // UTCで表示されることが多い

qint64 unixTimeMSecs = 1678886400123; // 例: 2023-03-15 00:00:00.123 UTC
QDateTime dateTimeFromMSecs = QDateTime::fromMSecsSinceEpoch(unixTimeMSecs);
qDebug() << "From Unix milliseconds:" << dateTimeFromMSecs.toString(Qt::ISODate); // UTCで表示されることが多い

return 0;

}
“`

これらのメソッドで作成されたQDateTimeオブジェクトは、デフォルトでUTCとして解釈されます。ローカルタイムに変換するにはtoLocalTime()を呼び出します。

指定した日付と時刻、タイムゾーンで生成する

QDateオブジェクトとQTimeオブジェクトを組み合わせてQDateTimeオブジェクトを作成できます。また、作成時にタイムゾーンを指定することも可能です。

“`cpp

include

include

include

include

include

int main() {
QDate date(2023, 10, 27);
QTime time(14, 30, 0);

// ローカルタイムとして作成
QDateTime localDateTime(date, time); // デフォルトはQt::LocalTime
qDebug() << "Local date and time:" << localDateTime.toString(Qt::ISODate);
qDebug() << "Time specification:" << localDateTime.timeSpec(); // Qt::LocalTime

// UTCとして作成
QDateTime utcDateTime(date, time, Qt::UTC);
qDebug() << "UTC date and time:" << utcDateTime.toString(Qt::ISODate);
qDebug() << "Time specification:" << utcDateTime.timeSpec(); // Qt::UTC

// 特定のタイムゾーンで作成 (Qt 5.2以降、QTimeZoneを使用するのが推奨)
QTimeZone nyZone("America/New_York");
if (nyZone.isValid()) {
    QDateTime nyDateTime(date, time, nyZone);
    qDebug() << "New York date and time (2023-10-27 14:30):" << nyDateTime.toString(Qt::ISODateWithMs);
    qDebug() << "Time specification:" << nyDateTime.timeSpec(); // Qt::TimeZone
    qDebug() << "Time zone ID:" << nyDateTime.timeZone().id();

    // このNY時刻をローカルタイムに変換
    qDebug() << "... in local time:" << nyDateTime.toLocalTime().toString(Qt::ISODateWithMs);

} else {
    qDebug() << "Could not create New York time zone.";
}


// 無効な日付/時刻を指定した場合
QDate invalidDate(2023, 2, 30); // 2月30日は存在しない
QDateTime invalidDateTime(invalidDate, time);
qDebug() << "Is invalid date/time valid?" << invalidDateTime.isValid(); // false

return 0;

}
“`

QDateTime(date, time, timeSpec)の形式では、timeSpecとしてQt::LocalTime, Qt::UTC, Qt::OffsetFromUTC, Qt::TimeZoneを指定できます。ただし、Qt::OffsetFromUTCとQt::TimeZoneは非推奨になり、代わりにQTimeZoneオブジェクトを明示的に渡すコンストラクタQDateTime(date, time, timeZone)を使用することが推奨されています（Qt 5.2以降）。

無効なQDateやQTimeオブジェクトを組み合わせて作成した場合、結果のQDateTimeオブジェクトも無効になります。

無効なQDateTimeオブジェクトを生成する

デフォルトコンストラクタQDateTime()は、無効なQDateTimeオブジェクトを作成します。

“`cpp

include

include

int main() {
QDateTime nullDateTime;
qDebug() << “Is null date/time valid?” << nullDateTime.isValid(); // false
qDebug() << “Is null date/time null?” << nullDateTime.isNull(); // true
return 0;
}
“`

isNull()メソッドは、デフォルトコンストラクタで作成されたような、無効かつ特別な「Null」状態のオブジェクトを判定します。無効なQDateTimeは必ずしもisNull()がtrueになるとは限りませんが（例: 無効な日付で作成した場合）、isNull()がtrueならば必ずisValid()はfalseになります。

3.2 日付・時刻要素の取得

QDateTimeオブジェクトから、含まれるQDateとQTimeオブジェクトを取得できます。

“`cpp

include

include

int main() {
QDateTime dateTime = QDateTime::currentDateTime();

QDate date = dateTime.date();
QTime time = dateTime.time();

qDebug() << "Full date and time:" << dateTime.toString(Qt::ISODate);
qDebug() << "Date part:" << date.toString(Qt::ISODate);
qDebug() << "Time part:" << time.toString(Qt::ISODate); // QTime::toStringに渡すと時刻のみのISO形式

qDebug() << "Year:" << date.year();
qDebug() << "Month:" << date.month();
qDebug() << "Day:" << date.day();
qDebug() << "Hour:" << time.hour();
qDebug() << "Minute:" << time.minute();
qDebug() << "Second:" << time.second();
qDebug() << "Millisecond:" << time.msec();

qDebug() << "Is valid?" << dateTime.isValid();
return 0;

}
“`

QDateクラスについては後で補足します。

3.3 タイムゾーンの扱い

QDateTimeの最も重要な機能の一つは、タイムゾーンを扱えることです。これにより、システムのローカルタイム、UTC、あるいは特定のタイムゾーンでの時刻を正確に表現し、それらの間で変換を行うことができます。

タイムゾーンの種類と指定

QDateTimeは、以下のいずれかのタイムゾーン指定（Time Specification）を持つことができます。

  • Qt::LocalTime: システムのローカルタイムゾーン。
  • Qt::UTC: 協定世界時。
  • Qt::OffsetFromUTC: UTCからの固定オフセット（例: +09:00）。
  • Qt::TimeZone: IANAタイムゾーンデータベースに基づく特定のタイムゾーン（例: “Asia/Tokyo”, “America/New_York”）。

Qt::OffsetFromUTCと旧来のQt::TimeZoneコンストラクタは非推奨であり、QTimeZoneクラスを使った新しいAPIが推奨されています。

QDateTimeのタイムゾーン変換

QDateTimeオブジェクトを異なるタイムゾーンに変換するには、以下のメソッドを使用します。

  • toLocalTime(): オブジェクトをローカルタイムゾーンに変換した新しいQDateTimeを返します。
  • toUTC(): オブジェクトをUTCに変換した新しいQDateTimeを返します。
  • toTimeZone(timeZone): オブジェクトを指定したQTimeZoneに変換した新しいQDateTimeを返します。
  • setTimeZone(timeZone): オブジェクト自体のタイムゾーンを指定したQTimeZoneに変更します（内部的なUTCからの経過ミリ秒は変わりません）。

“`cpp

include

include

include

int main() {
// 現在のローカルタイム
QDateTime localNow = QDateTime::currentDateTime();
qDebug() << “Local now:” << localNow.toString(Qt::ISODateWithMs);
qDebug() << “Local TimeSpec:” << localNow.timeSpec();

// ローカルタイムをUTCに変換
QDateTime utcNow = localNow.toUTC();
qDebug() << "UTC now:" << utcNow.toString(Qt::ISODateWithMs);
qDebug() << "UTC TimeSpec:" << utcNow.timeSpec();

// UTCをローカルタイムに変換 (元に戻る)
QDateTime localNowFromUtc = utcNow.toLocalTime();
qDebug() << "Local now (from UTC):" << localNowFromUtc.toString(Qt::ISODateWithMs);

// 特定のタイムゾーンに変換 (例: ロンドン時間 GMT/BST)
QTimeZone londonZone("Europe/London");
if (londonZone.isValid()) {
    QDateTime londonTime = localNow.toTimeZone(londonZone);
    qDebug() << "London time:" << londonTime.toString(Qt::ISODateWithMs);
    qDebug() << "London TimeSpec:" << londonTime.timeSpec(); // QDateTimeは内部的にQTimeZoneを保持するようになる
    qDebug() << "London TimeZone ID:" << londonTime.timeZone().id();

    // 注意： toTimeZone() は新しいQDateTimeオブジェクトを返します。
    // 元の localNow オブジェクトは変更されません。
    qDebug() << "Original localNow still has TimeSpec:" << localNow.timeSpec();

    // setTimeZone() はオブジェクト自体を変更します。
    // これは、内部的なUTCからの経過ミリ秒を変えずに、
    // その値をどのタイムゾーンで解釈するかを変更する操作です。
    // 例: ローカルタイムの 2023-10-27 14:30 が、
    // "これをロンドン時間 2023-10-27 14:30 とみなす" という意味になる。
    // この操作は通常、文字列からの解析時などに使用されます。
    QDateTime dt = QDateTime::currentDateTime(); // 例: 2023-10-27 14:30 JST
    qDebug() << "\nOriginal (local):" << dt.toString(Qt::ISODateWithMs); // JST (LocalTime)

    dt.setTimeZone(londonZone);
    qDebug() << "After setTimeZone(London) (same internal value, diff interpretation):";
    qDebug() << "... as London time:" << dt.toString(Qt::ISODateWithMs); // London time representation
    qDebug() << "... as Local time:" << dt.toLocalTime().toString(Qt::ISODateWithMs); // Convert the "London-interpreted" time to local time. This will likely be different from the original time.

} else {
    qDebug() << "Could not create London time zone.";
}

return 0;

}
“`

toLocalTime(), toUTC(), toTimeZone() は新しいオブジェクトを返すのに対し、setTimeZone() は呼び出し元のオブジェクトを変更します。setTimeZone() は、例えば文字列から日付時刻をパースし、それが特定のタイムゾーンの時刻であることがわかっている場合に、そのオブジェクトのタイムゾーン指定を後から設定するといった用途で使われます。

QTimeZoneクラスの詳細

QTimeZoneクラスはQt 5.2で導入され、より正確で詳細なタイムゾーン情報の取り扱いを可能にしました。IANAタイムゾーンデータベース（tz database）に基づいた世界中のタイムゾーンをサポートしています。

QTimeZoneの主な機能：

  • 利用可能なタイムゾーンIDの取得: QTimeZone::availableTimeZoneIds()
  • システムタイムゾーン、UTCタイムゾーンの取得: QTimeZone::systemTimeZone(), QTimeZone::utc()
  • タイムゾーンオブジェクトの作成: ID文字列を指定 (QTimeZone(id))
  • 表示名の取得: displayName() (標準名、夏時間名、略称など)
  • オフセット情報の取得: standardTimeOffset(), daylightTimeOffset(), offsetFromUtc()
  • サマータイム（夏時間）の判定: isDaylightTime(), hasDaylightTime()

“`cpp

include

include

include

int main() {
// システムタイムゾーン
QTimeZone systemTZ = QTimeZone::systemTimeZone();
qDebug() << “System Time Zone ID:” << systemTZ.id();
qDebug() << “System Time Zone Display Name:” << systemTZ.displayName(QTimeZone::StandardTime); // または DaylightTime, GenericTime

// UTCタイムゾーン
QTimeZone utcTZ = QTimeZone::utc();
qDebug() << "UTC Time Zone ID:" << utcTZ.id();
qDebug() << "UTC Offset from UTC:" << utcTZ.offsetFromUtc(QDateTime::currentDateTimeUtc()) / 3600 << "hours"; // オフセットは秒で返される

// 特定のタイムゾーン
QTimeZone tokyoTZ("Asia/Tokyo");
if (tokyoTZ.isValid()) {
    qDebug() << "\nAsia/Tokyo Time Zone:";
    qDebug() << "ID:" << tokyoTZ.id();
    qDebug() << "Display Name (Standard):" << tokyoTZ.displayName(QTimeZone::StandardTime); // Japan Standard Time
    qDebug() << "Display Name (Generic):" << tokyoTZ.displayName(QTimeZone::GenericTime); // Japan Time
    qDebug() << "Comment:" << tokyoTZ.comment();

    // 現在時刻におけるAsia/Tokyoのオフセット
    QDateTime nowUtc = QDateTime::currentDateTimeUtc();
    qDebug() << "Offset from UTC (now):" << tokyoTZ.offsetFromUtc(nowUtc) / 3600 << "hours"; // +9 hours

    // サマータイムがあるかどうか (日本では現在ありません)
    qDebug() << "Has daylight time?" << tokyoTZ.hasDaylightTime(); // false

    // 特定の日時でのオフセットやサマータイム判定
    QDateTime dateTimeInTokyo(QDate(2023, 7, 1), QTime(12, 0), tokyoTZ); // 2023-07-01 12:00 in Tokyo
    qDebug() << "Time in Tokyo (2023-07-01 12:00):" << dateTimeInTokyo.toString(Qt::ISODate);
    qDebug() << "Offset from UTC for this time:" << tokyoTZ.offsetFromUtc(dateTimeInTokyo) / 3600 << "hours";
    qDebug() << "Is daylight time for this time?" << tokyoTZ.isDaylightTime(dateTimeInTokyo); // false (日本ではサマータイムなし)

    // サマータイムがあるタイムゾーンの例 (例: ニューヨーク)
    QTimeZone nyTZ("America/New_York");
    if (nyTZ.isValid() && nyTZ.hasDaylightTime()) {
         qDebug() << "\nAmerica/New_York Time Zone (with Daylight Saving):";
         QDateTime winterTime(QDate(2023, 1, 1), QTime(12, 0), nyTZ); // 2023-01-01 12:00 in NY (冬時間)
         QDateTime summerTime(QDate(2023, 7, 1), QTime(12, 0), nyTZ); // 2023-07-01 12:00 in NY (夏時間)

         qDebug() << "Winter time (2023-01-01 12:00 NY):" << winterTime.toString(Qt::ISODateWithMs);
         qDebug() << "Offset from UTC (winter):" << nyTZ.offsetFromUtc(winterTime) / 3600 << "hours"; // -5 hours (EST)
         qDebug() << "Is daylight time (winter)?" << nyTZ.isDaylightTime(winterTime); // false

         qDebug() << "Summer time (2023-07-01 12:00 NY):" << summerTime.toString(Qt::ISODateWithMs);
         qDebug() << "Offset from UTC (summer):" << nyTZ.offsetFromUtc(summerTime) / 3600 << "hours"; // -4 hours (EDT)
         qDebug() << "Is daylight time (summer)?" << nyTZ.isDaylightTime(summerTime); // true
    }
} else {
    qDebug() << "Could not create Asia/Tokyo time zone.";
}

// 利用可能なタイムゾーンIDの一部を表示
QStringList availableIds = QTimeZone::availableTimeZoneIds();
qDebug() << "\nFirst 10 available time zone IDs:";
for (int i = 0; i < qMin(10, availableIds.size()); ++i) {
    qDebug() << availableIds.at(i);
}

return 0;

}
“`

QTimeZoneを使用することで、タイムゾーンのルール（オフセット、サマータイムなど）に基づいた正確な時刻計算や変換が可能になります。QDateTimeとQTimeZoneを組み合わせることで、国際的なアプリケーションでの時間処理を適切に実装できます。

3.4 日付・時刻の演算

QDateTimeオブジェクトに対して、日、月、年、秒、ミリ秒を単位として加算/減算を行うことができます。これらの演算メソッドは、結果として新しいQDateTimeオブジェクトを返します。

“`cpp

include

include

int main() {
QDateTime original(QDate(2023, 10, 27), QTime(14, 30, 0));
qDebug() << “Original:” << original.toString(Qt::ISODate);

// 日数の加算/減算
QDateTime addedDays = original.addDays(10); // 10日後
qDebug() << "Add 10 days:" << addedDays.toString(Qt::ISODate); // 2023-11-06T14:30:00

QDateTime subtractedDays = original.addDays(-5); // 5日前
qDebug() << "Subtract 5 days:" << subtractedDays.toString(Qt::ISODate); // 2023-10-22T14:30:00

// 月数の加算/減算
QDateTime addedMonths = original.addMonths(3); // 3ヶ月後
qDebug() << "Add 3 months:" << addedMonths.toString(Qt::ISODate); // 2024-01-27T14:30:00 (うるう年考慮、月末処理も適切に行われる)

// 年数の加算/減算
QDateTime addedYears = original.addYears(1); // 1年後
qDebug() << "Add 1 year:" << addedYears.toString(Qt::ISODate); // 2024-10-27T14:30:00

// 秒数/ミリ秒数の加算/減算
QDateTime addedSecs = original.addSecs(3600); // 1時間後 (3600秒)
qDebug() << "Add 1 hour:" << addedSecs.toString(Qt::ISODate); // 2023-10-27T15:30:00

QDateTime addedMSecs = original.addMSecs(5000); // 5秒後 (5000ミリ秒)
qDebug() << "Add 5 seconds:" << addedMSecs.toString(Qt::ISODate); // 2023-10-27T14:30:05

// 注意：うるう秒はQDateTimeでは考慮されません。
// うるう年や月末（例: 1月31日に1ヶ月加算すると2月28日/29日になる）は適切に処理されます。

// 異なるQDateTime間の差分
QDateTime future(QDate(2024, 10, 27), QTime(14, 30, 0));
qint64 secsDiff = original.secsTo(future);
qDebug() << "Seconds from original to future:" << secsDiff; // 31536000 (閏年ではない場合の1年間の秒数)

qint64 msecsDiff = original.msecsTo(future);
qDebug() << "Milliseconds from original to future:" << msecsDiff; // 31536000000

// 異なるタイムゾーン間の差分も計算される (UTCからの差分に基づく)
QTimeZone nyTZ("America/New_York"); // 例えばUTC-5h
QDateTime nyTime(QDate(2023, 10, 27), QTime(14, 30, 0), nyTZ); // NY時間 2023-10-27 14:30

qDebug() << "\nOriginal (local):" << original.toString(Qt::ISODate); // ローカル(JST +9h) 2023-10-27 14:30
qDebug() << "NY Time:" << nyTime.toString(Qt::ISODate); // NY (-5h) 2023-10-27 14:30

// original (local) から nyTime までの差分
// original(local: +9h) は UTCで 2023-10-27 05:30:00 に相当
// nyTime(-5h) は UTCで 2023-10-27 19:30:00 に相当
// 差分は 19:30:00 - 05:30:00 = 14時間
qint64 diffSecsDifferentTZ = original.secsTo(nyTime);
qDebug() << "Seconds from original(local) to nyTime(-5h):" << diffSecsDifferentTZ; // 14 * 3600 = 50400

return 0;

}
“`

add...系のメソッドは日付のルール（月末、うるう年）を適切に処理します。secsTo()やmsecsTo()は、オブジェクトが持つ内部的なUTCからの経過ミリ秒に基づいて差分を計算するため、タイムゾーンが異なるオブジェクト間の差分も正しく計算できます。

3.5 Unix時間との相互変換

Unix時間（エポック秒またはエポックミリ秒）は、多くのシステムやプロトコルで日付時刻を表すために使用されます。QDateTimeは、Unix epoch（1970年1月1日 00:00:00 UTC）からの経過秒数またはミリ秒数との相互変換機能を提供します。

QDateTimeからUnix時間へ

toSecsSinceEpoch()とtoMSecsSinceEpoch()メソッドは、QDateTimeオブジェクトが表す時刻を、Unix epochからの経過秒数またはミリ秒数（UTC基準）として返します。戻り値の型はqint64です。

“`cpp

include

include

int main() {
QDateTime dt(QDate(2023, 3, 15), QTime(0, 0, 0), Qt::UTC); // 2023-03-15 00:00:00 UTC
qDebug() << “UTC Date/Time:” << dt.toString(Qt::ISODate);

qint64 epochSecs = dt.toSecsSinceEpoch();
qint64 epochMSecs = dt.toMSecsSinceEpoch();

qDebug() << "Epoch seconds:" << epochSecs; // 1678886400
qDebug() << "Epoch milliseconds:" << epochMSecs; // 1678886400000

// ローカルタイムのQDateTimeをUnix時間へ変換する場合
QDateTime localDt = QDateTime::currentDateTime(); // 例: 2023-10-27 14:30:00 JST
qDebug() << "\nLocal Date/Time:" << localDt.toString(Qt::ISODate);
qDebug() << "Local Date/Time as Epoch seconds:" << localDt.toSecsSinceEpoch(); // これはlocalDtをUTCに変換してから計算される
qDebug() << "Local Date/Time as Epoch milliseconds:" << localDt.toMSecsSinceEpoch();

// 常にUTC基準で計算されることを確認
QDateTime localDtFromEpoch = QDateTime::fromSecsSinceEpoch(localDt.toSecsSinceEpoch());
qDebug() << "Epoch seconds back to DateTime (UTC):" << localDtFromEpoch.toString(Qt::ISODate); // これはUTC時刻になる
qDebug() << "Epoch seconds back to DateTime (Local):" << localDtFromEpoch.toLocalTime().toString(Qt::ISODate); // ローカルに戻すと元の時刻になる

return 0;

}
“`

toSecsSinceEpoch()とtoMSecsSinceEpoch()は、QDateTimeオブジェクトのタイムゾーン設定に関わらず、内部的なUTCでの時刻に基づいて計算を行います。

Unix時間からQDateTimeへ

前述の通り、静的メソッドfromSecsSinceEpoch()とfromMSecsSinceEpoch()を使用して、Unix時間からQDateTimeオブジェクトを作成できます。これらのメソッドで作成されたQDateTimeオブジェクトは、タイムゾーン指定がQt::UTCとなります。

“`cpp

include

include

int main() {
qint64 epochSecs = 1678886400; // 2023-03-15 00:00:00 UTC
QDateTime dtUtc = QDateTime::fromSecsSinceEpoch(epochSecs);
qDebug() << “From epoch seconds:” << dtUtc.toString(Qt::ISODate); // UTCとして表示
qDebug() << “TimeSpec:” << dtUtc.timeSpec(); // Qt::UTC

// ローカルタイムとして扱いたい場合は変換が必要
qDebug() << "... as local time:" << dtUtc.toLocalTime().toString(Qt::ISODate);

qint64 epochMSecs = 1678886400500; // 2023-03-15 00:00:00.500 UTC
QDateTime dtUtcAms = QDateTime::fromMSecsSinceEpoch(epochMSecs);
 qDebug() << "From epoch milliseconds:" << dtUtcAms.toString(Qt::ISODateWithMs); // UTCとして表示
qDebug() << "TimeSpec:" << dtUtcAms.timeSpec(); // Qt::UTC
qDebug() << "... as local time:" << dtUtcAms.toLocalTime().toString(Qt::ISODateWithMs);

return 0;

}
“`

Unix時間との相互変換は、異なるシステム間で日付時刻情報を交換する際に非常に役立ちます。

3.6 文字列との変換

QDateTimeオブジェクトと文字列との相互変換は、QTimeと同様にtoString()とfromString()メソッドを使用します。ただし、日付、時刻、タイムゾーンの情報を含むため、フォーマット文字列はより多くの要素をサポートします。

QDateTimeから文字列へ

toString()メソッドは、QDateTimeを指定したフォーマットの文字列に変換します。QDateとQTimeで利用可能なすべてのフォーマット要素に加え、日付時刻全体やタイムゾーンに関する要素も使用できます。

要素 意味 例 (2023-10-27 14:05:08.123 JST(+09:00))
d 日 (1-31) 27
dd 日 (01-31), 0埋め 27
ddd 曜日略称 (Mon-Sun) Fri
dddd 曜日名 (Monday-Sunday) Friday
M 月 (1-12) 10
MM 月 (01-12), 0埋め 10
MMM 月略称 (Jan-Dec) Oct
MMMM 月名 (January-December) October
yy 年 (00-99) 23
yyyy 年 (4桁) 2023
h, hh, H, HH, m, mm, s, ss, z, zzz, AP, ap QTimeと同じ時刻要素 上記QTimeの表を参照
t タイムゾーン略称 (GMT, PST, JSTなど) JST
zz UTCからのオフセット (±HH:mm) +09:00
zzz UTCからのオフセット (±HHmm) +0900
Z UTCからのオフセット (±H) +9
'文字' シングルクォートで囲まれた文字
[ ] 角括弧はリテラル表示 [UTC] は “UTC” を表示

定義済みフォーマット:

Qt::DateFormat enumを使用すると、一般的なフォーマットで簡単に出力できます。

  • Qt::TextDate: ロケール依存の読みやすい形式 (例: “Fri Oct 27 14:05:08 2023”)
  • Qt::ISODate: ISO 8601形式 (例: “2023-10-27T14:05:08”)
  • Qt::ISODateWithMs: ISO 8601形式 (ミリ秒付き) (例: “2023-10-27T14:05:08.123”)
  • Qt::SystemLocaleShortDate: システムロケールの短い日付/時刻形式
  • Qt::SystemLocaleLongDate: システムロケールの長い日付/時刻形式
  • Qt::RFC2822Date: RFC 2822形式 (例: “Fri, 27 Oct 2023 14:05:08 +0900”)

ロケールを考慮した変換:

toString(format, locale)またはtoString(Qt::DateFormat, locale)を使用すると、指定したQLocaleに基づいて日付時刻をローカライズされた形式で表示できます。

“`cpp

include

include

include

include

int main() {
QDateTime dt(QDate(2023, 10, 27), QTime(14, 5, 8, 123), QTimeZone(“Asia/Tokyo”));

qDebug() << "Custom format (yyyy-MM-dd hh:mm:ss.zzz t):" << dt.toString("yyyy-MM-dd hh:mm:ss.zzz t"); // 2023-10-27 14:05:08.123 JST
qDebug() << "Custom format (dddd, MMMM d, yyyy HH:mm zz):" << dt.toString("dddd, MMMM d, yyyy HH:mm zz"); // Friday, October 27, 2023 14:05 +09:00

qDebug() << "\nPredefined formats:";
qDebug() << "Qt::TextDate:" << dt.toString(Qt::TextDate);
qDebug() << "Qt::ISODate:" << dt.toString(Qt::ISODate);
qDebug() << "Qt::ISODateWithMs:" << dt.toString(Qt::ISODateWithMs);
qDebug() << "Qt::RFC2822Date:" << dt.toString(Qt::RFC2822Date);

// ロケールを指定した変換
QLocale englishUs(QLocale::English, QLocale::UnitedStates);
QLocale japaneseJp(QLocale::Japanese, QLocale::Japan);

qDebug() << "\nLocalized formats:";
qDebug() << "English (US) - Short:" << dt.toString(Qt::SystemLocaleShortDate, englishUs); // 例: 10/27/23, 2:05 PM
qDebug() << "English (US) - Long:" << dt.toString(Qt::SystemLocaleLongDate, englishUs);   // 例: Friday, October 27, 2023 at 2:05:08 PM JST

qDebug() << "Japanese (JP) - Short:" << dt.toString(Qt::SystemLocaleShortDate, japaneseJp); // 例: 2023/10/27 14:05
qDebug() << "Japanese (JP) - Long:" << dt.toString(Qt::SystemLocaleLongDate, japaneseJp);   // 例: 2023年10月27日(金) 14時05分08秒 JST

// 無効なQDateTimeを文字列に変換
QDateTime invalidDt;
qDebug() << "\nInvalid DateTime string:" << invalidDt.toString(Qt::ISODate); // 通常は空文字列

return 0;

}
“`

ロケールを指定することで、アプリケーションを国際化対応する際に、ユーザーの地域設定に合わせた日付時刻形式で表示できます。

文字列からQDateTimeへ

静的メソッドfromString()は、文字列とフォーマット指定に基づいてQDateTimeオブジェクトを作成します。変換が成功した場合は有効なQDateTimeが返されます。

“`cpp

include

include

include

int main() {
QString dtString1 = “2023-10-27T14:30:00”;
QDateTime dt1 = QDateTime::fromString(dtString1, Qt::ISODate);
qDebug() << “String:” << dtString1 << “Valid:” << dt1.isValid() << “DateTime:” << dt1.toString(Qt::ISODate);
// ISO 8601形式の場合、タイムゾーン指定がないとQt::LocalTimeとして解釈されることがあるので注意

QString dtString2 = "Fri, 27 Oct 2023 14:05:08 +0900";
QDateTime dt2 = QDateTime::fromString(dtString2, Qt::RFC2822Date);
qDebug() << "String:" << dtString2 << "Valid:" << dt2.isValid() << "DateTime:" << dt2.toString(Qt::RFC2822Date);
// RFC 2822形式はタイムゾーン情報を含むため、QDateTimeはそのタイムゾーンを持つ

QString dtString3 = "2023/10/27 14:30";
QString format3 = "yyyy/MM/dd hh:mm";
QDateTime dt3 = QDateTime::fromString(dtString3, format3);
qDebug() << "String:" << dtString3 << "Valid:" << dt3.isValid() << "DateTime:" << dt3.toString(format3); // デフォルトはQt::LocalTime

// タイムゾーン情報を含むカスタムフォーマット
QString dtString4 = "2023-10-27 14:05:08 JST";
QString format4 = "yyyy-MM-dd hh:mm:ss t"; // "t"でタイムゾーン略称を解析
QDateTime dt4 = QDateTime::fromString(dtString4, format4);
qDebug() << "String:" << dtString4 << "Valid:" << dt4.isValid() << "DateTime:" << dt4.toString("yyyy-MM-dd hh:mm:ss t");
// この形式で解析した場合、Qtはシステムに設定されたタイムゾーン情報を用いて
// JSTがどのタイムゾーン（例: Asia/Tokyo）を指すかを解決しようとします。
// 解決できない場合や曖昧な場合はデフォルトのタイムゾーン（通常LocalTime）になることがあります。
// zz/zzz/Z フォーマットはオフセットを解析できます。

QString dtString5 = "2023-10-27 14:05:08 +0900";
QString format5 = "yyyy-MM-dd hh:mm:ss zzz"; // "zzz"でオフセットを解析
QDateTime dt5 = QDateTime::fromString(dtString5, format5);
qDebug() << "String:" << dtString5 << "Valid:" << dt5.isValid() << "DateTime:" << dt5.toString("yyyy-MM-dd hh:mm:ss zz"); // zzで出力
qDebug() << "TimeSpec:" << dt5.timeSpec(); // Qt::OffsetFromUTC になる

// ロケールを指定した解析
QString localizedDtString = "2023年10月27日(金) 14時05分";
QLocale japaneseJp(QLocale::Japanese, QLocale::Japan);
QDateTime dt6 = QDateTime::fromString(localizedDtString, Qt::SystemLocaleLongDate, japaneseJp); // ロケールを指定して解析
qDebug() << "String:" << localizedDtString << "Valid:" << dt6.isValid() << "DateTime:" << dt6.toString(Qt::ISODate); // ISO形式で出力して確認


// 失敗する例
QString invalidString = "Invalid date";
QDateTime invalidDt = QDateTime::fromString(invalidString, Qt::ISODate);
qDebug() << "String:" << invalidString << "Valid:" << invalidDt.isValid(); // Valid: false

return 0;

}
“`

fromString()でタイムゾーン略称（t）をパースする場合、Qtはシステム上のタイムゾーンデータベースを参照して該当するタイムゾーンを特定しようとします。オフセット（zz, zzz, Z）をパースする場合は、より直接的にUTCからのオフセットが設定されたQDateTime（Qt::OffsetFromUTC）が生成されます。ロケール指定によるパースは、toStringと同様に国際化対応に役立ちます。

3.7 QDateTimeの例題

QDateTimeを使った応用例をいくつか示します。

例1：ファイル更新日時の取得と比較

QFileInfoクラスはファイルに関する情報を提供し、その中にタイムスタンプ（更新日時など）が含まれています。これらのタイムスタンプはQDateTimeオブジェクトとして取得できます。

“`cpp

include

include

include

include

int main() {
// 適当なファイルを作成（存在しない場合はスキップ）
QFile tempFile(“temp_test_file.txt”);
if (tempFile.open(QIODevice::WriteOnly | QIODevice::Text)) {
tempFile.write(“This is a test file.”);
tempFile.close();
qDebug() << “Created temp_test_file.txt”;

    // QFileInfoを使ってファイル情報を取得
    QFileInfo fileInfo("temp_test_file.txt");

    if (fileInfo.exists()) {
        // ファイルのタイムスタンプを取得
        QDateTime lastModified = fileInfo.lastModified();
        QDateTime lastRead = fileInfo.lastRead();
        QDateTime created = fileInfo.created(); // 一部のファイルシステムではサポートされていない

        qDebug() << "\nFile Info for temp_test_file.txt:";
        qDebug() << "Last Modified:" << lastModified.toString(Qt::ISODateWithMs);
        qDebug() << "Last Read:" << lastRead.toString(Qt::ISODateWithMs);
        if (created.isValid()) {
             qDebug() << "Created:" << created.toString(Qt::ISODateWithMs);
        } else {
             qDebug() << "Created timestamp not available or invalid.";
        }


        // 別のQDateTimeとの比較
        QDateTime now = QDateTime::currentDateTime();
        qDebug() << "\nCurrent time:" << now.toString(Qt::ISODateWithMs);

        if (lastModified > now) {
            qDebug() << "Last modified time is in the future (likely clock issue).";
        } else {
             qint64 secsAgo = lastModified.secsTo(now);
             qDebug() << "Last modified was" << secsAgo << "seconds ago.";
        }

        // ファイルを削除
        if (QFile::remove("temp_test_file.txt")) {
            qDebug() << "\nRemoved temp_test_file.txt";
        } else {
            qDebug() << "\nFailed to remove temp_test_file.txt";
        }

    } else {
        qDebug() << "temp_test_file.txt does not exist.";
    }

} else {
     qDebug() << "Failed to create temp_test_file.txt";
}

return 0;

}
“`

ファイルシステムのタイムスタンプは、ファイルシステムの種類やOSによって精度や基準（ローカルタイムかUTCか）が異なる場合があることに注意が必要です。Qtは可能な限り正確な情報を提供しますが、システム依存性があります。

例2：異なるタイムゾーン間での時刻変換と表示

イベントの発生時刻がUTCで記録されており、それをユーザーのローカルタイムや特定のタイムゾーンで表示したい場合によく使われます。

“`cpp

include

include

include

int main() {
// あるイベントが発生したUTC時刻 (例: 2023年11月15日 09:00:00 UTC)
QDateTime eventUtc(QDate(2023, 11, 15), QTime(9, 0, 0), Qt::UTC);
qDebug() << “Event time (UTC):” << eventUtc.toString(Qt::ISODate);

// このイベント時刻をローカルタイムで表示
QDateTime eventLocal = eventUtc.toLocalTime();
qDebug() << "Event time (Local):" << eventLocal.toString(Qt::ISODate);

// このイベント時刻を特定のタイムゾーン（例: ニューヨーク時間 America/New_York）で表示
QTimeZone nyZone("America/New_York");
if (nyZone.isValid()) {
    QDateTime eventNY = eventUtc.toTimeZone(nyZone);
    qDebug() << "Event time (New York):" << eventNY.toString(Qt::ISODateWithMs);

    // 夏時間を考慮した表示名を取得
    qDebug() << "Event time zone name:" << eventNY.timeZone().displayName(eventNY.offsetFromUtc(), QTimeZone::StandardTime); // QTimeZone::StandardTime or DaylightTime

    // ニューヨーク時間の夏時間期間かどうかを判定
    if (nyZone.isDaylightTime(eventNY)) {
         qDebug() << "This New York time is during Daylight Saving Time.";
    } else {
         qDebug() << "This New York time is during Standard Time.";
    }

} else {
    qDebug() << "Could not create New York time zone for conversion.";
}

// ある時間をローカルタイムで指定し、それをUTCや別のタイムゾーンに変換する例
QDateTime localMeeting(QDate(2023, 12, 1), QTime(10, 0, 0), Qt::LocalTime); // ローカルタイムで12月1日 10:00の会議
qDebug() << "\nLocal meeting time:" << localMeeting.toString(Qt::ISODate);

QDateTime meetingUtc = localMeeting.toUTC(); // UTCに変換
qDebug() << "Meeting time (UTC):" << meetingUtc.toString(Qt::ISODate);

QTimeZone londonZone("Europe/London"); // ロンドン時間
if (londonZone.isValid()) {
     QDateTime meetingLondon = meetingUtc.toTimeZone(londonZone); // UTCからロンドン時間に変換
     qDebug() << "Meeting time (London):" << meetingLondon.toString(Qt::ISODate);
}

return 0;

}
“`

イベント発生時刻をUTCで記録し、表示時にユーザーのタイムゾーンに変換するという方法は、国際化対応されたアプリケーションで時刻の整合性を保つための一般的なプラクティスです。

第4章 関連クラスと応用

QtにはQTime, QDateTime以外にも時間処理に関連する便利なクラスや機能があります。

4.1 QDateクラスの補足

QDateクラスは日付情報のみを扱います。QDateTimeの内部でも使用されています。年、月、日といった要素の取得や、日付の比較、演算、文字列変換などが可能です。

主なメソッド：

  • QDate(year, month, day): 指定した日付でオブジェクトを作成。
  • currentDate(): 現在のシステム日付を取得。
  • year(), month(), day(): 年、月、日を取得。
  • dayOfWeek(), dayOfYear(): 曜日（1=月曜, …, 7=日曜）、その年の何日目かを取得。
  • daysInMonth(), daysInYear(): その月の総日数、その年の総日数を取得。
  • isLeapYear(): うるう年かどうかを判定。
  • addDays(), addMonths(), addYears(): 日、月、年を加算/減算。
  • daysTo(): 二つの日付間の日数を計算。
  • toString(), fromString(): 文字列との変換 (QDateTimeやQTimeと共通のフォーマット要素を使用)。

“`cpp

include

include

include

int main() {
QDate today = QDate::currentDate();
qDebug() << “Today:” << today.toString(Qt::ISODate);

QDate tomorrow = today.addDays(1);
qDebug() << "Tomorrow:" << tomorrow.toString(Qt::ISODate);

QDate futureDate(2025, 1, 1);
qDebug() << "Future date:" << futureDate.toString(Qt::ISODate);

qDebug() << "Days from today to future date:" << today.daysTo(futureDate);

qDebug() << "Year of future date:" << futureDate.year();
qDebug() << "Month of future date:" << futureDate.month();
qDebug() << "Day of future date:" << futureDate.day();

qDebug() << "Day of week for future date (1=Mon, ..., 7=Sun):" << futureDate.dayOfWeek(); // 2025/1/1は水曜日 -> 3

QDate leapYear(2024, 2, 1);
qDebug() << "Is 2024 a leap year?" << leapYear.isLeapYear(); // true
qDebug() << "Days in Feb 2024:" << leapYear.daysInMonth(); // 29

QDate nonLeapYear(2023, 2, 1);
qDebug() << "Is 2023 a leap year?" << nonLeapYear.isLeapYear(); // false
qDebug() << "Days in Feb 2023:" << nonLeapYear.daysInMonth(); // 28

// 文字列変換 (日付のみ)
qDebug() << "Today in English format:" << today.toString("MMM d, yyyy", QLocale::English); // 例: Oct 27, 2023

// 文字列からの作成
QString dateString = "2023-12-25";
QDate christmas = QDate::fromString(dateString, Qt::ISODate);
qDebug() << "Christmas valid?" << christmas.isValid() << "Date:" << christmas.toString(Qt::ISODate);

return 0;

}
“`

QDateは、誕生日計算、記念日計算、カレンダー機能など、日付のみを扱う機能で活躍します。

4.2 QTimerとの連携

GUIアプリケーションでは、一定時間後に処理を実行したり、一定間隔で処理を繰り返したりするためにQTimerクラスがよく使用されます。QDateTimeは、QTimerと連携して、特定の時刻に何かを実行するといったスケジューリング機能の実装に役立ちます。

“`cpp

include

include

include

include

// タイムアウト時に呼ばれる関数
void onTimerTimeout() {
QDateTime now = QDateTime::currentDateTime();
qDebug() << “Timer fired at:” << now.toString(Qt::ISODateWithMs);
// アプリケーションを終了させる (シングルトリガーの場合)
// QCoreApplication::quit();
}

int main(int argc, char *argv[]) {
QCoreApplication a(argc, argv);

// 例1: 5秒後に一度だけタイマーを発火させる
qDebug() << "Setting single-shot timer for 5 seconds...";
QTimer::singleShot(5000, &onTimerTimeout); // 5000ミリ秒 = 5秒

// 例2: 現在時刻から計算して、特定の未来時刻に一度だけタイマーを発火させる
QDateTime now = QDateTime::currentDateTime();
QDateTime futureTime = now.addSecs(10); // 現在から10秒後の時刻
qDebug() << "Setting single-shot timer to fire at:" << futureTime.toString(Qt::ISODate);

qint64 msecsToFuture = now.msecsTo(futureTime);
if (msecsToFuture > 0) {
    QTimer::singleShot(msecsToFuture, &onTimerTimeout);
    qDebug() << "Timer set for" << msecsToFuture << "ms from now.";
} else {
    qDebug() << "Future time is in the past or present. Timer not set.";
}


// 例3: 一定間隔で繰り返すタイマー
QTimer* repeatingTimer = new QTimer(&a);
// シグナルとスロットを接続 (Qt 5の新しい記法)
QObject::connect(repeatingTimer, &QTimer::timeout, [](){
    qDebug() << "Repeating timer fired at:" << QDateTime::currentDateTime().toString(Qt::ISODate);
});

repeatingTimer->start(2000); // 2000ミリ秒 (2秒) 間隔で発火
qDebug() << "\nStarting repeating timer (2 sec interval)...";
qDebug() << "Press Ctrl+C to stop.";


// QCoreApplication::exec() がイベントループを開始し、タイマーが動作します。
return a.exec(); // GUIアプリの場合は QApplication::exec()

}
“`

QDateTime::msecsTo()メソッドを使うことで、現在の時刻から特定の未来の時刻までのミリ秒数を計算し、その値をQTimer::singleShot()に渡すことで、「いついつの何時に実行する」という簡易的なスケジュール機能を実装できます。より複雑なスケジュール管理には、専用のライブラリやメカニズムが必要になる場合があります。

4.3 QElapsedTimer (高精度計測) の簡単な紹介

前述の通り、QTime::elapsed()はミリ秒単位の精度を持ちますが、システムのクロック分解能に依存します。より高精度（マイクロ秒、ナノ秒）な時間計測が必要な場合は、QElapsedTimerクラスを使用します。QElapsedTimerはOSが提供する高精度タイマーを利用できる場合にそちらを使用します。

“`cpp

include

include

include // 処理時間シミュレーション用

int main() {
QElapsedTimer timer;
timer.start(); // 計測開始

// 時間がかかる処理のシミュレーション
QThread::msleep(100); // 100ミリ秒待機

qint64 elapsedMs = timer.elapsed();      // 経過ミリ秒
qint64 elapsedNs = timer.nsecsElapsed(); // 経過ナノ秒 (利用可能なら高精度)

qDebug() << "Elapsed time (ms):" << elapsedMs;   // 約100
qDebug() << "Elapsed time (ns):" << elapsedNs; // 約100,000,000 (1ms = 1,000,000ns)

// タイマーをリセットして再開
qint64 elapsedBeforeRestartNs = timer.restart(); // リセット前の経過ナノ秒を取得し、タイマーを再開
qDebug() << "Elapsed time before restart (ns):" << elapsedBeforeRestartNs; // 約100,000,000

QThread::usleep(50); // 50マイクロ秒待機

qint64 elapsedAfterRestartNs = timer.nsecsElapsed(); // restartからの経過ナノ秒
qDebug() << "Elapsed time after restart (ns):" << elapsedAfterRestartNs; // 約50,000

return 0;

}
“`

QElapsedTimerは、プログラム内の特定の処理ブロックの実行時間を正確に計測するのに適しています。QTimeは、より広範な時間（例: その日の何時何分）を扱うのに適しています。

4.4 国際化対応とロケール

QDateTime::toString()やQDate::toString()、QTime::toString()は、QLocaleオブジェクトを引数に取るオーバーロードを持ちます。これにより、日付時刻の表示形式を、アプリケーションが実行されているシステムのロケールや、明示的に指定したロケールに合わせて調整できます。

QLocaleクラスは、言語、国、地域に関連する情報（数値形式、通貨形式、日付時刻形式など）を管理します。

“`cpp

include

include

include

int main() {
QDateTime dt(QDate(2023, 10, 27), QTime(14, 5, 8), QTimeZone(“Asia/Tokyo”));

// デフォルトロケールでの表示
qDebug() << "Default locale:" << dt.toString(Qt::SystemLocaleLongDate);

// 日本語ロケールでの表示
QLocale japanese(QLocale::Japanese);
qDebug() << "Japanese locale:" << dt.toString(Qt::SystemLocaleLongDate, japanese);

// 英語 (米国) ロケールでの表示
QLocale englishUS(QLocale::English, QLocale::UnitedStates);
qDebug() << "English (US) locale:" << dt.toString(Qt::SystemLocaleLongDate, englishUS);

// ドイツ語ロケールでの表示
QLocale german(QLocale::German);
qDebug() << "German locale:" << dt.toString(Qt::SystemLocaleLongDate, german);

// ロケールを意識したテキストフォーマット
qDebug() << "\nTextDate (locale aware):";
qDebug() << "Default locale:" << dt.toString(Qt::TextDate);
qDebug() << "Japanese locale:" << dt.toString(Qt::TextDate, japanese);
qDebug() << "English (US) locale:" << dt.toString(Qt::TextDate, englishUS);

// ロケールを指定した文字列からの解析
QString germanDateString = "27. Oktober 2023 um 14:05:08"; // 例: ドイツ語の長い形式に近い文字列
QString germanFormat = "dd. MMMM yyyy um HH:mm:ss"; // このフォーマットで解析
QDateTime dtFromGermanString = QDateTime::fromString(germanDateString, germanFormat, german); // ドイツ語ロケールでパースを試みる
qDebug() << "\nParsing German string:" << germanDateString;
qDebug() << "Valid:" << dtFromGermanString.isValid() << "Result:" << dtFromGermanString.toString(Qt::ISODate);

return 0;

}
“`

QLocaleを使った文字列変換は、日付や月の名称、曜日の名称などがロケールに合わせて適切に表示されるため、多言語対応アプリケーションには必須の機能です。fromString()においてもロケールを指定することで、ロケール固有の区切り文字や表記規則に対応した文字列の解析が可能になります。

第5章 注意点とトラブルシューティング

Qtの時間処理クラスは便利ですが、使用上の注意点や考慮すべき点がいくつかあります。

  • システム時刻の変更: QTime::currentTime()やQDateTime::currentDateTime()はシステム時刻に依存します。ユーザーやシステム管理者によってシステム時刻が変更されると、これらのメソッドが返す値もそれに追従します。時間計測中に時刻が戻されたり進められたりすると、QTime::elapsed()やQElapsedTimer::elapsed()の返す値も影響を受け、期待通りにならない可能性があります。重要な計測には、より安定した時間源（例: システム起動からの経過時間）を使用することを検討するか、時刻変更を検知して対応する仕組みが必要です。
  • サマータイムの切り替わり: QDateTimeがタイムゾーン情報（特にQTimeZone）を持つ場合、サマータイム（夏時間）の開始・終了が自動的に考慮されます。サマータイムが開始される日には時刻が1時間進み、終了する日には1時間戻ります。この切り替わり時に、時刻がスキップされたり（存在しない時間）、重複したり（同じ時間が2度出現）することがあります。QTimeZoneクラスは、特定の時間におけるオフセット情報（offsetFromUtc()）や、その時間が夏時間期間内かどうかの判定（isDaylightTime()）を提供しており、これらの情報を使って適切な処理を実装できます。
  • ファイルシステムのタイムスタンプ: ファイルシステムのタイムスタンプ（作成日時、更新日時など）は、ファイルシステムの種類（FAT, NTFS, ext4など）やOSによって精度や基準（ローカルタイムかUTCか）が異なります。QFileInfoが返すQDateTimeオブジェクトはこれらの違いを吸収しようとしますが、完全に移植性があるとは限りません。
  • 高精度計測の限界: QTime::elapsed()はミリ秒精度ですが、実際の精度はシステムクロックに依存します。より正確な計測が必要な場合は、QElapsedTimerを使用してください。ただし、QElapsedTimerの最高精度（ナノ秒）もハードウェアやOSの制限を受けます。リアルタイム性が非常に求められるような用途では、Qtの提供するタイマーでは不十分な場合があり、OS固有のAPIやハードウェアタイマーの使用が必要になることがあります。
  • マルチスレッド環境: 複数のスレッドから同時に時間取得や計算を行う場合、スレッドセーフ性は通常問題ありません。QTime, QDate, QDateTimeオブジェクトは値型（コピー可能で、コピーは独立したオブジェクトになる）であり、通常はスレッド間で共有して状態を変更することはありません。ただし、QTimerのようなQObjectを継承するクラスは、通常、それが作成されたスレッド（またはQCoreApplication::exec()が実行されているスレッド）のイベントループで動作させる必要があります。別のスレッドからQTimerのメソッド（例: start(), stop())を直接呼び出すのは避けるべきで、キューイングされたシグナル/スロット接続を利用するなどの注意が必要です。

第6章 まとめ

この記事では、Qtフレームワークにおける時間処理の中核をなすQTimeとQDateTimeクラスについて、その基本的な使い方から比較、演算、文字列変換、そして重要な概念であるタイムゾーンの扱いに至るまでを詳細に解説しました。補足としてQDateやQTimeZone、QElapsedTimerといった関連クラスにも触れ、Qtにおける時間処理の全体像を掴めるように努めました。

  • QTime: 時刻のみを扱い、一日の経過時間や短い処理時間の計測に適しています。ラップアラウンドに注意が必要です。
  • QDateTime: 日付と時刻、そしてタイムゾーン情報をまとめて扱います。国際的なアプリケーションや、ログ記録、ファイルシステム連携など、日付を考慮した時間処理に必須です。QTimeZoneクラスと連携することで、正確なタイムゾーン変換やサマータイムの扱いが可能になります。
  • QDate: 日付のみを扱います。誕生日計算やカレンダー機能など、日付単位の処理に適しています。
  • QElapsedTimer: 高精度な時間計測に特化したクラスです。
  • QTimer: イベントループを利用した時間ベースのイベント発火に使用します。QDateTimeと組み合わせて特定の時刻に処理を実行する用途にも使えます。

これらのクラスを適切に使い分けることで、Qtアプリケーションにおける様々な時間処理要件を満たすことができます。特に、現代のアプリケーションではタイムゾーンの考慮が不可欠となる場面が多く、QDateTimeとQTimeZoneの組み合わせがその中心的な役割を果たします。

文字列との相互変換機能も強力であり、様々なフォーマットやロケールに対応しています。これにより、ユーザーインターフェースでの表示や、設定ファイル、ネットワーク通信での日付時刻のやり取りが容易になります。

時間処理は一見シンプルに見えますが、タイムゾーン、サマータイム、うるう年、システム時刻の変更といった要因が絡むと複雑になります。Qtが提供するクラスはこれらの複雑さをある程度吸収してくれますが、基本的な概念と各クラスの特性を理解しておくことが、予期せぬ問題を防ぎ、堅牢なアプリケーションを開発するために重要です。

この記事が、あなたのQt開発における時間処理の実装の一助となれば幸いです。Qtの公式ドキュメントも非常に充実しているので、特定のメソッドの詳細や最新情報については、そちらも合わせて参照されることをお勧めします。

Happy Coding!

コメントする

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

上部へスクロール