QDateTime Class

成员函数文档

以字符串形式返回日期时间。format 参数决定结果字符串的格式。如果提供cal ，它将决定用于表示日期的日历；默认为公历。在 Qt 5.14 之前，没有cal 参数，始终使用公历。关于format 参数中分别支持的时间和日期指定符，请参阅QTime::toString() 和QDate::toString() 。

任何用单引号括起来的字符序列都将逐字包含在输出字符串中（去掉引号），即使其中包含格式化字符。在输出中，两个连续的单引号（"''"）将被一个单引号取代。格式字符串中的所有其他字符将逐字包含在输出字符串中。

支持不带分隔符的格式（如 "ddMM"），但必须谨慎使用，因为生成的字符串并不总是可靠可读的（例如，如果 "dM "生成 "212"，它可能表示 12 月 2 日或 2 月 21 日）。

格式字符串示例（假定QDateTime 为 2001 年 5 月 21 日 14:13:09.120）：

如果日期时间无效，将返回空字符串。

另请参阅 fromString()、QDate::toString()、QTime::toString() 和QLocale::toString()。

[noexcept] QDateTime::QDateTime()

构造一个空日期时间，名义上使用当地时间。

空日期时间是无效的，因为它的日期和时间都是无效的。

另请参阅 isValid(),setMSecsSinceEpoch(),setDate(),setTime() 和setTimeZone().

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

使用给定的date 和time ，并使用timeZone 所描述的时间表示法，构造一个日期时间。

如果date 有效而time 无效，时间将被设置为午夜。如果timeZone 无效，日期时间也将无效。如果date 和time 所描述的时刻接近timeZone 的过渡时刻，则resolve 将控制如何解决这种情况。

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

这是一个重载函数。

根据给定的date 和time ，使用当地时间构造日期时间。

如果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()

销毁日期时间。

QDateTime QDateTime::addDays(qint64 ndays) const

返回一个QDateTime 对象，其中包含一个日期时间ndays ，比该对象的日期时间晚几天（如果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

返回一个QDateTime 对象，其中包含一个日期时间msecs 毫秒，该日期时间晚于此对象的日期时间（如果msecs 为负数，则早于此日期时间）。

如果该日期时间无效，将返回一个无效的日期时间。

该函数在 Qt 6.4 中引入。

另请参阅 addMSecs()、msecsTo()、addDays()、addMonths() 和addYears()。

QDateTime QDateTime::addMSecs(qint64 msecs) const

返回一个QDateTime 对象，其中包含一个日期时间msecs 毫秒，该日期时间晚于此对象的日期时间（如果msecs 为负数，则早于此日期时间）。

如果该日期时间无效，将返回一个无效的日期时间。

另请参见 addSecs()、msecsTo()、addDays()、addMonths() 和addYears()。

QDateTime QDateTime::addMonths(int nmonths) const

返回一个QDateTime 对象，其中包含一个比该对象的日期时间nmonths 晚几个月的日期时间（如果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

返回一个QDateTime 对象，其中包含一个比该对象的日期时间晚s 秒的日期时间（如果s 为负数，则比该日期时间早）。

如果该日期时间无效，将返回一个无效的日期时间。

另请参阅 addMSecs()、secsTo()、addDays()、addMonths() 和addYears()。

QDateTime QDateTime::addYears(int nyears) const

返回一个QDateTime 对象，其中包含一个比该对象的日期时间nyears 晚几年的日期时间（如果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() 和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 年（世界协调时）开始以来的当前毫秒数。

这个数字类似于 POSIX time_t 变量，但单位是毫秒而不是秒。

另请参阅 currentDateTime()、currentDateTimeUtc() 和toTimeZone()。

[static noexcept] qint64 QDateTime::currentSecsSinceEpoch()

返回自 1970 年（世界协调时）开始后的秒数。

该数字类似于 POSIX time_t 变量。

另请参阅 currentMSecsSinceEpoch().

QDate QDateTime::date() const

返回日期时间的日期部分。

