Qtの基礎 - 日時のソースを表示

== 概要 ==
Qtにおいて、<code>QDate</code>クラスまたは<code>QTime</code>クラスを使用して、日付および時刻の有効性を確認する。<br>
<br><br>

== 日本時間の取得 ==
PCのシステム環境のロケールやタイムゾーン設定に基づいて日付を取得しているため、システムが日本時間に設定されている場合は、<br>
<code>QDate::currentDate</code>メソッドにより取得される日付は現地の日付となる。<br>
<br>
タイムゾーンを考慮した日時の操作が必要な場合は、<code>QDateTime</code>クラスおよび<code>QTimeZone</code>クラスを使用することにより、より詳細な制御が可能となる。<br>
<br>
また、日付のみが必要な場合でも、タイムゾーンを考慮するには<code>QDateTime</code>クラスが適している。<br>
 <syntaxhighlight lang="c++">
 #include <QDateTime>
 #include <QTimeZone>
 
 // 日本のタイムゾーンを設定
 QDateTime now = QDateTime::currentDateTime();
 now.setTimeZone(QTimeZone("Asia/Tokyo"));
 
 // 日本時間での日付と時刻を表示
 std::cout << QString("日本時間での現在の日付と時刻 : %1").arg(now.toString()) << std::endl;
 
 // 現在の年、月、日を取得
 QDate currentDate = now.date();
 int year = currentDate.year();
 int month = currentDate.month();
 int day = currentDate.day();
 
 std::cout << QString("年 : %1, 月 : %2, 日 : %3").arg(year, month, day).toStdString() << std::endl;
 </syntaxhighlight>
<br><br>

== エポックタイムの取得 ==
エポックタイム (UNIXタイムやPOSIXタイムとも呼ばれる) を取得する場合、<code>QDateTime</code>クラスを使用する。<br>
エポックタイムは、1970年1月1日00:00:00 UTCからの経過秒数を示しており、多くのプログラミング環境で日付と時刻を扱う際の基準である。<br>
 <syntaxhighlight lang="c++">
 #include <QDateTime>
 
 // 現在の日時を取得
 QDateTime now = QDateTime::currentDateTime();
 
 // エポックタイム (UNIXタイム) を秒単位で取得
 // toSecsSinceEpochメソッドは、Qt 5.8以降で使用可能
 // Qt 5.8以前を使用している場合は、toTime_tメソッドを使用することもできるが、2038年問題に対応していないため注意する必要がある
 qint64 epochTime = now.toSecsSinceEpoch();
 </syntaxhighlight>
<br><br>

== ISO 8601 ==
ISO 8601では、日付と時刻は"YYYY-MM-DDTHH:MM:SS"で表現される。<br>
例えば、2024年3月15日 0時14分44秒の場合は、"2024-03-15T00:14:44"のように表す。 ("T"は、日付と時刻の区切りを示す)<br>
<br>
ISO 8601は国際標準化機構(ISO)により定められた日付と時刻の表記に関する国際規格であり、主にデータ交換の文脈で利用される。<br>
<br>
以下の例では、"2024-03-01T16:24:32Z"というUTCの日時 (文字列) を日本時間に変換して、"yyyy年M月d日 H時m分"という形式に変換している。<br>
 <syntaxhighlight lang="c++">
 #include <QDateTime>
 #include <QTimeZone>
 
 // UTCの日時を表す文字列
 QString utcDateTimeStr = "2024-03-01T16:24:32Z";
 
 // UTCの日時をQDateTimeに変換
 // Qt::ISODateにZを含むことでUTCとして解釈される
 QDateTime utcDateTime = QDateTime::fromString(utcDateTimeStr, Qt::ISODate);
 
 // UTC時間を明示的に設定
 utcDateTime.setTimeSpec(Qt::UTC);
 
 // 日本のタイムゾーンオブジェクト
 QTimeZone jpTimeZone("Asia/Tokyo");
 
 // UTCから日本時間へ変換
 QDateTime jpDateTime = utcDateTime.toTimeZone(jpTimeZone);
 
 // 日本時間に変換された日時を指定のフォーマットで出力
 QString formattedDateTime = jpDateTime.toString("yyyy年M月d日 H時m分");
 
 std::cout << formattedDateTime.toStdString() << std::endl;
 }
 </syntaxhighlight>
<br><br>

== その他の時刻形式 ==
==== yyyy/MM/dd HH:mm:ss形式 ====
この形式は特定の国や地域でよく使用されるが、厳密に定義された国際規格が存在するわけではない。<br>
しかし、他のソフトウェアやデータベースシステムで日付と時刻を表現するために使用されることがある。<br>
<br>
以下の例では、yyyy/MM/dd HH:mm:ss形式からHH:mm:ssの部分 (時刻) のみを取得している。<br>
 <syntaxhighlight lang="c++">
 #include <QDateTime>
 #include <QTime>
 
 QString originalDateTimeString = "2024/03/15 00:14:44";
 QDateTime dateTime             = QDateTime::fromString(originalDateTimeString, "yyyy/MM/dd HH:mm:ss");
 
 if (dateTime.isValid()) {
    QString timeString = dateTime.time().toString("HH:mm:ss");
    std::cout << QString("Converted Time : %1").arg(timeString).toStdString() << std::endl;
 }
 else {
    std::cout << QString("Error: Invalid date/time format.").toStdString() << std::endl;
 }
 </syntaxhighlight>
<br><br>

== 日付および時刻の有効性の確認 ==
以下の例では、閏年の判定等も含めて、入力された日付および時刻の有効性を確認している。<br>
<br>
* 日付
*: <code>QDate</code>クラスのコンストラクタに年月日を代入して、<code>isValid</code>メソッドで判定する。
* 時刻
*: <code>QTime</code>クラスのコンストラクタに時分秒を代入して、<code>isValid</code>メソッドで判定する。
<br>
 <syntaxhighlight lang="c++">
 // 日付
 
 #include <QDate>
 
 qDebug() << QDate(2019, 2, 28).isValid();  // true
 
 qDebug() << QDate(2019, 2, 29).isValid();  // false(閏年ではないため)
 
 qDebug() << QDate(2020, 2, 28).isValid();  // true
 
 qDebug() << QDate(2020, 2, 29).isValid();  // true(閏年のため)
 </syntaxhighlight>
<br>
 <syntaxhighlight lang="c++">
 // 時刻
 
 #include <QTime>
 
 qDebug() << QTime(23, 59, 59).isValid();  // true
 
 qDebug() << QTime(0, 0, 0).isValid();     // true
 
 qDebug() << QTime(25, 0, 0).isValid();    // false
 
 qDebug() << QTime(0, 60, 0).isValid();    // false
 
 qDebug() << QTime(0, 0, 60).isValid();    // false
 </syntaxhighlight>
<br>
また、<code>QDateTime</code>クラスという<code>QDate</code>クラスと<code>QTime</code>クラスの両方を取得するクラスもあるが、<br>
<u>"日付が正常かつ時刻が異常の場合、時刻を00:00:00にする仕様"</u>のため、(その結果、<code>QDateTime::isValid</code>メソッドはtrueを返す)<br>
時刻の有効性が確認できない。<br>
<br><br>


__FORCETOC__
[[カテゴリ:Qt]]