QDateTime Class

メンバ関数ドキュメント

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とする）：

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

fromString(),QDate::toString(),QTime::toString(),QLocale::toString()も参照 。

[noexcept] QDateTime::QDateTime()

NULLのdatetimeを作成します。

null datetime は無効であり、その日付と時刻は無効です。

isValid()、setMSecsSinceEpoch()、setDate()、setTime()、setTimeZone()も参照 。

[until 6.9] QDateTime::QDateTime(QDate date, QTime time, Qt::TimeSpec spec, int offsetSeconds = 0)

この関数はバージョン6.9で廃止予定です。

QDateTime(date, time) またはQDateTime(date, time, QTimeZone::fromSecondsAheadOfUtc(offsetSeconds)) を使用してください。

指定されたdate とtime を用いて、spec とoffsetSeconds の秒による時刻表現を用いて datetime を構築します。

date が有効でtime が有効でない場合、時刻は真夜中に設定されます。

spec がQt::OffsetFromUTC でない場合、offsetSeconds は無視される。spec がQt::OffsetFromUTC で、offsetSeconds が 0 の場合、timeSpec() はQt::UTC 、すなわち 0 秒のオフセットに設定される。

spec がQt::TimeZone の場合、spec はQt::LocalTime 、つまり現在のシステム・タイムゾーンに設定される。Qt::TimeZone datetimeを作成するには、正しいコンストラクタを使用してください。

date が QDateTime で表現可能な日付の範囲外の場合、結果は無効です。spec がQt::LocalTime で、システムのタイムゾーンが指定された日時をスキップした場合、結果は無効です。

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

指定されたdate とtime で、timeZone で記述された時間表現を使用して、datetime を構築します。

date が有効でtime が無効な場合、時刻は真夜中に設定される。timeZone が無効な場合、そのdatetimeは無効になります。date とtime が、timeZone の遷移に近い瞬間を記述している場合、resolve は、その状況をどのように解決するかを制御します。

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

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

指定されたdate とtime を用いて、ローカル時間を用いてdatetimeを構築する。

date が有効でtime が有効でない場合、時刻として真夜中が使用されます。date とtime がローカル時間の遷移に近い瞬間を記述している場合、resolve はその状況をどのように解決するかを制御します。

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

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

other datetimeのコピーを作成します。

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

一時的なother datetimeの内容をこのオブジェクトに移動し、other を指定されていない（しかし適切な）状態にします。

[noexcept] QDateTime::~QDateTime()

datetimeを破棄する。

QDateTime QDateTime::addDays(qint64 ndays) const

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

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 オブジェクトを返します。

このdatetimeが無効な場合は、無効なdatetimeが返されます。

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

addMSecs(),msecsTo(),addDays(),addMonths(),addYears()も参照してください 。

QDateTime QDateTime::addMSecs(qint64 msecs) const

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

このdatetimeが無効な場合は、無効なdatetimeが返されます。

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 オブジェクトを返します。

このdatetimeが無効な場合は、無効なdatetimeが返されます。

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(),toTimeSpec()も参照してください 。

[static] QDateTime QDateTime::currentDateTime()

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

[static] QDateTime QDateTime::currentDateTimeUtc()

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

currentDateTime(QTimeZone::UTC) と同じ。

currentDateTime()、QDate::currentDate()、QTime::currentTime()、toTimeSpec()も参照 。

[static noexcept] qint64 QDateTime::currentMSecsSinceEpoch()

1970年開始からの現在のミリ秒数をUTCで返します。

この数値はPOSIXのtime_t変数と似ているが、秒ではなくミリ秒単位で表される。

currentDateTime()、currentDateTimeUtc()、toTimeSpec()も参照 。

[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 の日付までの日数を返します。日数は、この datetime からother datetime までの間に 0 時に達した回数としてカウントされます。つまり、23:55から翌日の0:05までの10分の差が1日とカウントされます。

other datetimeがこのdatetimeより早い場合、返される値は負になります。

例

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)

timeZone で指定された 1970 年の開始時刻から、UTC で指定されたミリ秒数msecs 後を表す datetime を返します。デフォルトの時間表現はローカル時間である。

QDateTime の有効範囲外であるmsecs には、負の値も正の値もあり得ることに注意。これらの値に対するこの関数の動作は未定義である。

