信息发布→ 登录 注册 退出

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

发布时间:2025-11-28

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

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

time_t 与 tm 的基本概念

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

tm 是一个结构体,定义在 头文件中,用于表示分解后的时间(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 结构体的指针。

示例代码:

#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; // 2025年(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++时间操作需求。

标签:# 转换为  # 详细介绍  # 这样做  # 请使用  # 它是  # 几天  # 判断是否  # 的是  # 年中  # 是一个  # c++  # linux  # windows  # 多线程  # 线程  # 指针  # 结构体  # 整型  # 格式化输出  # unix  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!