QDateTime 类

成员函数文档

返回日期时间作为字符串。参数format确定结果字符串的格式。如果提供了cal，它确定表示日期所使用的日历；默认为公历。在Qt 5.14之前，没有cal参数，总是使用公历。有关格式参数中支持的时间和日期指定符，请参阅QTime::toString()和QDate::toString。

单引号中的任何字符序列都将原样包含在输出字符串中（去除引号），即使它包含格式化字符。连续的两个单引号("''")在输出中将替换为单个引号。格式字符串中的所有其他字符都将原样包含在输出字符串中。

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

示例格式字符串（假设QDateTime为21 May 2001 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 中接近转变的时刻，resolve 控制如何解决这种情况。

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

这是一个重载的函数。

使用给定的 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 为负）或晚 ndays 天的日期时间。

如果timeSpec()是Qt::LocalTime或Qt::TimeZone，并且得到的日期和时间落在标准时间和夏令时转换的小时内，则结果将超出这个间隔，方向是变化的。如果转换发生在凌晨2点，时钟前进到3点，则凌晨2点到3点之间的目标结果将调整为在凌晨2点之前（如果ndays < 0）或之后3点（否则）。

另请参阅daysTo()、addMonths()、addYears()、addSecs()和Timezone transitions。

[自从 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年的日期时间（如果是负数，则是更早的时间）。

如果timeSpec()是Qt::LocalTime或Qt::TimeZone，并且结果日期和时间落在标准时间和夏令时的转换小时，则结果将超过此间隔，并在变化方向上。如果转换在凌晨2点进行并且时钟前进到凌晨3点，则目标在凌晨2点和凌晨3点之间将被调整为在凌晨2点之前（如果nyears < 0）或凌晨3点之后（否则）。

另请参阅daysTo()，addDays()，addMonths()，addSecs()和时区转换。

[静态，自6.5版本起] QDateTime QDateTime::currentDateTime(const QTimeZone &zone)

返回系统时钟的当前日期和时间，使用zone描述的时间表示。如果省略zone，则使用本地时间。

此函数在 Qt 6.5 中引入。

另请参阅currentDateTimeUtc()，QDate::currentDate()，QTime::currentTime()和toTimeSpec。

[静态] QDateTime QDateTime::currentDateTime()

这是一个重载的函数。

[静态] QDateTime QDateTime::currentDateTimeUtc()

返回以UTC表示的系统时钟的当前日期和时间。

相当于currentDateTime(QTimeZone::UTC)。

另请参阅currentDateTime()，QDate::currentDate()，QTime::currentTime()和toTimeSpec。

[静态 noexcept] qint64 QDateTime::currentMSecsSinceEpoch()

返回自1970年以来的当前毫秒数，以UTC为基准。

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

另请参阅currentDateTime()，currentDateTimeUtc()和toTimeSpec。

[静态 noexcept] qint64 QDateTime::currentSecsSinceEpoch()

返回自1970年以来的UTC起始时间秒数。

这个数字类似于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 日期时间早于当前日期时间，则返回的值是负数。

示例

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

[静态] QDateTime QDateTime::fromCFDate(CFDateRef date)

构建一个新的 QDateTime，其中包含 CFDate date 的副本。

另请参阅toCFDate()。

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

这是一个重载的函数。

返回一个表示 1970 年年初开始 UTC 时间后的给定 msecs 毫秒时刻的日期时间。所描述的时区由 timeZone 确定。默认的时间表示为本地时间。

请注意，msecs 的可能值在 QDateTime 的有效范围内，无论是负数还是正数。对于这些值该函数的行为是未定义的。

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

[静态，自 6.5 以来] QDateTime QDateTime::fromSecsSinceEpoch(qint64 secs)

这是一个重载的函数。

此函数在 Qt 6.5 中引入。

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

[静态] QDateTime QDateTime::fromNSDate(const NSDate *date)

另请参阅toNSDate()。

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

这是一个重载的函数。

返回一个表示从 1970 年年初开始 UTC 时间后的给定 secs 秒时刻的日期时间。所描述的时区由 timeZone 确定。默认的时间表示为本地时间。

请注意，存在可能的 secs 值，这些值在 QDateTime 的有效范围内，无论是负数还是正数。对于这些值该函数的行为是未定义的。

另请参阅 fromMSecsSinceEpoch()、toSecsSinceEpoch() 以及 setSecsSinceEpoch。

[static, since 6.5] QDateTime QDateTime::fromSecsSinceEpoch(qint64 secs)

这是一个重载的函数。

此函数在 Qt 6.5 中引入。

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

创建一个日期时间为从1970-01-01T00:00:00.000开始计算的本地时间（Qt::LocalTime）的毫秒数所代表的值。

此函数是在Qt 6.4中引入的。

另请参阅 toStdSysMillisecondsfromMSecsSinceEpoch。

[static, since 6.4] 模板 <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以及必要的持续时间类型转换（转换/四舍五入/...），以便输入满足上述约束。

此函数是在Qt 6.4中引入的。

另请参阅 toStdSysMillisecondsfromMSecsSinceEpoch。

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

这是一个重载的函数。

使用Qt::UTC作为其时间表示形式，构造表示与time相同时间点的日期时间。

此函数是在Qt 6.4中引入的。

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

创建一个日期时间为从1970-01-01T00:00:00.000开始计算的本地时间（Qt::LocalTime）的毫秒数所代表的值。

此函数是在Qt 6.4中引入的。

另请参阅 toStdSysMillisecondsfromMSecsSinceEpoch。

[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)

返回由指定的字符串和格式表示的QDateTime，如果无法完成，则返回无效的日期时间。

注意：对于Qt::TextDate，只识别英文简短月份名称（例如，“Jan”是简写形式，“January”是完整形式）。

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

[静态，自6.0起] QDateTime QDateTime::fromString(QStringView string, Qt::DateFormat format = Qt::TextDate)

这是一个重载的函数。

此函数自Qt 6.0版本开始引入。

[静态，自6.0起] QDateTime QDateTime::fromString(QStringView string, QStringView format, QCalendar cal)

这是一个重载的函数。

此函数自Qt 6.0版本开始引入。

[静态，自6.0起] QDateTime QDateTime::fromString(const QString &string, QStringView format, QCalendar cal)

这是一个重载的函数。

此函数自Qt 6.0版本开始引入。

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

这是一个重载的函数。

[静态，自6.7起] QDateTime QDateTime::fromString(QStringView string, QStringView format, int baseYear = QLocale::DefaultTwoDigitBaseYear)

这是一个重载的函数。

使用默认构造的QCalendar。

此函数自Qt 6.7版本开始引入。

[静态，自6.7起] QDateTime QDateTime::fromString(QStringView string, QStringView format, int baseYear, QCalendar cal)

这是一个重载的函数。

此函数自Qt 6.7版本开始引入。

[静态，自6.7起] QDateTime QDateTime::fromString(const QString &string, QStringView format, int baseYear = QLocale::DefaultTwoDigitBaseYear)

这是一个重载的函数。

使用默认构造的QCalendar。

此函数自Qt 6.7版本开始引入。

[静态，自6.0起] QDateTime QDateTime::fromString(const QString &string, QStringView format, int baseYear, QCalendar cal)

这是一个重载的函数。

此函数自Qt 6.0版本开始引入。

[静态，自6.7以来] QDateTime QDateTime::fromString(const QString &string, const QString &format, int baseYear = QLocale::DefaultTwoDigitBaseYear)

这是一个重载的函数。

使用默认构造的QCalendar。

此函数自Qt 6.7版本开始引入。

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

返回由字符串表示的日期时间，使用给定的格式，如果字符串无法解析，则返回无效的日期时间。

如果提供了cal日历，则使用该日历，否则使用公历。

当格式只指定年份的最后两位时，以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。如果格式满足但字符串表示的日期时间无效（例如，在时区转换中跳过的间隙中），则返回一个有效的QDateTime，表示一个最近的、有效的日期时间。

没有任何前导零（d、M、h、m、s、z）的表达式将是贪婪的。这意味着即使这会使它们超出范围或为其他部分留下很少的数字，它们也将使用两位（或z为三位）数字。

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

这可能会意味着00:30.00的1月1日，但M将会抓取两位数字。

如果错误地指定了字符串的域，将返回无效的 QDateTime。例如，考虑以下代码，在这里两位数的年份 12 被读取为 1912（下面表格中列出所有默认值）；由于 1912 年 4 月 23 日是星期二，不是星期一，因此结果日期时间无效。

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。

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

如果此日期时间表示一个确定的时间点，则返回 true，否则返回 false。

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

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

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

返回从当前日期时间到 其他 日期时间的毫秒数。如果 其他 日期时间早于当前日期时间，返回的值是负数。

在进行比较之前，将两个日期时间都转换为 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，以确保如果 daylight-saving (DST) 应用于两个日期时间中的一个而不适用于另一个，结果仍然是正确的。

如果任何日期时间无效，则返回 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年1月1日开始后的给定毫秒数msecs的某个时刻。

在不支持时区的系统上，此函数将表现得像本地时间是Qt::UTC一样。

请注意，传递qint64的最小值（std::numeric_limits<qint64>::min()）到msecs会导致未定义的行为。

另请参阅setSecsSinceEpoch，toMSecsSinceEpoch，以及fromMSecsSinceEpoch。

void QDateTime::setSecsSinceEpoch(qint64 secs)

将日期时间设置为表示1970年1月1日开始后的给定秒数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

返回日期时间的时部分。

另请参阅 setTime()，date()，以及 timeRepresentation()。

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

返回一个 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

返回此 datetime 的时区缩写。

返回的字符串取决于 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 的副本。

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

示例

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年年初以来的毫秒数。

在不支持时区的系统上，此函数将表现得像本地时间是Qt::UTC一样。

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

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

NSDate *QDateTime::toNSDate() const

从一个 QDateTime 中创建一个 NSDate。

该 NSDate 对象将自动释放。

另请参阅 fromNSDate。

QDateTime QDateTime::toOffsetFromUtc(int offsetSeconds) const

返回将此日期时间转换为给定 offsetSeconds 的 Qt::OffsetFromUTC 规范的副本。相当于 toTimeZone(QTimeZone::fromSecondsAheadOfUtc(offsetSeconds))。

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

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

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

qint64 QDateTime::toSecsSinceEpoch() const

返回自1970年年初以来的秒数。

在不支持时区的系统上，此函数将表现得像本地时间是Qt::UTC一样。

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

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

[自6.4版本开始] std::chrono::sys_time<std::chrono::milliseconds> QDateTime::toStdSysMilliseconds() const

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

此函数是在Qt 6.4中引入的。

另请参阅 fromStdTimePoint() 和 toMSecsSinceEpoch。

[自6.4版本开始] std::chrono::sys_seconds QDateTime::toStdSysSeconds() const

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

此函数是在Qt 6.4中引入的。

另请参阅 fromStdTimePoint() 和 toSecsSinceEpoch。

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

这是一个重载的函数。

以给定的 format 返回日期时间的字符串。

如果 format 是 Qt::TextDate，则按默认方式格式化字符串。星期和月名将使用英语。这种格式的示例是 "Wed May 20 03:40:13 1998"。有关本地化格式化，请参阅 QLocale::toString。

如果格式为Qt::ISODate，字符串格式对应于ISO 8601对日期和时间表示的扩展规范，形式为yyyy-MM-ddTHH:mm:ss[Z|±HH:mm]，具体取决于timeSpec()的QDateTime。如果timeSpec()为Qt::UTC，则会附加Z到字符串；如果timeSpec()为Qt::OffsetFromUTC，则会在字符串中附加UTC小时和分钟的偏移量。要包括ISO 8601日期中的毫秒，请使用格式Qt::ISODateWithMs，对应于yyyy-MM-ddTHH:mm:ss.zzz[Z|±HH:mm]。

如果格式为Qt::RFC2822Date，则按照RFC 2822进行格式化。

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

另请参阅fromString()，QDate::toString()，QTime::toString()，以及QLocale::toString()。

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

这是一个重载的函数。

QString QDateTime::toString(QStringView format) const

这是一个重载的函数。

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

返回转换为指定timeZone的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（转换为UTC时间）和toOffsetFromUtc（转换为UTC偏移量）。

QDateTime QDateTime::toUTC() const

返回转换为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（转换为UTC偏移量）。

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

通过添加给定的duration修改此datetime对象。如果duration为正，则更新后的对象会更晚；如果为负，则会更早。

如果此datetime无效，则此函数无效果。

返回对此datetime对象的引用。

此函数是在Qt 6.4中引入的。

另请参阅addMSecs（添加毫秒数）。

[noexcept] QDateTime &QDateTime::operator-(std::chrono::milliseconds duration)

通过减去给定的duration修改此datetime对象。如果duration为正，则更新后的对象会更早；如果为负，则会更晚。

如果此datetime无效，则此函数无效果。

返回对此datetime对象的引用。

此函数是在Qt 6.4中引入的。

另请参阅addMSecs（添加毫秒数）。

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

复制的 其他 日期时间到这个并且返回这个副本。