GPS时间字符串转epoch异常：Debian正常ESP32（ESP-IDF）结果错误求助

我编写了一段代码，将GPS卫星发送的datetime字符串解析为struct tm结构体，再通过mktime()函数生成epoch时间戳。该代码在Debian机器上运行结果正确，但在搭载ESP-IDF的ESP32上结果错误，想请教可能的原因，是否与时区（timezone）或夏令时（DST）相关？

错误代码 #

#include "rs_time.h"

time_t time_from_gnss_info_time(const char * datetime_str){
    time_t epoch;
    struct tm tm;
    sscanf(
        datetime_str,
        "%4d%2d%2d%2d%2d%2d",
        &tm.tm_year,
        &tm.tm_mon,
        &tm.tm_mday,
        &tm.tm_hour,
        &tm.tm_min,
        &tm.tm_sec
    );
    epoch = mktime(&tm); // result is '1462765068' or Mon May  9 03:37:48 2016
    printf("the date and time is: %s %ld ",ctime(&epoch), time(NULL));
    return epoch;
}

错误现象 #

当datetime_str为'20210913221332'时，生成的epoch值为1462765068，对应的ctime输出为Mon May 9 03:37:48 2016。

问题原因分析 #

• struct tm字段格式错误
  • tm_year要求是年份与1900的差值，比如2021年应赋值为2021-1900=121，你直接传入4位年份2021，会被识别为1900+2021=3921年。
  • tm_mon的取值范围是0（1月）到11（12月），你直接传入月份数字9（对应9月），会被识别为10月，导致时间偏移。
• 未初始化struct tm的其他字段
  局部变量struct tm tm存储在栈上，未赋值的字段（如tm_isdst、tm_yday、tm_wday）会是随机值。Debian的glibc会自动为这些字段设置合理默认值，但ESP-IDF使用的newlibc不会，随机的tm_isdst值会彻底打乱mktime()的计算逻辑，生成完全错误的时间戳。
• 时区配置差异
  GPS输出的是UTC时间，但mktime()默认会将struct tm视为本地时间处理。如果ESP32的时区配置与Debian不一致，也会导致时间戳转换偏差。

修正后的代码 #

#include "rs_time.h"
#include <time.h>

time_t time_from_gnss_info_time(const char * datetime_str){
    time_t epoch;
    struct tm tm = {0}; // 初始化所有字段为0，避免未定义行为
    int year, mon, day, hour, min, sec;
    
    // 先解析到临时变量，再转换为struct tm要求的格式
    sscanf(
        datetime_str,
        "%4d%2d%2d%2d%2d%2d",
        &year,
        &mon,
        &day,
        &hour,
        &min,
        &sec
    );
    
    tm.tm_year = year - 1900;
    tm.tm_mon = mon - 1;
    tm.tm_mday = day;
    tm.tm_hour = hour;
    tm.tm_min = min;
    tm.tm_sec = sec;
    tm.tm_isdst = -1; // 让系统自动判断夏令时
    
    epoch = mktime(&tm);
    printf("the date and time is: %s %ld ",ctime(&epoch), time(NULL));
    return epoch;
}

额外说明 #

如果GPS时间是UTC，且需要生成UTC的epoch时间戳，可以尝试使用timegm()（newlibc支持该函数），它会直接将struct tm视为UTC时间处理，无需考虑本地时区配置。

内容的提问来源于stack exchange，提问作者Ahmad Mansoori