如何在C++11中模拟localtime返回值进行单元测试且不修改系统时间

当然可以！完全不用改动系统时间就能实现你的单元测试需求，下面给你几种实用的方案，都是适配C++11环境的：

1. 依赖注入（最推荐，代码侵入性低且易维护） #

核心思路是把获取时间的逻辑抽象出来，让业务代码不直接硬调用localtime，而是通过一个可替换的接口来获取时间。这样测试时就能轻松传入我们自定义的mock实现，生产环境用真实的localtime即可。

举个具体的例子：

业务代码 #

#include <ctime>
#include <string>

// 定义时间获取函数的类型别名
using TimeGetter = std::tm*(*)(const time_t*);

std::string checkBirthday(int birthMonth, int birthDay, TimeGetter getTime = localtime) {
    time_t now = time(nullptr);
    std::tm* currentTime = getTime(&now);
    // 注意tm_mon是从0开始计数的，所以要加1
    if (currentTime->tm_mon + 1 == birthMonth && currentTime->tm_mday == birthDay) {
        return "Happy Birthday!";
    }
    return "Just a normal day.";
}

测试代码（以Google Test为例） #

#include <gtest/gtest.h>

// 返回生日当天的mock时间
std::tm* mockLocaltimeBirthday(const time_t*) {
    static std::tm mockTime{};
    mockTime.tm_mon = 9; // 对应10月（tm_mon从0开始）
    mockTime.tm_mday = 5;
    return &mockTime;
}

// 返回普通日期的mock时间
std::tm* mockLocaltimeNormal(const time_t*) {
    static std::tm mockTime{};
    mockTime.tm_mon = 0; // 对应1月
    mockTime.tm_mday = 1;
    return &mockTime;
}

TEST(BirthdayTest, ReturnsGreetingOnBirthday) {
    EXPECT_EQ(checkBirthday(10, 5, mockLocaltimeBirthday), "Happy Birthday!");
}

TEST(BirthdayTest, ReturnsNormalMessageOnNonBirthday) {
    EXPECT_EQ(checkBirthday(10, 5, mockLocaltimeNormal), "Just a normal day.");
}

这种方法完全符合开闭原则，测试逻辑和业务逻辑分离，后续维护也很方便。

2. 包装localtime并使用条件编译 #

如果不想改动业务代码的函数签名，可以自己写一个localtime的包装函数，通过条件编译在生产和测试环境切换实现。

头文件（time_wrapper.h） #

#pragma once
#include <ctime>

// 测试模式下使用自定义的my_localtime，生产模式直接映射到标准库的localtime
#ifdef TEST_MODE
std::tm* my_localtime(const time_t* timer);
#else
#define my_localtime localtime
#endif

测试环境实现（time_wrapper.cpp） #

#define TEST_MODE
#include "time_wrapper.h"

static std::tm mockTime{};

std::tm* my_localtime(const time_t*) {
    return &mockTime;
}

// 提供设置mock时间的接口
void setMockTime(int month, int day) {
    mockTime.tm_mon = month - 1; // 转换为tm_mon的0起始格式
    mockTime.tm_mday = day;
}

然后业务代码里把所有localtime替换成my_localtime，测试时编译时定义TEST_MODE，调用setMockTime就能自由设置想要的日期了。

3. 链接器拦截（适合不想修改业务代码的场景） #

如果你的项目是遗留系统，不想改动任何业务代码，可以利用链接器的符号优先级特性，在测试程序里实现一个和localtime同名的函数，让链接器优先使用我们的mock版本。

注意这个方法是平台相关的，下面是Linux下GCC/Clang的实现示例：

#include <ctime>
#include <cstdlib>

static std::tm mockTime{};

// 用extern "C"保证函数符号是C风格的，和标准库的localtime匹配
extern "C" std::tm* localtime(const time_t*) {
    return &mockTime;
}

// 测试时用来设置mock时间的函数
void setTestTime(int month, int day) {
    mockTime.tm_mon = month - 1;
    mockTime.tm_mday = day;
}

编译测试程序时把这个文件和测试代码一起编译，链接器就会优先选用我们实现的localtime，而不是标准库的版本。这种方法完全不需要修改业务代码，但缺点是跨平台性差，Windows下需要用不同的技巧（比如函数钩子）。

额外注意事项 #

• localtime本身是线程不安全的，因为它返回的是静态内存的指针。如果你的代码是多线程的，测试时要把mock的std::tm改成线程局部存储的（比如用thread_local修饰），避免线程间干扰。
• 如果你后续有机会重构代码，建议考虑使用C++11引入的<chrono>库，它的设计更现代，也更容易进行测试和时间模拟。

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