如何将Epoch秒数字符串安全转换为time_t及可读时间？

我有一个表示Epoch以来秒数的字符串，需要将其转换为人类可读的时间字符串。网上有些帖子建议直接把整数强制转换为time_t，代码如下：

time_t time = (time_t)(atoi(secs_since_epoch_str));

但查阅time_t的定义可知：

typedef /* unspecified */ time_t;

Although not defined by the C standard, this is almost always an integral
value holding the number of seconds (not counting leap seconds) since 00:00,
Jan 1 1970 UTC, corresponding to POSIX time.

这种方法并不保证有效，想知道有没有规范的实现方式？

规范实现方案 #

1. 安全解析字符串 #

别用atoi——它不处理溢出问题。改用strtoll（C99及以上标准支持）解析字符串，能检测溢出、无效字符等异常情况，返回的long long类型也能覆盖更大的数值范围：

#include <stdlib.h>
#include <errno.h>

char *endptr;
errno = 0;
long long secs = strtoll(secs_since_epoch_str, &endptr, 10);

// 校验解析结果
if (errno != 0 || *endptr != '\0' || secs_since_epoch_str == endptr) {
    // 处理错误：溢出、无效字符、空字符串
    fprintf(stderr, "无效的Epoch秒数字符串\n");
    return -1;
}

2. 安全转换为time_t #

由于time_t的类型未被C标准明确规定（可能是32/64位有符号整数，甚至其他类型），必须做范围检查避免转换失败：

#include <stdint.h>
#include <time.h>

time_t epoch_time;

#if defined(_POSIX_VERSION)
    // POSIX系统中time_t是有符号整数，用TIME_MIN/TIME_MAX做范围校验
    if (secs < (long long)TIME_MIN || secs > (long long)TIME_MAX) {
        fprintf(stderr, "Epoch秒数超出time_t范围\n");
        return -1;
    }
    epoch_time = (time_t)secs;
#else
    // 非POSIX系统，通过反向转换校验是否安全
    if ((time_t)secs != secs) {
        fprintf(stderr, "无法将秒数转换为time_t类型\n");
        return -1;
    }
    epoch_time = (time_t)secs;
#endif

3. 格式化为可读时间 #

用localtime（转换为本地时间）或gmtime（转换为UTC时间）将time_t转为struct tm，再通过strftime生成自定义格式的可读字符串：

#include <stdio.h>
#include <time.h>

struct tm *tm_info = localtime(&epoch_time);
if (tm_info == NULL) {
    fprintf(stderr, "转换为本地时间失败\n");
    return -1;
}

char time_str[256];
// 自定义格式，比如YYYY-MM-DD HH:MM:SS
if (strftime(time_str, sizeof(time_str), "%Y-%m-%d %H:%M:%S", tm_info) == 0) {
    fprintf(stderr, "格式化时间字符串失败\n");
    return -1;
}

printf("可读时间：%s\n", time_str);

完整可运行代码 #

#include <stdio.h>
#include <stdlib.h>
#include <errno.h>
#include <stdint.h>
#include <time.h>

int main(int argc, char *argv[]) {
    if (argc != 2) {
        fprintf(stderr, "用法：%s <epoch_seconds_string>\n", argv[0]);
        return 1;
    }

    char *secs_str = argv[1];
    char *endptr;
    errno = 0;
    long long secs = strtoll(secs_str, &endptr, 10);

    // 解析校验
    if (errno != 0 || *endptr != '\0' || secs_str == endptr) {
        fprintf(stderr, "错误：无效的Epoch秒数字符串\n");
        return 1;
    }

    // 转换time_t校验
    time_t epoch_time;
#if defined(_POSIX_VERSION)
    if (secs < (long long)TIME_MIN || secs > (long long)TIME_MAX) {
        fprintf(stderr, "错误：Epoch秒数超出time_t范围\n");
        return 1;
    }
    epoch_time = (time_t)secs;
#else
    if ((time_t)secs != secs) {
        fprintf(stderr, "错误：无法将秒数转换为time_t类型\n");
        return 1;
    }
    epoch_time = (time_t)secs;
#endif

    // 转为可读时间
    struct tm *tm_info = localtime(&epoch_time);
    if (tm_info == NULL) {
        fprintf(stderr, "错误：转换为本地时间失败\n");
        return 1;
    }

    char time_buf[256];
    if (strftime(time_buf, sizeof(time_buf), "%Y-%m-%d %H:%M:%S %Z", tm_info) == 0) {
        fprintf(stderr, "错误：格式化时间字符串失败\n");
        return 1;
    }

    printf("转换后的时间：%s\n", time_buf);
    return 0;
}

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