介绍

日期时间复合类，提供精确到毫秒的日期时间操作

基础信息

头文件:	include <tpDateTime.h>
Cmake:	None
发布版本:	V0.1.0
继承类:
派生类:

Public 成员函数

	tpDateTime()
	~tpDateTime()
tpDate tpDateTime::date	date() const	获取日期部分
tpTime	time() const	获取时间部分
	toMSecsSinceEpoch() const	转换为UTC毫秒时间戳
	toSecsSinceEpoch() const	转换为UTC秒时间戳
	setMSecsSinceEpoch(int64_t msecs)	通过UTC毫秒时间戳设置时间
	setSecsSinceEpoch(int64_t secs)	通过UTC秒时间戳设置时间
	setDate(const tpDate &date)	设置日期部分（保持时间不变）
	setTime(const tpTime &time)	设置时间部分（保持日期不变）
tpString	toString(const tpString &format) const	格式化输出日期时间
tpDateTime tpDateTime::addDays	addDays(int64_t days) const	增加指定天数
tpDateTime tpDateTime::addMonths	addMonths(int32_t months) const	增加指定月数
tpDateTime tpDateTime::addYears	addYears(int32_t years) const	增加指定年数
tpDateTime tpDateTime::addSecs	addSecs(int64_t secs) const	增加指定秒数
tpDateTime tpDateTime::addMSecs	addMSecs(int64_t msecs) const	增加指定毫秒数
	daysTo(const tpDateTime &other) const	计算到目标日期的天数差
	secsTo(const tpDateTime &other) const	计算到目标时间的秒数差
	msecsTo(const tpDateTime &other) const	计算到目标时间的毫秒数差
tpDateTime & tpDateTime::operator=	operator=(const tpDateTime &other) noexcept
	operator==(const tpDateTime &other) const
	operator<(const tpDateTime &other) const
	operator!=(const tpDateTime &other) const
	operator<=(const tpDateTime &other) const
	operator>(const tpDateTime &other) const
	operator>=(const tpDateTime &other) const
static tpDateTime tpDateTime::currentDateTime	currentDateTime()	获取当前系统日期时间（本地时区）
static tpDateTime tpDateTime::fromString	fromString(const tpString &s, const tpString &format)	从格式字符串解析日期时间
static tpDateTime tpDateTime::fromMSecsSinceEpoch	fromMSecsSinceEpoch(int64_t msecs)	从毫秒时间戳创建对象（UTC时区）
static tpDateTime tpDateTime::fromSecsSinceEpoch	fromSecsSinceEpoch(int64_t secs)	从秒时间戳创建对象（UTC时区）
	currentMSecsSinceEpoch() noexcept	获取当前UTC毫秒时间戳
	currentSecsSinceEpoch() noexcept	获取当前UTC秒时间戳

成员函数说明

tpDateTime::tpDateTime()

暂无注释...

tpDateTime::~tpDateTime()

暂无注释...

tpDate tpDateTime::date() const

点击查看...

获取日期部分
返回值：日期对象副本

tpTime tpDateTime::time() const

点击查看...

获取时间部分
返回值：时间对象副本

int64_t tpDateTime::toMSecsSinceEpoch() const

点击查看...

转换为UTC毫秒时间戳
返回值：自epoch的毫秒数

int64_t tpDateTime::toSecsSinceEpoch() const

点击查看...

转换为UTC秒时间戳
返回值：自epoch的秒数

void tpDateTime::setMSecsSinceEpoch(int64_t msecs)

点击查看...

通过UTC毫秒时间戳设置时间

void tpDateTime::setSecsSinceEpoch(int64_t secs)

点击查看...

通过UTC秒时间戳设置时间

void tpDateTime::setDate(const tpDate &date)

点击查看...

设置日期部分（保持时间不变）

void tpDateTime::setTime(const tpTime &time)

点击查看...

设置时间部分（保持日期不变）

tpString tpDateTime::toString(const tpString &format) const

点击查看...

格式化输出日期时间
返回值：格式化后的字符串

tpDateTime tpDateTime::addDays(int64_t days) const

点击查看...

增加指定天数
返回值：新日期时间对象

tpDateTime tpDateTime::addMonths(int32_t months) const

点击查看...

增加指定月数
返回值：新日期时间对象（自动调整月末日期）

tpDateTime tpDateTime::addYears(int32_t years) const

点击查看...

增加指定年数
返回值：新日期时间对象（自动处理闰年）

tpDateTime tpDateTime::addSecs(int64_t secs) const

点击查看...

增加指定秒数
返回值：新日期时间对象

tpDateTime tpDateTime::addMSecs(int64_t msecs) const

点击查看...

增加指定毫秒数
返回值：新日期时间对象

int64_t tpDateTime::daysTo(const tpDateTime &other) const

点击查看...

计算到目标日期的天数差
返回值：间隔天数（this早于other时为负）

int64_t tpDateTime::secsTo(const tpDateTime &other) const

点击查看...

计算到目标时间的秒数差
返回值：间隔秒数（this早于other时为负）

int64_t tpDateTime::msecsTo(const tpDateTime &other) const

点击查看...

计算到目标时间的毫秒数差
返回值：间隔毫秒数（this早于other时为负）

tpDateTime & tpDateTime::operator=(const tpDateTime &other) noexcept

暂无注释...

bool tpDateTime::operator==(const tpDateTime &other) const

暂无注释...

bool tpDateTime::operator<(const tpDateTime &other) const

暂无注释...

bool tpDateTime::operator!=(const tpDateTime &other) const

暂无注释...

bool tpDateTime::operator<=(const tpDateTime &other) const

暂无注释...

bool tpDateTime::operator>(const tpDateTime &other) const

暂无注释...

bool tpDateTime::operator>=(const tpDateTime &other) const

暂无注释...

static tpDateTime tpDateTime::currentDateTime()

点击查看...

获取当前系统日期时间（本地时区）
返回值：当前日期时间对象

static tpDateTime tpDateTime::fromString(const tpString &s, const tpString &format)

点击查看...

从格式字符串解析日期时间
参数：s 日期时间字符串，如 "2023-08-25 14:30:45.500"
参数：format 格式模板，支持：
-日期部分：yyyy(年), MM(月), dd(日)；
-时间部分：HH(时), mm(分), ss(秒), zzz(毫秒)
异常：std::invalid_argument: 格式不匹配时抛出
返回值：解析后的日期时间对象

static tpDateTime tpDateTime::fromMSecsSinceEpoch(int64_t msecs)

点击查看...

从毫秒时间戳创建对象（UTC时区）
返回值：对应UTC日期时间对象

static tpDateTime tpDateTime::fromSecsSinceEpoch(int64_t secs)

点击查看...

从秒时间戳创建对象（UTC时区）
返回值：对应UTC日期时间对象

static int64_t tpDateTime::currentMSecsSinceEpoch() noexcept

点击查看...

获取当前UTC毫秒时间戳
返回值：当前时刻的毫秒时间戳

static int64_t tpDateTime::currentSecsSinceEpoch() noexcept

点击查看...

获取当前UTC秒时间戳
返回值：当前时刻的秒时间戳