fromSecsSinceEpoch （）、toMSecsSinceEpoch （）、setMSecsSinceEpoch （）も参照 。

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

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

[static, until 6.9] QDateTime QDateTime::fromMSecsSinceEpoch(qint64 msecs, Qt::TimeSpec spec, int offsetSeconds = 0)

この関数はバージョン6.9で廃止予定です。

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

代わりにQTimeZone を渡すか、spec とoffsetSeconds を省略します。

spec とoffsetSeconds で指定された、1970年のUTCにおける開始時刻から、指定されたミリ秒数msecs 後を表すdatetimeを返します。

msecs には、QDateTime の有効範囲外の値（負の値も正の値も）があり得ることに注意。これらの値に対するこの関数の動作は未定義である。

spec がQt::OffsetFromUTC でない場合、offsetSeconds は無視される。spec がQt::OffsetFromUTC でoffsetSeconds が 0 の場合、UTC のオフセットが 0 であるため、Qt::UTC がspec として使用される。

spec がQt::TimeZone の場合、代わりにQt::LocalTime が使用される。これは、現在のシステムタイムゾーンを使用するのと同じである(ただし、表現は異なる)。

fromSecsSinceEpoch （）、toMSecsSinceEpoch （）、setMSecsSinceEpoch （）も参照 。

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

NSDatedate のコピーを含む新しいQDateTime を構築する。

toNSDate()も参照 。

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

timeZone で指定された 1970 年の開始時刻から、UTC で指定された秒数secs 後を表す datetime を返します。デフォルトの時間表現はローカル時間である。

QDateTime の有効範囲外であるsecs には、負の値も正の値もあり得ることに注意。これらの値に対するこの関数の動作は未定義である。

fromMSecsSinceEpoch （）、toSecsSinceEpoch （）、setSecsSinceEpoch （）も参照 。

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

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

[static, until 6.9] QDateTime QDateTime::fromSecsSinceEpoch(qint64 secs, Qt::TimeSpec spec, int offsetSeconds = 0)

この関数はバージョン6.9で廃止予定です。

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

代わりにQTimeZone を渡すか、spec とoffsetSeconds を省略します。

spec とoffsetSeconds で指定された、1970年のUTCにおける開始時刻から、指定された秒数secs を経過した時刻を表す datetime を返します。

QDateTime の有効範囲外であるsecs には、負の値も正の値もあり得ることに注意。これらの値に対するこの関数の動作は未定義である。

spec がQt::OffsetFromUTC でない場合、offsetSeconds は無視される。spec がQt::OffsetFromUTC でoffsetSeconds が 0 の場合、UTC のオフセットが 0 であるため、Qt::UTC がspec として使用される。

spec がQt::TimeZone の場合、その代わりにQt::LocalTime が使用され、現在のシステムタイムゾーンを使用するのと同じことになる(ただし、表現は異なる)。

fromMSecsSinceEpoch()、toSecsSinceEpoch()、setSecsSinceEpoch()も参照 。

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

日付と時刻がtime で表されるミリ秒数で、ローカル時間（Qt::LocalTime ）の 1970-01-01T00:00:00.000 からカウントされる datetime を構築します。

この関数は 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 から数えてtime で表されるミリ秒数である datetime を構築します (Qt::LocalTime)。

この関数は 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)

Qt::UTC を時刻表現として使用し、time と同じ時点を表す datetime を構築します。

time の時計はstd::chrono::system_clock と互換性がなければなりません；特に、std::chrono::clock_cast でサポートされている変換が存在しなければなりません。変換後、結果の継続時間型はstd::chrono::milliseconds に変換可能でなければならない。

そうでない場合、呼び出し元は、この関数への入力が上記の制約を満たすように、std::chrono::system_clock に対する必要なクロック変換と、継続時間型（cast/round/floor/ceil/...）の必要な変換を行わなければならない。

この関数は 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 int &time)

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

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

QTimeZone 、toStdSysMilliseconds()、fromMSecsSinceEpoch()も参照してください 。

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

指定されたformat を使用して、string で表されるQDateTime を返すか、それが不可能な場合は無効な datetime を返します。

Qt::TextDate に関する注意 : 英語の短い月名 (例えば、短縮形の "Jan" や長い月名の "January") だけが認識されます。

