QDateTime Class

成员函数文档

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

根据给定的date 和time ，并采用timeZone 中描述的时间表示法，构建一个 datetime 对象。

如果date 有效而time 无效，则时间将设为午夜。如果timeZone 无效，则该日期时间对象将无效。如果date 和time 描述的时刻接近timeZone 的过渡点，则resolve 控制该情况的处理方式。

[noexcept] QDateTime::QDateTime()

构建一个空的日期时间对象，名义上使用本地时间。

空日期时间是无效的，因为其日期和时间均无效。

另请参阅 isValid()、setMSecsSinceEpoch()、setDate()、setTime() 以及setTimeZone()。

[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 日期时间对象的副本。

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

将临时other 数据时间的内容移动到此对象中，并将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年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 日期时间之间，午夜到达的次数。这意味着从23:55到次日0:05的10分钟时间差，计为一天。

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

创建一个新的QDateTime 对象，其中包含CFDatedate 的副本。

另请参阅 toCFDate()。

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

返回一个表示特定时刻的日期时间对象，该时刻距离1970年UTC起始时间（如timeZone 所指定）后的指定毫秒数msecs 。默认的时间表示形式为本地时间。

请注意，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 表示的毫秒数构成，该数值是从本地时间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) 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 >; }

构建一个表示与time 同一时间点的数据时间对象，并使用Qt::UTC 作为其时间表示形式。

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)

构建一个日期时间对象，其日期和时间即为time 所表示的毫秒数，该数值是从本地时间1970-01-01T00:00:00.000（Qt::LocalTime ）开始计数的。

该函数在 Qt 6.4 中引入。

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

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

构建一个与time 表示同一时间点的数据时间对象，并使用Qt::UTC 作为其时间表示形式。

该函数于 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 相同时间点的数据时间对象。结果将采用time 的时间区表示。

该函数在 Qt 6.4 中引入。

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

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

返回由string 所表示的QDateTime ，使用给定的format ；如果无法解析该字符串，则返回一个无效的日期时间。

若提供了日历cal ，则使用该日历；否则使用公历。

当format 仅指定年份的最后两位数字时，将首先考虑从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 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 。

当数字字段紧邻排列且没有分隔符来分割数字序列时，可能会出现歧义：某些允许使用一位数的字段是否使用了两位数（因为要表示的值大于9）。 若为该字段分配两位数会导致其他字段可用位数不足，且单位数读数与其他字段一致，则可解决此歧义。 否则（即当多个字段被允许仅使用一位数字，且若每个字段只用一位数字时会剩余位数），在数据保持一致的前提下，优先采用将额外位数分配给前序字段的处理方式，而非分配给后序字段。例如：

不带前导零的表达式（d、M、h、m、s、z）将采用贪婪策略。这意味着即使这会导致其超出范围和/或使其他部分的位数不足，它们仍会使用两位（或 z 的三位）。

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

这本可能表示 1 月 1 日 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] 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

如果该日期时间处于夏令时期间，则返回 true。

如果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 日期时间的毫秒数。

在执行比较之前，会将这两个日期时间转换为Qt::UTC ，以确保当其中一个日期时间适用夏令时（DST）而另一个不适用时，结果仍然正确。

如果“other ”日期时间早于当前日期时间，则返回负数。如果任一日期时间无效，则返回 0。

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

int QDateTime::offsetFromUtc() const

返回该日期时间的与UTC的时差（以秒为单位）。

结果取决于timeSpec()：

• Qt::UTC 该偏移量为 0。
• Qt::OffsetFromUTC 偏移量即为最初设置的值。
• Qt::LocalTime 返回本地时间相对于 UTC 的偏移量。
• Qt::TimeZone 返回时区所使用的偏移量。

对于最后两种情况，将返回该日期和时间下的偏移量，并考虑夏令时偏移量。 时差是指当地时间或指定时区的时间与 UTC 时间之间的差值；在比 UTC 早的时区（本初子午线以东），时差为正；在比 UTC 晚的时区（本初子午线以西），时差为负。

另请参阅 setTimeZone()。

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

返回从当前日期时间到other 日期时间的秒数。

在执行比较之前，会将这两个日期时间转换为Qt::UTC ，以确保当其中一个日期时间适用夏令时（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 。

如果尚未设置时间，则将其设为午夜。如果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)

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

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

返回 datetime 对象中的时间部分。

另请参阅 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"，则返回"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

返回该日期时间的副本，该副本已转换为符合Qt::OffsetFromUTC 规范且符合给定offsetSeconds 的格式。等同于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 作为时钟，将此日期时间对象转换为以毫秒为单位的等效时间点。

该函数在 Qt 6.4 中引入。

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

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

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

该函数在 Qt 6.4 中引入。

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

将日期和时间作为字符串返回。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()。

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 进行格式化。

如果日期和时间（xml-ph-0000@deepl.internal）无效，则返回一个空字符串。

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

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

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

返回该日期时间的副本，并将其转换为指定的timeZone 。

该结果表示与该日期时间相同的时刻，且与该日期时间完全相等。

结果使用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 无效，则该日期时间也将无效。否则，返回的日期时间的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 来修改此日期时间对象。

如果duration 为正数，更新后的对象时间将推迟；如果为负数，则时间将提前。返回对此日期时间对象的引用。

如果该日期时间对象无效，则此函数无效果。

该函数在 Qt 6.4 中引入。

另请参阅 addMSecs()。

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

通过减去给定的duration 来修改此日期时间对象。

如果duration 为正数，更新后的对象时间将更早；如果为负数，则更新后的对象时间将更晚。返回对此datetime对象的引用。

如果该 datetime 对象无效，则此函数将无效果。

此函数在 Qt 6.4 中引入。

另请参阅 addMSecs 。

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

将other 中的日期时间复制到此处，并返回该副本。