另请参阅 setDate()、time() 和timeRepresentation()。

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

返回从此日期时间到other 日期时间的天数。天数按此日期时间到other 日期时间之间到达午夜的次数计算。也就是说，从 23:55 到次日 0:05 相差 10 分钟，也算一天。

如果other 日期早于此日期，则返回值为负数。

示例

QDateTimestartDate(QDate(2012, 7, 6), QTime(8, 30, 0));QDateTimeendDate(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)

构造一个新的QDateTime ，其中包含 CFDatedate 的副本。

另请参阅 toCFDate() 。

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

返回一个日期时间，它代表 1970 年（UTC 时）开始后的某一时刻，其给定的毫秒数为msecs ，具体描述见timeZone 。默认时间表示为当地时间。

请注意，msecs 的值可能超出QDateTime 的有效范围，包括负值和正值。对于这些值，本函数的行为未定义。

另请参阅 fromSecsSinceEpoch()、toMSecsSinceEpoch() 和setMSecsSinceEpoch()。

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

这是一个重载函数。

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

构造一个新的QDateTime ，其中包含 NSDatedate 的副本。

另请参阅 toNSDate() 。

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

返回一个日期时间，代表 1970 年（UTC）开始后给定秒数secs 的时刻，该时刻由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)

构造一个日期和时间均为time 所代表的毫秒数的 datetime，该毫秒数自 1970-01-01T00:00:00.000 当地时间起计算 (Qt::LocalTime)。

此函数在 Qt 6.4 中引入。

另请参阅 toStdSysMilliseconds() 和fromMSecsSinceEpoch() 。

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

构造一个日期和时间均为time 所代表的毫秒数的 datetime，该毫秒数自 1970-01-01T00:00:00.000 当地时间起计算 (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 表示相同时间点的日期时间。

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 相同的时间点。结果将以time 的时区表示。

此函数在 Qt 6.4 中引入。

另请参阅 QTimeZone,toStdSysMilliseconds() 和fromMSecsSinceEpoch() 。

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

使用给定的format 返回string 所代表的QDateTime ，如果无法返回，则返回无效的日期时间。

Qt::TextDate 的注意事项：只识别英文短月名（如短月名 "Jan "或长月名 "January"）。

另请参见 toString() 和QLocale::toDateTime()。

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

使用给出的format 返回string 所代表的QDateTime ，如果字符串无法解析，则返回无效的日期时间。

如果提供了日历cal ，则使用公历，否则使用格里高利历。

如果format 只指定了年份的最后两位数字，则首先考虑从baseYear 开始的 100 年。在 6.7 之前，没有baseYear 参数，总是使用 1900。这是baseYear 的默认设置，选择从 1900 年到 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）将是贪心的。这意味着它们将使用两位数（或三位数，对于 z），即使这会使它们超出范围和/或给其他部分留下的位数太少。

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

这可能意味着 1 January 00:30.00，但 M 会抓取两位数。

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

如果日期和时间均为空，则返回true ；否则返回false 。空日期时间无效。

另请参阅 QDate::isNull()、QTime::isNull() 和isValid()。

bool QDateTime::isValid() const

如果该日期时间代表一个确定的时刻，则返回true ，否则返回false 。

如果日期和时间都是有效的，并且所使用的时间表示法对它们的组合赋予了有效的含义，那么日期时间就是有效的。当时间表示的是特定时区或当地时间时，在某些日期中，时区表示可能会跳过一些时间，如夏令时转换跳过一小时（通常是在春季的夜晚）。例如，如果夏令时在凌晨 2 点结束，时钟前进到凌晨 3 点，则当天 02:00:00 至 02:59:59.999 的日期时间无效。

另请参阅 QDateTime::YearRange,QDate::isValid() 和QTime::isValid()。

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

返回从此日期时间到other 日期时间之间的毫秒数。如果other 日期时间早于此日期时间，则返回值为负数。

在进行比较之前，会将两个日期时间转换为Qt::UTC ，以确保在夏令时 (DST) 适用于其中一个日期时间而不适用于另一个日期时间的情况下，结果是正确的。

如果其中一个日期时间无效，则返回 0。

另请参阅 addMSecs()、daysTo() 和QTime::msecsTo()。

int QDateTime::offsetFromUtc() const

以秒为单位返回该日期时间的UTC 偏移量。

结果取决于timeSpec()：

• Qt::UTC 偏移值为 0。
• Qt::OffsetFromUTC 偏移量是最初设置的值。
• Qt::LocalTime 返回本地时间与 UTC 的偏移量。
• Qt::TimeZone 返回时区使用的偏移量。

对于后两项，将返回该日期和时间的偏移量，同时考虑夏令时偏移量。偏移量是给定时区的当地时间或时间与 UTC 时间之间的差值；在 UTC 之前（本初子午线以东）的时区为正值，在 UTC 之后（本初子午线以西）的时区为负值。

另请参见 setOffsetFromUtc().

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

返回从此日期时间到other 日期时间的秒数。如果other 日期时间早于此日期时间，则返回值为负数。

在进行比较之前，会将两个日期时间转换为Qt::UTC ，以确保在夏令时 (DST) 适用于其中一个日期时间而不适用于另一个日期时间的情况下，结果是正确的。

如果其中一个日期时间无效，则返回 0。

示例

QDateTimenow=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)

