localtime()始终返回23:59与实际时间不符问题求助

问题现象 #

在ESP32开发板的PlatformIO/Arduino环境中，使用工具链版本12.2.0+20230208时，调用localtime()函数始终返回23:59，无论实际设置的系统时间是什么值；但切换到工具链8.4.0版本时，代码运行正常。

串口输出示例：

System time set to 04:20
Updated time (read using localtime()): 23:59

根因分析 #

问题出在struct tm结构体的初始化不完整：原代码只设置了tm_hour和tm_min字段，其余字段（如tm_year、tm_mon、tm_mday等）未初始化，内存中是随机值。

• 旧版本工具链（8.4.0）的mktime()函数对未初始化的字段有容错处理，能生成合理的时间戳；
• 新版本工具链（12.2.0）的mktime()对tm结构体的完整性要求更严格，未初始化的关键字段会导致生成错误的时间戳（通常对应Unix纪元前的1969-12-31 23:59），最终让localtime()解析出错误的时间。

解决方案 #

必须完整初始化struct tm的所有必要字段，至少包括：

• tm_year：从1900年起的年份偏移（例如2024年就设为2024-1900=124）
• tm_mon：月份，范围0-11（1月为0，12月为11）
• tm_mday：日期，范围1-31
• tm_hour、tm_min、tm_sec：时分秒
• tm_isdst：设为-1，让系统自动判断是否启用夏令时

修正后的代码 #

#include <Arduino.h>
#include <stdio.h>
#include <time.h>
#include <sys/time.h>

void setup()
{
    Serial.begin(115200);
    delay(100); // 等待串口初始化完成

    // 完整初始化tm结构体，避免未定义行为
    struct tm localTime = {0}; // 先清零所有字段
    localTime.tm_year = 2024 - 1900; // 年份：2024年对应124
    localTime.tm_mon = 4; // 5月（0代表1月）
    localTime.tm_mday = 15; // 15日
    localTime.tm_hour = 4;
    localTime.tm_min = 20;
    localTime.tm_sec = 0;
    localTime.tm_isdst = -1; // 自动处理夏令时

    // 转换为时间戳并设置系统时间
    time_t timestamp = mktime(&localTime);
    struct timeval newTime = {.tv_sec = timestamp, .tv_usec = 0};
    
    if (settimeofday(&newTime, NULL) == 0) {
        printf("System time set to 04:20\n");

        // 读取并打印更新后的时间
        struct tm* updatedLocalTime = localtime(&timestamp);
        printf("Updated time (read using localtime()): %02d:%02d\n", 
               updatedLocalTime->tm_hour, updatedLocalTime->tm_min);
    } else {
        perror("Error setting system time");
    }
}

void loop() {}

验证效果 #

修正后，localtime()将正确返回设置的时间，串口输出会显示：

System time set to 04:20
Updated time (read using localtime()): 04:20

内容的提问来源于stack exchange，提问作者Mahyar Shokraeian