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

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

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

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

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

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

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

QDateTime QDateTime::addMSecs(qint64 msecs) const

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

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

addSecs()、msecsTo()、addDays()、addMonths() およびaddYears()も参照 。

QDateTime QDateTime::addMonths(int nmonths) const

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

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

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

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

addMSecs()、secsTo()、addDays()、addMonths() およびaddYears()も参照 。

QDateTime QDateTime::addYears(int nyears) const

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

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

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

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

例

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

開始日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を返します。デフォルトの時刻表現はローカルタイムである。

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

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を返します。デフォルトの時刻表現はローカルタイムです。

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

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を返します。

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

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)

日時がtime で表されるミリ秒数で、現地時間（Qt::LocalTime ）で 1970-01-01T00:00:00.000 からカウントされる 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)

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 が返される。ローカル時間の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, 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 の日時は無効である。

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つの日付がQt::UTC に変換されます。これは、2つの日付の一方に夏時間が適用され、もう一方には適用されない場合に、結果が正しくなるようにするためです。

どちらかの日付が無効な場合は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今 QDateTime::currentDateTime()；QDateTimexmas(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 に、オフセットを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ローカル(QDateTime::currentDateTime())；qDebug() << "Local time is:" << local;

QDateTimeUTC(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)

この日付と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

この日付のタイムゾーン略語を返します。

返される文字列は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 と同じ時刻を表します。

例

QDateTimeUTC(QDateTime::currentDateTimeUtc())；QDateTimelocal(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

datetime関数は、1970年のUTC開始時刻からのミリ秒数を返します。

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

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

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

NSDate *QDateTime::toNSDate() const

QDateTime から NSDate を作成する。

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

fromNSDate()も参照 。

QDateTime QDateTime::toOffsetFromUtc(int offsetSeconds) const

このdatetimeのコピーを、指定されたoffsetSeconds でQt::OffsetFromUTC の仕様に変換して返す。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.zzz[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() を使用してください。

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

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

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

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

例

QDateTimeローカル(QDateTime::currentDateTime())；QDateTimeUTC(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 と同じ時刻を表し、等しくなります。

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

QDateTimelocal(QDateTime::currentDateTime())；QDateTimeUTC(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

UTCに変換されたdatetimeのコピーを返す。

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

例

QDateTimeローカル(QDateTime::currentDateTime())；QDateTimeUTC(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)

このdatetimeオブジェクトを、与えられたduration を引くことによって変更する。更新されたオブジェクトは、duration が正の場合は早くなり、負の場合は遅くなります。

このdatetimeが無効な場合、この関数は何も行いません。

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

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

addMSecsも参照してください 。

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

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