将此日期时间的日期部分设置为date 。

如果尚未设置时间，则设置为午夜。如果date 无效，则QDateTime 也无效。

如果date 和time() 描述了该日期时间的时间表示接近过渡的时刻，resolve 将控制如何解决这种情况。

另请参阅 date()、setTime() 和setTimeZone()。

void QDateTime::setMSecsSinceEpoch(qint64 msecs)

将日期时间设置为 1970 年（世界协调时）开始后的给定毫秒数（msecs ）。

在不支持时区的系统上，该函数的行为将与当地时间Qt::UTC 相同。

请注意，将qint64 (std::numeric_limits<qint64>::min()) 的最小值传入msecs 将导致未定义的行为。

另请参阅 setSecsSinceEpoch()、toMSecsSinceEpoch() 和fromMSecsSinceEpoch()。

void QDateTime::setSecsSinceEpoch(qint64 secs)

将日期时间设置为 1970 年（世界协调时）开始后给定秒数（secs ）的时刻。

在不支持时区的系统上，该函数的行为将与当地时间Qt::UTC 相同。

另请参阅 setMSecsSinceEpoch()、toSecsSinceEpoch() 和fromSecsSinceEpoch()。

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

将此日期时间的时间部分设置为time 。如果time 无效，则此函数将其设置为午夜。因此，可以通过将QDateTime 设置为默认的QTime 来清除 中的任何设定时间：

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

如果date() 和time 描述了一个接近于该日期时间的时间表示过渡的时刻，resolve 将控制如何解决这种情况。

另请参阅 time()、setDate() 和setTimeZone()。

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

将此日期时间使用的时区设置为toZone 。

该日期时间可能指不同的时间点。它使用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

返回日期时间的时间部分。

另请参阅 setTime()、date() 和timeRepresentation()。

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

返回一个QTimeZone ，指明该日期时间如何表示时间。

返回的QTimeZone 的timeSpec() 将与该日期时间的 () 一致；如果不是Qt::TimeZone ，则返回的QTimeZone 是时间表示法。当timeSpec() 为Qt::OffsetFromUTC 时，返回的QTimeZone 的 fixedSecondsAheadOfUtc() 将提供偏移量。当timeSpec() 为Qt::TimeZone 时，QTimeZone 对象本身就是该时区的完整表示。

此函数在 Qt 6.5 中引入。

另请参阅 timeZone()、setTimeZone() 和QTimeZone::asBackendZone()。

Qt::TimeSpec QDateTime::timeSpec() const

返回日期时间的时间规格。

它将时间表示法分为当地时间、UTC、UTC 固定偏移量（不指明偏移量）或时区（不提供时区详情）。等同于timeRepresentation().timeSpec() 。