toString() およびQLocale::toDateTime()も参照 。

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

与えられたformat を使用して、string で表されるQDateTime を返します。 文字列が解析できない場合は無効な datetime を返します。

暦が与えられていればcal を使用し、そうでなければグレゴリオ暦を使用します。

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.

その他の入力文字はすべてテキストとして扱われる。一重引用符で囲まれた、空でない文字列もテキストとして扱われ（引用符は 取り除かれ）、式としては解釈されない。

QTime time1 = QTime::fromString("131", "HHh");
// time1 is 13:00:00
QTime time1 = QTime::fromString("1apA", "1amAM");
// time1 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 。フォーマットは満たしているが、string が無効な日時を表している場合（タイムゾーン遷移によってスキップされたギャップなど）、有効なQDateTime が返される。

先頭のゼロがない式（d、M、h、m、s、z）は、貪欲になります。つまり、2桁の数字（zの場合は3桁の数字）を使用し、それが範囲外であったり、他のセクションのために桁数が少なすぎたりしても、それを使用します。

QDateTime dateTime = QDateTime::fromString("130", "Mm"); // invalid

これは1 January 00:30.00を意味する可能性もあるが、Mは2桁を使用する。

string のフィールドが正しく指定されていないと、無効なQDateTime が返されます。例えば、以下のコードを考えてみましょう。2桁の西暦12が1912と読み取られています（すべてのフィールドのデフォルトは以下の表を参照してください）：

QString string = "Monday, 23 April 12 22:51:41";
QString format = "dddd, d MMMM yy hh:mm:ss";
QDateTime invalid = QDateTime::fromString(string, format);

正しいコードは

QString string = "Tuesday, 23 April 12 22:51:41";
QString format = "dddd, d MMMM yy hh:mm:ss";
QDateTime valid = QDateTime::fromString(string, format);

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, 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 を返します。そうでない場合は を返します。

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

この datetime からother datetime までのミリ秒数を返します。other の日付がこの日付より早い場合、返される値は負になります。

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

どちらかの日付が無効な場合は0を返す。

addMSecs()、daysTo() およびQTime::msecsTo()も参照 。

int QDateTime::offsetFromUtc() const

このdatetimeのOffset From UTCを秒単位で返します。

結果はtimeSpec() に依存します：

• Qt::UTC オフセットは 0 です。
• Qt::OffsetFromUTC オフセットは、最初に設定された値です。
• Qt::LocalTime UTC からのローカル時刻のオフセットが返されます。
• Qt::TimeZone タイムゾーンで使用されているオフセットが返される。

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

setOffsetFromUtc()も参照 。

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

この datetime からother datetime までの秒数を返します。other の日付がこの日付より早い場合、返される値は負の値となる。

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

どちらかの日付が無効な場合は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)

このdatetimeの日付部分をdate に設定します。

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

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

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

void QDateTime::setMSecsSinceEpoch(qint64 msecs)

1970年のUTC開始時刻から、指定されたミリ秒数（msecs ）後の瞬間を表すdatetimeを設定する。

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

qint64 (std::numeric_limits<qint64>::min()) の最小値をmsecs に渡すと、未定義の動作になることに注意。

setSecsSinceEpoch()、toMSecsSinceEpoch()、fromMSecsSinceEpoch()も参照の こと。

[until 6.9] void QDateTime::setOffsetFromUtc(int offsetSeconds)

この関数はバージョン6.9で廃止予定である。

代わりにsetTimeZone(QTimeZone::fromSecondsAheadOfUtc(offsetSeconds)) を使用する。

timeSpec() をQt::OffsetFromUTC に、offset をoffsetSeconds に設定します。 datetime は、異なる時点を参照することができます。

オフセットの最大値と最小値は、正の14時間または負の14時間である。offsetSeconds がそれより大きいか小さい場合、結果は未定義となる。

offsetSeconds が 0 の場合、timeSpec() はQt::UTC に設定される。

setTimeZone()、isValid()、offsetFromUtc()、toOffsetFromUtc()も参照 。

void QDateTime::setSecsSinceEpoch(qint64 secs)

1970年のUTC開始時刻から、指定された秒数（secs ）後の時刻を表すdatetimeを設定する。

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

setMSecsSinceEpoch(),toSecsSinceEpoch(),fromSecsSinceEpoch()も参照 。

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

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

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

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

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

