QDateTime Class

メンバー関数のドキュメント

QDateTime::QDateTime(QDate date, QTime time, const QTimeZone &timeZone, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

指定された `date ` および `time` を使用し、timeZone で定義されている時刻の表現形式に基づいて、datetime オブジェクトを生成します。

date が有効で、time が無効な場合、時刻は午前0時に設定されます。timeZone が無効な場合、datetimeは無効となります。date およびtime が、timeZone における遷移に近い時点を表している場合、resolve はその状況の解決方法を制御します。

[noexcept] QDateTime::QDateTime()

ローカル時間を基準として、NULLのdatetimeオブジェクトを生成します。

nullの日時データは、日付と時刻が無効であるため、無効です。

isValid()、setMSecsSinceEpoch()、setDate()、setTime()、およびsetTimeZone()も参照してください 。

[since 6.5] QDateTime::QDateTime(QDate date, QTime time, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

指定されたdate およびtime を用いて、現地時間に基づいてdatetimeオブジェクトを生成します。

date が有効で、time が無効な場合、時刻として午前0時が使用されます。date とtime が現地時間の切り替え時刻に近い時点を表している場合、resolve によってその状況の処理方法が制御されます。

この関数は Qt 6.5 で導入されました。

[noexcept] QDateTime::QDateTime(const QDateTime &other)

other の日時データのコピーを作成します。

[noexcept] QDateTime::QDateTime(QDateTime &&other)

一時的なother の日時オブジェクトの内容をこのオブジェクトに移し、other を未指定（ただし適切な）な状態のままにします。

[noexcept] QDateTime::~QDateTime()

datetime を破棄します。

QDateTime QDateTime::addDays(qint64 ndays) const

このオブジェクトの日時よりndays 日後の日時（ndays が負の値の場合はそれより前の日時）を含むQDateTime オブジェクトを返します。

timeSpec() がQt::LocalTime またはQt::TimeZone であり、その結果の日時が標準時から夏時間への移行時間帯に該当する場合、結果は変更の方向に向かって、この境界をわずかに超えた時点になります。 移行が午前 2 時で、時計が午前 3 時に進められる場合、午前 2 時から午前 3 時の間をターゲットとした結果は、午前 2 時より前（ndays < 0 の場合）または午前 3 時より後（それ以外の場合）になるように調整されます。

daysTo()、addMonths()、addYears()、addSecs()、およびTimezone transitionsも参照してください 。

[since 6.4] QDateTime QDateTime::addDuration(std::chrono::milliseconds msecs) const

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

この日時が無効な場合、無効な日時が返されます。

この関数は Qt 6.4 で導入されました。

addMSecs()、msecsTo()、addDays()、addMonths()、およびaddYears()も参照してください 。

QDateTime QDateTime::addMSecs(qint64 msecs) const

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

この日時が無効な場合、無効な日時が返されます。

addSecs()、msecsTo()、addDays()、addMonths()、およびaddYears()も参照してください 。

QDateTime QDateTime::addMonths(int nmonths) const

このオブジェクトの日時よりnmonths ヶ月後の日時（nmonths が負の場合はそれより前の日時）を含むQDateTime オブジェクトを返します。

timeSpec() がQt::LocalTime またはQt::TimeZone であり、その結果得られる日時が標準時と夏時間の切り替え時刻に含まれる場合、結果は切り替えの境界をわずかに越えた、変更の方向となる。 移行が午前 2 時に行われ、時計が午前 3 時に進められる場合、午前 2 時から午前 3 時の間を指定した結果は、午前 2 時より前（nmonths < 0 の場合）または午前 3 時より後（それ以外の場合）になるように調整されます。

daysTo()、addDays()、addYears()、addSecs()、およびTimezone transitionsも参照してください 。

QDateTime QDateTime::addSecs(qint64 s) const

このオブジェクトの日時よりs 秒後の日時（s が負の値の場合はそれより前の日時）を含むQDateTime オブジェクトを返します。

この日時が無効な場合、無効な日時が返されます。

addMSecs()、secsTo()、addDays()、addMonths()、およびaddYears()も参照してください 。

QDateTime QDateTime::addYears(int nyears) const

このオブジェクトの日時よりnyears 年後の日時（nyears が負の値の場合はそれより前の日時）を含むQDateTime オブジェクトを返します。

timeSpec() がQt::LocalTime またはQt::TimeZone であり、結果の日時が標準時から夏時間への移行時間帯に含まれる場合、結果は、変更の方向に向かって、この境界をわずかに超えた時点になります。 移行が午前 2 時で、時計が午前 3 時に進められる場合、午前 2 時から午前 3 時の間を指定した結果は、午前 2 時より前（nyears < 0 の場合）または午前 3 時より後（それ以外の場合）になるように調整されます。

daysTo()、addDays()、addMonths()、addSecs()、およびTimezone transitionsも参照してください 。

[static, since 6.5] QDateTime QDateTime::currentDateTime(const QTimeZone &zone)

zone で規定されている時刻表記形式を用いて、システムクロックの現在の日時を返します。zone が省略された場合は、現地時間が使用されます。

この関数は Qt 6.5 で導入されました。

currentDateTimeUtc()、QDate::currentDate()、QTime::currentTime()、およびtoTimeZone()も参照してください 。

[static] QDateTime QDateTime::currentDateTime()

[static] QDateTime QDateTime::currentDateTimeUtc()

システムクロックの現在の日時を、UTC 形式で返します。

currentDateTime(QTimeZone::UTC) と同等です。

currentDateTime()、QDate::currentDate()、QTime::currentTime()、およびtoTimeZone()も参照してください 。

[static noexcept] qint64 QDateTime::currentMSecsSinceEpoch()

1970年の開始時点（UTC）からの現在の経過時間（ミリ秒単位）を返します。

この数値は POSIX の `time_t` 変数と同様ですが、秒単位ではなくミリ秒単位で表されます。

currentDateTime()、currentDateTimeUtc()、およびtoTimeZone()も参照してください 。

[static noexcept] qint64 QDateTime::currentSecsSinceEpoch()

1970年の開始時点（UTC）からの経過秒数を返します。

この数値は、POSIXの`time_t`変数と同様です。

currentMSecsSinceEpoch()も参照してください 。

QDate QDateTime::date() const

datetime の日付部分を返します。

setDate()、time()、およびtimeRepresentation()も参照してください 。

qint64 QDateTime::daysTo(const QDateTime &other) const

この日時から「other 」の日時までの日数を返します。

日数は、この日時とother の日時の間に、深夜0時を迎える回数を数えて算出されます。つまり、23:55から翌日の0:05までの10分の差は、1日としてカウントされます。

other の日時がこの日時よりも前の場合、返される値は負の数になります。いずれかの日時が無効な場合、値は 0 になります。

例：

QDateTime startDate(QDate(2012, 7, 6),QTime(8, 30, 0));
QDateTime endDate(QDate(2012, 7, 7),QTime(16, 30, 0));
qDebug() << "Days from startDate to endDate: " << startDate.daysTo(endDate);

startDate=QDateTime(QDate(2012, 7, 6),QTime(23, 55, 0));
endDate=QDateTime(QDate(2012, 7, 7),QTime(0, 5, 0));
qDebug() << "Days from startDate to endDate: " << startDate.daysTo(endDate);

qSwap(startDate, endDate); // Make endDate before startDate.
qDebug() << "Days from startDate to endDate: " << startDate.daysTo(endDate);

addDays()、secsTo()、およびmsecsTo()も参照してください 。

[static] QDateTime QDateTime::fromCFDate(CFDateRef date)

CFDatedate のコピーを含む新しいQDateTime を作成します。

toCFDate()も参照してください 。

[static] QDateTime QDateTime::fromMSecsSinceEpoch(qint64 msecs, const QTimeZone &timeZone)

1970年の開始時刻（UTC）から、指定されたミリ秒数msecs を経た時点を表すdatetimeを返します。この時刻の記述方法はtimeZone で規定されています。デフォルトの時刻表現は現地時間です。

msecs の値には、QDateTime で定義された有効範囲外のもの（負の値および正の値）が含まれる可能性があることに注意してください。これらの値に対して、この関数の挙動は未定義となります。

fromSecsSinceEpoch()、toMSecsSinceEpoch()、およびsetMSecsSinceEpoch()も参照してください 。

[static] QDateTime QDateTime::fromMSecsSinceEpoch(qint64 msecs)

[static] QDateTime QDateTime::fromNSDate(const NSDate *date)

NSDatedate のコピーを含む新しいQDateTime を生成します。

toNSDate()も参照してください 。

[static] QDateTime QDateTime::fromSecsSinceEpoch(qint64 secs, const QTimeZone &timeZone)

1970年の開始時刻（UTC）から、指定された秒数secs が経過した時点を表すdatetimeを返します。この時刻の記述形式はtimeZone で指定された通りです。デフォルトの時刻表現は現地時間です。

secs の値には、QDateTime で定義された有効範囲外のもの（負の値および正の値）が含まれる可能性があることに注意してください。これらの値に対して、この関数の挙動は未定義となります。

fromMSecsSinceEpoch()、toSecsSinceEpoch()、およびsetSecsSinceEpoch()も参照してください 。

[static] QDateTime QDateTime::fromSecsSinceEpoch(qint64 secs)

[static, since 6.4] QDateTime QDateTime::fromStdLocalTime(const std::chrono::local_time<std::chrono::milliseconds> &time)

1970-01-01T00:00:00.000（現地時間）（Qt::LocalTime ）から数えて、time で表されるミリ秒数に相当する日付と時刻を持つ datetime オブジェクトを生成します。

この関数は Qt 6.4 で導入されました。

toStdSysMilliseconds() およびfromMSecsSinceEpoch()も参照してください 。

[static, since 6.4] template <typename Clock, typename Duration> QDateTime QDateTime::fromStdTimePoint(const std::chrono::time_point<Clock, Duration> &time) requires requires(const std::chrono::time_point<Clock, Duration> &t) { // the clock can be converted to system_clock std::chrono::clock_cast<std::chrono::system_clock>(t); // after the conversion to system_clock, the duration type // we get is convertible to milliseconds requires std::is_convertible_v< system_clock_cast_duration<Clock, Duration>, std::chrono::milliseconds >; }

Qt::UTC を時刻表現として使用し、time と同じ時点を表す datetime オブジェクトを生成します。

time のクロックは、std::chrono::system_clock と互換性がある必要があります。特に、std::chrono::clock_cast でサポートされている変換が存在する必要があります。変換後、結果の期間型はstd::chrono::milliseconds に変換可能でなければなりません。

そうでない場合、呼び出し元は、この関数への入力が上記の制約を満たすように、std::chrono::system_clock への必要なクロック変換および所要時間型の必要な変換（キャスト／丸め／切り捨て／切り上げ／…）を実行しなければならない。

この関数は Qt 6.4 で導入されました。

関連項目： toStdSysMilliseconds() およびfromMSecsSinceEpoch()。

[static, since 6.4] QDateTime QDateTime::fromStdTimePoint(const std::chrono::local_time<std::chrono::milliseconds> &time)

1970-01-01T00:00:00.000（ローカル時間：Qt::LocalTime ）から数えて、time で表されるミリ秒数に相当する日付と時刻を持つ datetime オブジェクトを生成します。

この関数は Qt 6.4 で導入されました。

toStdSysMilliseconds() およびfromMSecsSinceEpoch()も参照してください 。

[static, since 6.4] QDateTime QDateTime::fromStdTimePoint(std::chrono::time_point<std::chrono::system_clock, std::chrono::milliseconds> time)

`Qt::UTC ` を時刻表現として使用し、time と同じ時点を表す datetime オブジェクトを生成します。

この関数は Qt 6.4 で導入されました。

[static, since 6.4] QDateTime QDateTime::fromStdZonedTime(const std::chrono::zoned_time<std::chrono::milliseconds, const std::chrono::time_zone *> &time)

time と同じ時点を表すdatetimeを生成します。結果は、time のタイムゾーンで表されます。

この関数は Qt 6.4 で導入されました。

関連項目： QTimeZone 、toStdSysMilliseconds()、fromMSecsSinceEpoch()。

[static] QDateTime QDateTime::fromString(const QString &string, const QString &format, int baseYear, QCalendar cal)

string で表される「QDateTime 」を、指定されたformat を使用して返します。文字列を解析できない場合は、無効な日時を返します。

calendarcal が指定されている場合はそれを使用し、指定されていない場合はグレゴリオ暦を使用します。

format で年の下2桁のみが指定されている場合、baseYear から始まる100年間が最初に候補として検討されます。 バージョン 6.7 以前にはbaseYear パラメータが存在せず、常に 1900 が使用されていました。これはbaseYear のデフォルト設定であり、その年から 1999 年までの範囲から年が選択されます。場合によっては、指定されたすべてのフィールドと整合性のある結果を得るために、他のフィールドによって次の世紀または前の世紀が選択されることがあります。詳細については、QDate::fromString() を参照してください。

QDate::fromString() およびQTime::fromString() によって、日付と時刻の一部を表す形式文字列内で認識される式に加え、このメソッドは以下をサポートしています：

't' 形式指定子が指定されていない場合は、システムのローカルタイムゾーンが使用されます。その他のすべてのフィールドのデフォルト値については、QDate::fromString() およびQTime::fromString() を参照してください。

例：

QDateTime dateTime = QDateTime::fromString("1.30.1", "M.d.s");
// dateTime is January 30 in 1900 at 00:00:01.
dateTime = QDateTime::fromString("12", "yy");
// dateTime is January 1 in 1912 at 00:00:00.

一重引用符で囲まれた、空でない任意の文字列も（引用符を除いて）テキストとして扱われ、式としては解釈されません。 連続する2つの単一引用符（"''"）は、リテラルシーケンスの開始や終了を表すのではなく、入力と照合される単一引用符として読み取られます。その他のすべての入力文字は、入力文字列内で照合されるリテラルテキストとして扱われます。例：

QTime time1 = QTime::fromString("131", "HHh");
// time1 is 13:00:00
QTime time2 = QTime::fromString("1apA", "1amAM");
// time2 is 01:00:00

QDateTime dateTime2 = QDateTime::fromString("M1d1y9800:01:02",
                                            "'M'M'd'd'y'yyhh:mm:ss");
// dateTime is 1 January 1998 00:01:02

フォーマットが満たされていない場合、無効なQDateTime が返されます。

数値フィールドが隣接しており、数字の列を区切る区切り文字がない場合、1桁での指定が許可されている一部のフィールドにおいて、値が9を超えるために2桁を使用しているかどうかについて曖昧さが生じる可能性があります。 そのようなフィールドに2桁を割り当てると他のフィールドに割り当てる桁数が不足し、かつ1桁での読み取りが他のフィールドと整合する場合、この曖昧さは解消できます。 それ以外の場合（1桁のみが許容されるフィールドが複数あり、各フィールドに1桁ずつ割り当てた場合に余剰桁が生じる場合）、データの一貫性が保たれる限り、後続のフィールドに余剰桁を割り当てる解決策よりも、先行するフィールドに余剰桁を割り当てる解決策が優先されます。例えば：

先頭にゼロのない式（d、M、h、m、s、z）は「貪欲」に処理されます。つまり、範囲外になったり、他のセクションに割り当てる桁数が不足したりする場合でも、2桁（zの場合は3桁）を使用します。

QDateTime dateTime = QDateTime::fromString("130", "Mm"); // January, 30 mins

これにより、1月1日 00:30.00 となる可能性があったが、Mが2桁を占有してしまう。

string のフィールドが誤って指定されると、無効なQDateTime が返されます。サポートされるのは、ローカル時間の西暦100年の初めから9999年の終わりまでの日付・時刻のみです。 この範囲の端に近い日時が、他のタイムゾーン（特にUTCを含む）では、ローカルのタイムゾーンによっては範囲外となり（したがって無効として扱われる）、注意が必要である。

toString()、QDate::fromString()、QTime::fromString()、およびQLocale::toDateTime()も参照してください 。

[static, since 6.0] QDateTime QDateTime::fromString(QStringView string, Qt::DateFormat format = Qt::TextDate)

この関数は Qt 6.0 で導入されました。

[static] QDateTime QDateTime::fromString(const QString &string, Qt::DateFormat format = Qt::TextDate)

string で表されるQDateTime を、指定されたformat を使用して返します。これが不可能な場合は、無効な日付時刻を返します。

Qt::TextDate に関する注意：英語の短縮形月名（例：短縮形の「Jan」または完全形の「January」）のみが認識されます。

toString() およびQLocale::toDateTime()も参照してください 。

[static, since 6.0] QDateTime QDateTime::fromString(QStringView string, QStringView format, QCalendar cal)

この関数は Qt 6.0 で導入されました。

[static, since 6.7] QDateTime QDateTime::fromString(QStringView string, QStringView format, int baseYear = QLocale::DefaultTwoDigitBaseYear)

デフォルトコンストラクタで生成されたQCalendar を使用します。

この関数は Qt 6.7 で導入されました。

[static, since 6.0] QDateTime QDateTime::fromString(const QString &string, QStringView format, QCalendar cal)

この関数は Qt 6.0 で導入されました。

[static, since 6.7] QDateTime QDateTime::fromString(const QString &string, QStringView format, int baseYear = QLocale::DefaultTwoDigitBaseYear)

デフォルトコンストラクタで生成された `QCalendar` を使用します。

この関数は Qt 6.7 で導入されました。

[static] QDateTime QDateTime::fromString(const QString &string, const QString &format, QCalendar cal)

[static, since 6.7] QDateTime QDateTime::fromString(const QString &string, const QString &format, int baseYear = QLocale::DefaultTwoDigitBaseYear)

デフォルトコンストラクタで生成されたQCalendar を使用します。

この関数は Qt 6.7 で導入されました。

[static, since 6.7] QDateTime QDateTime::fromString(QStringView string, QStringView format, int baseYear, QCalendar cal)

この関数は Qt 6.7 で導入されました。

[static, since 6.0] QDateTime QDateTime::fromString(const QString &string, QStringView format, int baseYear, QCalendar cal)

この関数は Qt 6.0 で導入されました。

bool QDateTime::isDaylightTime() const

この日時が夏時間の期間に含まれる場合に返します。

Qt::TimeSpec がQt::LocalTime またはQt::TimeZone でない場合、常にfalseを返します。

timeSpec()も参照してください 。

bool QDateTime::isNull() const

日付と時刻の両方がnullの場合、true を返します。それ以外の場合はfalse を返します。nullのdatetimeは無効です。

QDate::isNull()、QTime::isNull()、およびisValid()も参照してください 。

bool QDateTime::isValid() const

このdatetimeが特定の時点を表す場合はtrue を返し、そうでない場合はfalse を返します。

datetime が有効であるためには、その日付と時刻の両方が有効であり、かつ使用されている時刻の表現形式がその組み合わせに対して有効な意味を持つ必要があります。 時刻の表現が特定のタイムゾーンまたは現地時間である場合、夏時間の切り替えで 1 時間がスキップされる場合（通常は春の夜）など、そのタイムゾーンの表現においてスキップされる時間帯が特定の日付にあることがあります。 たとえば、夏時間が午前 2 時に終了し、時計が午前 3 時に進む場合、その日の 02:00:00 から 02:59:59.999 までの日時は無効となります。

QDateTime::YearRange 、QDate::isValid()、およびQTime::isValid()も参照してください 。

qint64 QDateTime::msecsTo(const QDateTime &other) const

この日時から「other 」の日時までのミリ秒数を返します。

比較を実行する前に、2つの日時がQt::UTC に変換されます。これは、2つの日時のうち一方に夏時間（DST）が適用され、もう一方には適用されない場合でも、結果が正しいことを保証するためです。

other の日時が、この日時よりも前の場合、返される値は負の数になります。いずれかの日時が無効な場合は 0 を返します。

関連項目: addMSecs()、daysTo()、QTime::msecsTo()。

int QDateTime::offsetFromUtc() const

この日時からUTCまでのオフセットを秒単位で返します。

結果は `timeSpec()` の値によって異なります：

• Qt::UTC オフセットは 0 です。
• Qt::OffsetFromUTC オフセットは、当初設定された値となります。
• Qt::LocalTime UTC からの現地時間のオフセットが返されます。
• Qt::TimeZone タイムゾーンで使用されるオフセットが返されます。

最後の 2 つについては、夏時間オフセットを考慮した上で、この日付と時刻におけるオフセットが返されます。 オフセットは、現地時間または指定されたタイムゾーンの時間と UTC 時間の差です。UTC より進んでいるタイムゾーン（本初子午線の東）では正の値となり、UTC より遅れているタイムゾーン（本初子午線の西）では負の値となります。

setTimeZone()も参照してください 。

qint64 QDateTime::secsTo(const QDateTime &other) const

この日時から「other 」の日時までの秒数を返します。

比較を行う前に、2つのdatetimeはQt::UTC に変換されます。これは、2つのdatetimeのうち一方に夏時間（DST）が適用され、もう一方には適用されない場合でも、結果が正確になるようにするためです。

other の日時が、この日時よりも前の場合、返される値は負の数になります。いずれかの日時が無効な場合は、0 を返します。

例：

QDateTime now=QDateTime::currentDateTime();
QDateTime xmas(QDate(now.date().year(), 12, 25).startOfDay());
qDebug("There are %d seconds to Christmas", now.secsTo(xmas));

addSecs()、daysTo()、およびQTime::secsTo()も参照してください 。

void QDateTime::setDate(QDate date, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

この日時オブジェクトの日付部分をdate に設定します。

まだ時刻が設定されていない場合は、午前0時に設定されます。date が無効な場合、このQDateTime も無効になります。

date およびtime() が、この日時オブジェクトの時間表現における遷移に近い瞬間を表している場合、resolve によってその状況の解決方法が制御されます。

関連項目： date()、setTime()、およびsetTimeZone()。

void QDateTime::setMSecsSinceEpoch(qint64 msecs)

1970年のUTC開始時刻から、指定されたミリ秒数（msecs ）を経た時点を表す日時を設定します。

タイムゾーンをサポートしていないシステムでは、この関数は、現地時間がQt::UTC であるかのように動作します。

なお、msecs にqint64 (std::numeric_limits<qint64>::min()) の最小値を引き渡すと、未定義の挙動となることに注意してください。

setSecsSinceEpoch()、toMSecsSinceEpoch()、およびfromMSecsSinceEpoch()も参照してください 。

void QDateTime::setSecsSinceEpoch(qint64 secs)

1970年のUTC開始時刻から、指定された秒数（secs ）が経過した時点を表す日時を設定します。

タイムゾーンをサポートしていないシステムでは、この関数は、現地時間がQt::UTC であるかのように動作します。

setMSecsSinceEpoch()、toSecsSinceEpoch()、およびfromSecsSinceEpoch()も参照してください 。

void QDateTime::setTime(QTime time, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

このdatetimeの時刻部分をtime に設定します。time が有効でない場合、この関数はそれを深夜0時に設定します。したがって、QDateTime に設定された時刻を、デフォルトのQTime に設定することで、その時刻をクリアすることが可能です：

QDateTime dt = QDateTime::currentDateTime();
dt.setTime(QTime());

date() とtime が、この日時（datetime）の時間表現における遷移に近い瞬間を表している場合、resolve はその状況をどのように解決するかを制御します。

関連項目： time()、setDate()、setTimeZone()も参照してください 。

void QDateTime::setTimeZone(const QTimeZone &toZone, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

このdatetimeで使用されるタイムゾーンをtoZone に設定します。

このdatetimeは、別の時点を指している可能性があります。toZone の時刻表現を使用するため、変更されていないdate()およびtime()の意味が変わる可能性があります。

toZone が無効な場合、この日時も無効となります。それ以外の場合、呼び出し後のこの日時のtimeSpec()はtoZone.timeSpec() と一致します。

date() およびtime() が、toZone における遷移に近い瞬間を表している場合、resolve はその状況をどのように解決するかを制御します。

関連項目: timeRepresentation()、timeZone()、およびQt::TimeSpec 。

[noexcept] void QDateTime::swap(QDateTime &other)

この日時をother と入れ替えます。この処理は非常に高速で、失敗することはありません。

QTime QDateTime::time() const

datetime の時刻部分を返します。

setTime()、date()、およびtimeRepresentation()も参照してください 。

[since 6.5] QTimeZone QDateTime::timeRepresentation() const

このdatetimeが時間をどのように表しているかを識別するQTimeZone を返します。

返されるQTimeZone のtimeSpec()は、このdatetimeのそれと同じになります。もしそれがQt::TimeZone でない場合、返されるQTimeZone は時刻表現となります。timeSpec()がQt::OffsetFromUTC の場合、返されるQTimeZone のfixedSecondsAheadOfUtc()がオフセットを提供します。timeSpec()がQt::TimeZone の場合、QTimeZone オブジェクト自体がそのタイムゾーンの完全な表現となります。

この関数は Qt 6.5 で導入されました。

timeZone()、setTimeZone()、およびQTimeZone::asBackendZone()も参照してください 。

Qt::TimeSpec QDateTime::timeSpec() const

datetime の時間指定を返します。

これは、その時刻表現を「ローカル時間」、「UTC」、「UTCからの固定オフセット（オフセットの指定なし）」、または「タイムゾーン（そのタイムゾーンの詳細を指定しない）」のいずれかに分類します。timeRepresentation().timeSpec() と同等です。

setTimeZone()、timeRepresentation()、date()、およびtime()も参照してください 。

QTimeZone QDateTime::timeZone() const

datetime のタイムゾーンを返します。

結果は `timeRepresentation().asBackendZone()` と同じです。いずれの場合も、結果の `timeSpec()` は `Qt::TimeZone` となります。

timeSpec()がQt::LocalTime の場合、結果は本メソッドが呼び出された時点の現地時間を表します。たとえ元となったQDateTime が変更されたとしても、その後のシステムタイムゾーンの変更は反映されません。

関連項目： timeRepresentation()、setTimeZone()、Qt::TimeSpec 、およびQTimeZone::asBackendZone()。

QString QDateTime::timeZoneAbbreviation() const

この日時に対応するタイムゾーンの略称を返します。

返される文字列は、timeSpec() の値によって異なります：

• Qt::UTC () の場合、返される文字列は「UTC」となります。
• Qt::OffsetFromUTC の場合、形式は「UTC±00:00」となります。
• Qt::LocalTime の場合、ホストシステムに問い合わせが行われます。
• Qt::TimeZone の場合、関連付けられた `QTimeZone ` オブジェクトが照会されます。

timeSpec() およびQTimeZone::abbreviation()も参照してください 。

CFDateRef QDateTime::toCFDate() const

QDateTime からCFDateを作成します。

呼び出し元が CFDate オブジェクトを所有し、その解放も担当します。

fromCFDate()も参照してください 。

QDateTime QDateTime::toLocalTime() const

この日時を現地時間に換算したコピーを返します。

結果は、この日時と同じ時点を表し、この日時と等しくなります。

例：

QDateTime UTC(QDateTime::currentDateTimeUtc());
QDateTime local(UTC.toLocalTime());
qDebug() << "UTC time is:" << UTC;
qDebug() << "Local time is:" << local;
qDebug() << "No difference between times:" << UTC.secsTo(local);

toTimeZone()、toUTC()、およびtoOffsetFromUtc()も参照してください 。

qint64 QDateTime::toMSecsSinceEpoch() const

1970年のUTC開始時刻からの経過ミリ秒数として、日時を返します。

タイムゾーンをサポートしていないシステムでは、この関数は、現地時間がQt::UTC であるかのように動作します。

このオブジェクトに格納されている日時が無効な場合、この関数の挙動は未定義となります。ただし、有効な日付についてはすべて、この関数は一意の値を返します。

toSecsSinceEpoch()、setMSecsSinceEpoch()、およびfromMSecsSinceEpoch()も参照してください 。

NSDate *QDateTime::toNSDate() const

QDateTime からNSDateを作成します。

NSDateオブジェクトはオートリリースされます。

fromNSDate()も参照してください 。

QDateTime QDateTime::toOffsetFromUtc(int offsetSeconds) const

指定されたoffsetSeconds を用いて、このdatetimeをQt::OffsetFromUTC 仕様に変換したコピーを返します。toTimeZone(QTimeZone::fromSecondsAheadOfUtc(offsetSeconds)) と同等です。

offsetSeconds が0の場合、UTCの日時が返されます。

結果は、この日時と同じ時点を表し、この日時と等しくなります。

offsetFromUtc() およびtoTimeZone()も参照してください 。

qint64 QDateTime::toSecsSinceEpoch() const

1970年のUTC開始時刻からの経過秒数として、日時を返します。

タイムゾーンをサポートしていないシステムでは、この関数は、現地時間が `Qt::UTC` であるかのように動作します。

このオブジェクトに格納されている日時が有効でない場合、この関数の動作は未定義となります。ただし、有効な日付については、この関数は一意の値を返します。

toMSecsSinceEpoch()、fromSecsSinceEpoch()、およびsetSecsSinceEpoch()も参照してください 。

[since 6.4] std::chrono::sys_time<std::chrono::milliseconds> QDateTime::toStdSysMilliseconds() const

std::chrono::system_clock をクロックとして使用し、このdatetimeオブジェクトをミリ秒単位で表される同等の時刻に変換します。

この関数は Qt 6.4 で導入されました。

fromStdTimePoint() およびtoMSecsSinceEpoch()も参照してください 。

[since 6.4] std::chrono::sys_seconds QDateTime::toStdSysSeconds() const

このdatetimeオブジェクトを、std::chrono::system_clock を時計として使用し、秒単位で表された同等の時刻に変換します。

この関数は Qt 6.4 で導入されました。

fromStdTimePoint() およびtoSecsSinceEpoch()も参照してください 。

datetimeを文字列として返します。format パラメータは、結果の文字列の形式を決定します。cal が指定された場合、日付の表現に使用される暦が決定されます。デフォルトはグレゴリオ暦です。Qt 5.14以前では、cal パラメータは存在せず、常にグレゴリオ暦が使用されていました。format パラメータでサポートされている日時指定子については、それぞれQTime::toString()およびQDate::toString()を参照してください。

一重引用符で囲まれた空でない文字列は、たとえ書式指定文字が含まれていても、出力文字列に（引用符を除いて）そのまま含まれます。 2 つの連続した一重引用符（"''"）は、文字列をそのまま出力する区切りとして扱われるのではなく、出力では一重引用符に置き換えられます。フォーマット文字列内のその他のすべての文字は、出力文字列にそのまま含まれます。

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

フォーマット文字列の例（QDateTime が2001年5月21日 14:13:09.120であると仮定）：

日時が無効な場合、空の文字列が返されます。

fromString()、QDate::toString()、QTime::toString()、およびQLocale::toString()も参照してください 。

QString QDateTime::toString(QStringView format) const

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

指定されたformat に従って、datetimeを文字列として返します。

format がQt::TextDate の場合、文字列はデフォルトの形式でフォーマットされます。曜日と月の名称は英語になります。このフォーマットの例としては、「Wed May 20 03:40:13 1998」などがあります。ローカライズされたフォーマットについては、QLocale::toString()を参照してください。

format がQt::ISODate の場合、文字列の形式は日付および時刻の表現に関するISO 8601拡張仕様に準拠し、QDateTime のtimeSpec()に応じて、yyyy-MM-ddTHH:mm:ss[Z|±HH:mm]という形式をとります。timeSpec()がQt::UTC の場合、文字列の末尾にZが追加されます。timeSpec()がQt::OffsetFromUTC の場合、UTCからのオフセット（時間および分）が文字列の末尾に追加されます。 ISO 8601 日付にミリ秒を含めるには、format Qt::ISODateWithMs を使用します。これは yyyy-MM-ddTHH:mm:ss.zzz[Z|±HH:mm] に対応します。

format がQt::RFC2822Date の場合、文字列はRFC 2822に従ってフォーマットされます。

日付と時刻が無効な場合、空の文字列が返されます。

関連項目: fromString()、QDate::toString()、QTime::toString()、およびQLocale::toString()。

QString QDateTime::toString(const QString &format) const

QDateTime QDateTime::toTimeZone(const QTimeZone &timeZone) const

指定されたtimeZone に変換された、このdatetimeのコピーを返します。

結果は、この日時と同じ時点を表し、この日時と等しくなります。

結果は、timeZone の時刻表現を用いてその時点を表します。例えば：

QDateTime local(QDateTime::currentDateTime());
QDateTime UTC(local.toTimeZone(QTimeZone::UTC));
qDebug() << "Local time is:" << local;
qDebug() << "UTC time is:" << UTC;
qDebug() << "No difference between times represented:" << local.secsTo(UTC);

timeZone が無効な場合、datetimeも無効となります。それ以外の場合は、返されるdatetimeのtimeSpec()の値がtimeZone.timeSpec() と一致します。

timeRepresentation()、toLocalTime()、toUTC()、およびtoOffsetFromUtc()も参照してください 。

QDateTime QDateTime::toUTC() const

この日時をUTCに変換したコピーを返します。

結果は、この日時と同じ時点を表し、この日時と等しくなります。

例：

QDateTime local(QDateTime::currentDateTime());
QDateTime UTC(local.toUTC());
qDebug() << "Local time is:" << local;
qDebug() << "UTC time is:" << UTC;
qDebug() << "No difference between times:" << local.secsTo(UTC);

toTimeZone()、toLocalTime()、およびtoOffsetFromUtc()も参照してください 。

[since 6.4] QDateTime &QDateTime::operator+=(std::chrono::milliseconds duration)

指定されたduration を追加して、このdatetimeオブジェクトを変更します。

duration が正の値の場合は更新後のオブジェクトがそれより後の時刻になり、負の値の場合はそれより前の時刻になります。この datetime オブジェクトへの参照を返します。

この datetime が無効な場合、この関数は何の効果も持ちません。

この関数は Qt 6.4 で導入されました。

addMSecs()も参照してください 。

[since 6.4] QDateTime &QDateTime::operator-=(std::chrono::milliseconds duration)

指定されたduration を引くことで、このdatetimeオブジェクトを変更します。

duration が正の値の場合、更新後のオブジェクトはそれより前の時刻になり、負の値の場合はそれより後の時刻になります。このdatetimeオブジェクトへの参照を返します。

この日時が無効な場合、この関数は何の効果も持ちません。

この関数は Qt 6.4 で導入されました。

addMSecsも参照してください 。

[noexcept] QDateTime &QDateTime::operator=(const QDateTime &other)

other のdatetimeをここにコピーし、そのコピーを返します。