另请参阅 setTimeZone()、timeRepresentation()、date() 和time() 。

QTimeZone QDateTime::timeZone() const

返回日期时间的时区。

结果与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

返回该日期时间转换为当地时间的副本。

结果代表与此日期时间相同的时间点，并与此日期时间相等。

示例

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

以 1970 年（世界协调时）开始后的毫秒数返回日期时间。

在不支持时区的系统中，该函数的行为将与本地时间Qt::UTC 相同。

如果存储在此对象中的日期时间无效，则此函数的行为未定义。不过，对于所有有效日期，该函数都会返回一个唯一值。

另请参阅 toSecsSinceEpoch()、setMSecsSinceEpoch() 和fromMSecsSinceEpoch()。

NSDate *QDateTime::toNSDate() const

从QDateTime 创建 NSDate。

NSDate 对象将自动释放。

另请参阅 fromNSDate().

QDateTime QDateTime::toOffsetFromUtc(int offsetSeconds) const

返回将此日期时间转换为Qt::OffsetFromUTC 的规格的副本，其中包含给定的offsetSeconds 。等同于toTimeZone(QTimeZone::fromSecondsAheadOfUtc(offsetSeconds)) 。

如果offsetSeconds 等于 0，则返回 UTC 日期时间。

结果与此日期时间代表同一时刻，并与之相等。

另请参阅 setOffsetFromUtc()、offsetFromUtc() 和toTimeZone()。

qint64 QDateTime::toSecsSinceEpoch() const

以 1970 年（世界协调时）开始后的秒数返回日期时间。

在不支持时区的系统中，该函数的行为将与本地时间Qt::UTC 相同。

如果存储在此对象中的日期时间无效，则此函数的行为未定义。不过，对于所有有效日期，该函数都会返回一个唯一值。

另请参阅 toMSecsSinceEpoch()、fromSecsSinceEpoch() 和setSecsSinceEpoch()。

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

使用std::chrono::system_clock 作为时钟，将此日期时间对象转换为以毫秒表示的等效时间点。

此函数在 Qt 6.4 中引入。

另请参阅 fromStdTimePoint() 和toMSecsSinceEpoch()。

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

使用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 。

如果format 是Qt::TextDate ，字符串将按默认方式格式化。日期和月份名称将使用英文。格式化示例为 "Wed May 20 03:40:13 1998"。有关本地化格式，请参阅QLocale::toString() 。

如果format 是Qt::ISODate ，字符串格式与 ISO 8601 中日期和时间表示法的扩展规范一致，格式为 yyyy-MM-ddTHH:mm:ss[Z|±HH:mm]，具体取决于QDateTime 的timeSpec() 。如果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 的副本。

结果代表与此日期时间相同的时间点，并等于此日期时间。

结果用timeZone 的时间表示法描述时间时刻。例如

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

如果timeZone 无效，日期时间也将无效。否则，返回的日期时间timeSpec() 将与timeZone.timeSpec() 匹配。

另请参阅 timeRepresentation()、toLocalTime()、toUTC() 和toOffsetFromUtc()。

QDateTime QDateTime::toUTC() const

返回该日期时间转换为 UTC 的副本。

结果代表与此日期时间相同的时间点，并与之相等。

示例

QDateTimelocal(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 来修改此日期时间对象。如果duration 为正值，则更新后的对象将更晚，如果为负值，则更新后的对象将更早。

如果此日期时间无效，此函数将不起作用。

返回此日期时间对象的引用。

此函数在 Qt 6.4 中引入。

另请参阅 addMSecs().

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

通过减去给定的duration 来修改此日期时间对象。如果duration 为正值，则更新后的对象将提前；如果为负值，则更新后的对象将推迟。

如果此日期时间无效，此函数将不起作用。

返回该日期时间对象的引用。

此函数在 Qt 6.4 中引入。

另请参阅 addMSecs 。

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

将other datetime 复制到 this 中并返回该副本。