time_t是自1970年起的秒数,tm是包含年月日时分秒的结构体;通过localtime可将time_t转为tm,mktime则将tm转为time_t,二者结合实现时间格式转换与处理。

在C++中处理时间时,time_t 和 tm 结构体是两个核心类型。它们分别表示不同的时间格式,常用于获取系统时间、格式化输出或进行时间计算。本文详细介绍它们之间的转换方法,重点讲解 localtime 与 mktime 的用法。
time_t 与 tm 的基本概念
time_t 是一个算术类型,通常表示自1970年1月1日00:00:00 UTC以来的秒数(即Unix时间戳),它是一个整型值,便于存储和计算。
tm 是一个结构体,定义在
struct tm {
int tm_sec; // 秒 [0-61]
int tm_min; // 分 [0-59]
int tm_hour; // 时 [0-23]
int tm_mday; // 日 [1-31]
int tm_mon; // 月 [0-11]
int tm_year; // 年(从1900年起)
int tm_wday; // 周几 [0-6],周日为0
int tm_yday; // 一年中的第几天 [0-365]
int tm_isdst; // 是否夏令时(>0:是,0:否,<0:未知)
};
将 time_t 转换为 tm:localtime 函数
使用 localtime 可以将 time_t 转换为本地时区的 tm 结构体。该函数接受 time_t 类型的指针,并返回指向静态分配的 tm 结构体的指针。
立即学习“C++免费学习笔记(深入)”;
示例代码:
#include#include int main() { time_t raw_time; time(&raw_time); // 获取当前时间戳
struct tm* local_tm = localtime(&raw_time); if (local_tm != nullptr) { std::cout << "当前本地时间: "; std::cout << local_tm->tm_year + 1900 << "-"; std::cout << local_tm->tm_mon + 1 << "-"; std::cout << local_tm->tm_mday << " "; std::cout << local_tm->tm_hour << ":"; std::cout << local_tm->tm_min << ":"; std::cout << local_tm->tm_sec << "\n"; } return 0;}
注意: localtime 返回的是静态缓冲区地址,不可多线程共享使用。若需线程安全,请使用 localtime_s(Windows)或 localtime_r(Linux)。
将 tm 转换为 time_t:mktime 函数
mktime 用于将 tm 结构体转换回 time_t 时间戳,同时会自动修正不合法的输入值(如 tm_mday=32),并填充其余字段(如星期几、一年中的天数)。
常见用途包括:构造特定时间、计算时间差、验证日期合法性。
示例:构造一个指定日期的时间戳
#include#include int main() { struct tm input_tm = {}; input_tm.tm_year = 124124; // 2024年(1900起) input_tm.tm_mon = 5; // 6月(从0开始) input_tm.tm_mday = 15; // 15日 input_tm.tm_hour = 10; input_tm.tm_min = 30; input_tm.tm_sec = 0; input_tm.tm_isdst = -1; // 让系统判断是否夏令时
time_t timestamp = mktime(&input_tm); if (timestamp != -1) { std::cout << "对应的时间戳为: " << timestamp << "\n"; // 再转回本地时间验证 struct tm* result = localtime(×tamp); std::cout << "转换后时间: " << result->tm_year + 1900 << "-" << result->tm_mon + 1 << "-" << result->tm_mday << "\n"; } else { std::cout << "无效时间,无法转换。\n"; } return 0;}
说明: 设置 tm_isdst 为 -1 表示由系统根据日期自动判断是否启用夏令时,推荐这样做。
UTC 时间支持:gmtime 与 timegm
如果需要处理UTC时间而非本地时间:
- gmtime:将 time_t 转换为UTC时区的 tm 结构体。
- timegm(非标准,Linux有;Windows可用 _mkgmtime):将 tm 按UTC解析为 time_t。
示例:
struct tm* utc_tm = gmtime(&raw_time);
if (utc_tm) {
std::cout << "UTC时间: "
<< utc_tm->tm_year + 1900 << "-"
<< utc_tm->tm_mon + 1 << "-" << utc_tm->tm_mday << "\n";
}
基本上就这些。掌握 time_t 与 tm 的相互转换,结合 localtime、mktime 等函数,可以灵活处理大多数C++时间操作需求。










