Qt：QDateTime

2024-01-08 20:05:22

0、说明

提供时间日期的表达和相关函数。

QDateTime通过日期+时间来构造一个日期时间。它综合了QDate和QTime的所有特性。

它可以通过系统时钟来获取当前DateTime。它还提供了比较时间的方法和对时间进行加减运算的方法。

QDateTime可以分别通过本地时间、UTC、UTC偏移时间、指定时区（通过QTimeZone类实现）来描述日期时间。这些时间间是相关的，例如，UTC偏移 +3600×8 秒等同于 ISO标准标识 UTC+08:00，等同于时区为CN/Beijing 的时间。

1）构造

一个QDateTime既可以直接通过传入一个date和time进行构造，也可以调用如currentDateTime()、fromMSecsSinceEpoch()的静态函数来进行构造。date和time可以通过setDate()、setTime()来进行设置，也可以直接通过setMSecsSinceEpoch()来用时间戳进行构造，也可以用fromString()来从一个String用相关的格式进行构造。

2）当前时间

QDateTime::currentDateTime()返回当前DateTime，QDateTime::currentDateTimeUtc()返回UTC下的当前时间。

3）提取与设置

可以通过date()、time()来提取该DateTime中的Date与Time。同样的信息可以通过在toString()中传入指定格式来实现。

4）运算

addMSecs()：加上毫秒

addSecs()：秒

addDays()：日

addMonths()：月

addYears()：年

daysTo()：两个DateTime间的天数

msecTo()：两个DateTime间的毫秒数

5）转换

toTimeSpec()：转换为本地时间

toOffsetFromUtc()：转换为UTC偏移时间

toTimeZone()：转换为时区时间

timeSpec()：存储时间的相对时间规范

Qt::TimeZone + timeZone()：返回时区

注意事项

①没有0年

只有-1与1年

1、模块和加载项

Header:	#include <QDateTime>
qmake:	QT += core

2、构造

QDateTime(QDateTime other)	构造另一个QDateTime的副本
QDateTime(QDate date, QTime time, QTimeZone timeZone)	用指定的Date、Time、TimeZone构造DateTime
QDateTime(QDate date, QTime time, Qt::TimeSpec spec, int offsetSeconds)
QDateTime(QDate date, QTime time, Qt::TimeSpec spec = Qt::LocalTime)
QDateTime(QDate date)	用指定QDate构造QDateTime
QDateTime()

3、静态字段

enum class YearRange { First, Last } 年的范围

Constant	Value	Description
`QDateTime::YearRange::First`	`-292275056`	The later parts of this year are representable
`QDateTime::YearRange::Last`	`+292278994`	The earlier parts of this year are representable

5、静态方法

返回值类型	方法	说明
QDateTime	currentDateTime()	当前本地时间
QDateTime	currentDateTimeUtc()	当前UTC时间
qint64	currentMSecsSinceEpoch()	当前时间戳（毫秒）
qint64	currentSecsSinceEpoch()	当前时间戳（秒）
QDateTime	fromCFDate(CFDateRef date)	从一个CFDate构造QDateTime
	fromMSecsSinceEpoch(qint64 msecs) fromMSecsSinceEpoch(qint64 msecs, Qt::TimeSpec spec, int offsetSeconds = 0) fromMSecsSinceEpoch(qint64 msecs, QTimeZone timeZone)	返回时间戳（毫秒）对应的QDateTime
	fromNSDate(const NSDate *date)	从NSDate构造QDateTime
	fromSecsSinceEpoch(qint64 secs, Qt::TimeSpec spec = Qt::LocalTime, int offsetSeconds = 0) fromSecsSinceEpoch(qint64 secs, QTimeZone timeZone)	返回时间戳（秒）对应的QDateTime
	fromString(QString string, Qt::DateFormat format = Qt::TextDate) fromString(QString string, QString format) fromString(QString string, QString format, QCalendar cal)	从QString用指定格式构造QDateTime