[until 6.9] void QDateTime::setTimeSpec(Qt::TimeSpec spec)

この関数はバージョン6.9で廃止予定である。

代わりにsetTimeZone() を使用してください。

この datetime で使用される時間指定をspec に設定します。 datetime は、異なる時点を参照することができます。

spec がQt::OffsetFromUTC の場合、timeSpec() はQt::UTC に設定される。

spec がQt::TimeZone の場合、spec はQt::LocalTime 、つまり現在のシステム・タイムゾーンに設定される。

例

QDateTime local(QDateTime::currentDateTime());
qDebug() << "Local time is:" << local;

QDateTime UTC(local);
UTC.setTimeSpec(Qt::UTC);
qDebug() << "UTC time is:" << UTC;

qDebug() << "There are" << local.secsTo(UTC) << "seconds difference between the datetimes.";

setTimeZone()、timeSpec()、toTimeSpec()、setDate()、setTime()も参照のこと 。

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

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

datetime は、異なる時点を参照することができます。これは、toZone の時間表現を使用するため、変更されないdate() およびtime() の意味が変更される可能性があります。

toZone が無効な場合、datetimeは無効となる。そうでない場合、呼 び出し後のこのdatetimeのtimeSpec()は、toZone.timeSpec() に一致する。

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

timeRepresentation(),timeZone(),Qt::TimeSpecも参照してください 。

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

このdatetimeを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() に相当する。

setTimeSpec()、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

Time Zone Abbreviation関数は、この日付のタイムゾーン略語を返します。

返される文字列は、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

このdatetimeをローカル時間に変換したコピーを返します。

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

例：

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 であるかのように動作する。

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

toSecsSinceEpoch()、setMSecsSinceEpoch() およびfromMSecsSinceEpoch()も参照 。

NSDate *QDateTime::toNSDate() const

QDateTime から NSDate を作成します。

NSDate オブジェクトは自動解放されます。

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

QDateTime QDateTime::toOffsetFromUtc(int offsetSeconds) const

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

offsetSeconds が 0 の場合は UTC datetime が返されます。

この結果は、この datetime と同じ時刻を表し、それと等しくなります。

setOffsetFromUtc()、offsetFromUtc() およびtoTimeZone()も参照 。

qint64 QDateTime::toSecsSinceEpoch() const

datetimeは、1970年のUTC開始からの秒数で返される。

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

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

toMSecsSinceEpoch()、fromSecsSinceEpoch()、setSecsSinceEpoch()も参照 。

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

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

この関数は 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()も参照してください 。

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|±H:mm] の形式をとる。timeSpec() がQt::UTC の場合、文字列に Z が付加される。timeSpec() がQt::OffsetFromUTC の場合、文字列に UTC からの時分オフセットが付加される。ISO 8601の日付にミリ秒を含めるには、format Qt::ISODateWithMs 、yyyy-MM-ddTHH:mm:ss.zz[Z|±HH:mm]に対応する。

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

datetimeが無効な場合、空の文字列が返される。

fromString()、QDate::toString()、QTime::toString()、QLocale::toString()も参照 。

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

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

[until 6.9] QDateTime QDateTime::toTimeSpec(Qt::TimeSpec spec) const

この関数はバージョン 6.9 で廃止予定です。

代わりにtoTimeZone() を使用してください。

指定された時刻spec に変換した datetime のコピーを返します。

この結果は、この datetime と同じ時刻を表し、それと等しくなります。

spec がQt::OffsetFromUTC の場合、Qt::UTC に設定されます。UTC からの固定オフセットに設定するには、toTimeZone() またはtoOffsetFromUtc() を使用します。

spec がQt::TimeZone の場合、Qt::LocalTime 、つまりローカルのタイムゾーンに設定される。指定したタイムゾーンを設定するには、toTimeZone （）を使用します。

例

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

setTimeSpec()、timeSpec()、toTimeZone()も参照 。

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

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

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

結果は、timeZone の時間表現で、その時点の時刻を表します。例えば

QDateTime local(QDateTime::currentDateTime());
QDateTime UTC(local.toTimeSpec(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

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

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

例：

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が無効な場合、この関数は何も行いません。

このdatetimeオブジェクトへの参照を返します。

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

addMSecsも参照してください 。

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

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