C++ time_t与tm结构体转换_C++ mktime与localtime用法详解-C++-PHP中文网

C++ time_t与tm结构体转换_C++ mktime与localtime用法详解

尼克

发布： 2025-11-28 08:39:06

原创

938人浏览过

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

c++ time_t与tm结构体转换_c++ mktime与localtime用法详解

在C++中处理时间时，time_t 和 tm 结构体是两个核心类型。它们分别表示不同的时间格式，常用于获取系统时间、格式化输出或进行时间计算。本文详细介绍它们之间的转换方法，重点讲解 localtime 与 mktime 的用法。

time_t 与 tm 的基本概念

time_t 是一个算术类型，通常表示自1970年1月1日00:00:00 UTC以来的秒数（即Unix时间戳），它是一个整型值，便于存储和计算。

tm 是一个结构体，定义在 <ctime> 头文件中，用于表示分解后的时间（broken-down time），包含年、月、日、时、分、秒等字段：

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 <iostream>
#include <ctime>
<p>int main() {
time_t raw_time;
time(&raw_time); // 获取当前时间戳</p><pre class='brush:php;toolbar:false;'>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），并填充其余字段（如星期几、一年中的天数）。

uBrand Logo生成器

uBrand Logo生成器是一款强大的AI智能LOGO设计工具。

124

查看详情

常见用途包括：构造特定时间、计算时间差、验证日期合法性。

示例：构造一个指定日期的时间戳

#include <iostream>
#include <ctime>
<p>int main() {
struct tm input_tm = {};
input_tm.tm_year = 124; // 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; // 让系统判断是否夏令时</p><pre class='brush:php;toolbar:false;'>time_t timestamp = mktime(&input_tm);
if (timestamp != -1) {
    std::cout << "对应的时间戳为: " << timestamp << "\n";

    // 再转回本地时间验证
    struct tm* result = localtime(&timestamp);
    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++时间操作需求。

以上就是C++ time_t与tm结构体转换_C++ mktime与localtime用法详解的详细内容，更多请关注php中文网其它相关文章！