mktime不能直接解析字符串,仅将已填充的struct tm转为时间戳;需先用strptime(Linux/macOS)或sscanf(Windows)解析字符串并正确设置tm_year、tm_mon等字段,再调用mktime。

直接说结论:mktime 不能直接把字符串转时间戳,它只接受 struct tm;必须先用 strptime(Linux/macOS)或手动解析(Windows)把字符串填进 struct tm,再调 mktime 转成 time_t。
为什么不能直接用 mktime 解析字符串?
mktime 的签名是 time_t mktime(struct tm *timeptr),它只做“本地时间结构体 → 时间戳”的转换,不带解析能力。传入的 struct tm 必须已由你填充好年月日时分秒——否则行为未定义(常见结果是返回 -1 或随机值)。
常见错误写法:
struct tm t = {0};
time_t ts = mktime(&t); // 全零 → 解释为 1900-01-01 00:00:00 → 实际返回约 -2208988800,不是你想要的
strptime 是最常用的字符串解析入口(Linux/macOS)
strptime 把字符串按格式写入 struct tm,是 mktime 的前置必要步骤。注意它不设初值,必须提前清零结构体。
立即学习“C++免费学习笔记(深入)”;
-
strptime第二个参数是格式串,比如"%Y-%m-%d %H:%M:%S"对应"2024-05-20 14:30:45" - 它只修改匹配的字段,未匹配的字段保持原值(所以
memset(&t, 0, sizeof(t))很关键) - 返回值为
nullptr表示解析失败,别忽略检查
示例:
struct tm t = {0};
const char* s = "2024-05-20 14:30:45";
if (strptime(s, "%Y-%m-%d %H:%M:%S", &t) != nullptr) {
time_t ts = mktime(&t); // 此时 ts 才是有效时间戳
}Windows 下没有 strptime,得手动拆或用 sscanf
MSVC 不提供 strptime,常见替代方式是用 sscanf 填充 struct tm 字段,但要注意:
-
tm_year是从 1900 开始的偏移量(如 2024 → 填 124),tm_mon是 0 起始(1 月 → 填 0) -
tm_isdst建议设为 -1,让mktime自动判断夏令时 - 务必检查
sscanf返回值,确保所有字段成功读取
示例:
struct tm t = {0};
int y, m, d, H, M, S;
const char* s = "2024-05-20 14:30:45";
if (sscanf(s, "%d-%d-%d %d:%d:%d", &y, &m, &d, &H, &M, &S) == 6) {
t.tm_year = y - 1900;
t.tm_mon = m - 1; // 月份从 0 开始
t.tm_mday = d;
t.tm_hour = H;
t.tm_min = M;
t.tm_sec = S;
t.tm_isdst = -1; // 让 mktime 推断 DST
time_t ts = mktime(&t);
}时区和 mktime 的隐含行为
mktime 总是把输入的 struct tm 当作**本地时区**时间处理,并转为 UTC 时间戳(time_t 本质是自 1970-01-01 UTC 起的秒数)。如果你的字符串本意是 UTC 时间,却用 mktime 直接转,结果会偏移本地时区差(比如东八区偏 +28800 秒)。
正确做法:
- 字符串是本地时间 → 用
mktime(默认行为) - 字符串是 UTC 时间 → 用
timegm(POSIX,Linux/macOS)或手动调整(Windows 需用_mkgmtime) - 跨平台项目建议封装一层,避免混用
mktime/timegm导致时区错乱
容易被忽略的一点:即使你设置了 t.tm_gmtoff 或 t.tm_zone,mktime 也完全忽略它们——它只认 tm_isdst 和本地时区环境。











