localtime()返回值异常：自定义tbDate转struct tm出现日期偏差

问题场景 #

需要将自定义struct tbDate转换为struct tm，由于直接赋值无法填充tm_wday、tm_yday等依赖字段（需配合自定义strftime()实现），因此先手动填充struct tm的基础字段，调用mktime()生成时间戳，再用localtime()解析时间戳获取完整struct tm覆盖原结构。但在Windows+MinGW环境下出现异常：输入date->year=2022、date->month=11、date->day=1时，mktime()得到时间戳1667253600，但localtime()返回的tmp中tm_mday=31、tm_mon=9（即10月31日），而非预期的11月1日。

原代码 #

int tbDate_to_tm(tbDate *date,struct tm *syst)
{
    time_t t;

    struct tm *tmp;
    syst->tm_hour=0;
    syst->tm_min=0;
    syst->tm_sec=0;
    syst->tm_year=date->year-1900;
    syst->tm_mon=date->month-1;
    syst->tm_mday=date->day;
    
    t=mktime(syst);
    tmp=localtime(&t);
    
    syst->tm_hour=tmp->tm_hour;
    syst->tm_isdst=tmp->tm_isdst;
    syst->tm_mday=tmp->tm_mday;
    syst->tm_min=tmp->tm_min;
    syst->tm_mon=tmp->tm_mon;
    syst->tm_sec=tmp->tm_sec;
    syst->tm_wday=tmp->tm_wday;
    syst->tm_yday=tmp->tm_yday;
    syst->tm_year=tmp->tm_year;


    return 1;
}

问题排查与解决 #

核心原因 #

1. 未初始化的struct tm字段干扰：原代码仅手动赋值部分字段，tm_isdst等字段为随机值，mktime()会根据该值判断夏令时状态，导致时间戳计算偏差。
2. 冗余的localtime()调用：mktime()本身会在计算时间戳后，自动填充tm_wday、tm_yday等字段，且会修正非法日期格式；额外调用localtime()会引入时区转换误差（Windows+MinGW下的时区处理逻辑易出现UTC与本地时间混淆）。

修正后的代码 #

#include <string.h> // 引入memset依赖

int tbDate_to_tm(tbDate *date, struct tm *syst)
{
    time_t t;

    // 先清零整个struct tm，避免未初始化字段的随机值干扰
    memset(syst, 0, sizeof(struct tm));
    
    // 填充基础日期时间字段
    syst->tm_hour = 0;
    syst->tm_min = 0;
    syst->tm_sec = 0;
    syst->tm_year = date->year - 1900;
    syst->tm_mon = date->month - 1;
    syst->tm_mday = date->day;
    syst->tm_isdst = -1; // 让mktime自动检测当前时区的夏令时状态
    
    // 计算时间戳，同时自动填充tm_wday、tm_yday等字段
    t = mktime(syst);
    if (t == -1) {
        // 处理非法日期（如2月30日）的异常情况
        return 0;
    }

    // mktime已完成所有字段的填充，无需再调用localtime
    return 1;
}

关键说明 #

• memset(syst, 0, sizeof(struct tm))：确保所有字段初始化为0，避免随机值影响mktime()的计算逻辑。
• syst->tm_isdst = -1：让mktime()自动检测当前时区是否处于夏令时，保证时间戳计算的准确性。
• 移除localtime()调用：直接使用mktime()修改后的syst结构，既避免了时区转换误差，又充分利用了mktime()自动填充扩展字段的特性。

内容的提问来源于stack exchange，提问作者San Pei