C++ 日期 & 时间（建议收藏）

C++ 日期 & 时间：从入门到实用

在日常开发中，我们经常需要处理时间相关的逻辑：记录日志时间、计算任务耗时、格式化显示日期、判断时间区间等。这些功能在 C++ 中虽然不像 Python 那样“开箱即用”，但只要掌握核心库和常用方法，就能轻松应对。本文将带你系统掌握 C++ 日期 & 时间 的核心用法，从基础结构到实用场景，一步步构建你的时间处理能力。

时间基础：time_t 与 struct tm

C++ 中处理时间的核心类型有两个：time_t 和 struct tm。你可以把它们理解为“时间的两个视角”——time_t 是时间的“数字表示”，struct tm 是时间的“结构化拆解”。

time_t 是一个整数类型，通常表示从 1970 年 1 月 1 日 00:00:00 UTC（也叫 Unix 时间戳）开始经过的秒数。它就像一把“秒表”，从某个起点开始累计时间。

#include <iostream>
#include <ctime>

int main() {
    // 获取当前时间戳（以秒为单位）
    time_t now = time(nullptr);  // nullptr 表示当前时间

    // 输出时间戳
    std::cout << "当前时间戳: " << now << std::endl;

    return 0;
}

运行这段代码，你会看到类似 1715000000 的数字，这就是从 Unix 起点到现在的总秒数。它虽然能精确表示时间，但人类看不懂，所以需要转换。

struct tm 就是用来把 time_t 拆解成年、月、日、时、分、秒等字段的结构体。它就像是一个“时间拼图”，把时间拆成一个个小块，方便我们读取和操作。

#include <iostream>
#include <ctime>

int main() {
    time_t now = time(nullptr);  // 获取当前时间戳

    // 将 time_t 转换为 struct tm（本地时间）
    struct tm *local_time = localtime(&now);

    // 输出各个字段
    std::cout << "年: " << (local_time->tm_year + 1900) << std::endl;  // tm_year 是从 1900 开始的
    std::cout << "月: " << (local_time->tm_mon + 1) << std::endl;     // tm_mon 是从 0 开始的
    std::cout << "日: " << local_time->tm_mday << std::endl;
    std::cout << "时: " << local_time->tm_hour << std::endl;
    std::cout << "分: " << local_time->tm_min << std::endl;
    std::cout << "秒: " << local_time->tm_sec << std::endl;

    return 0;
}

⚠️ 注意：tm_year 是从 1900 开始的，所以要加 1900；tm_mon 是从 0 开始的，所以要加 1。

日期格式化输出：strftime 的魔法

有了 struct tm，我们就可以按自己的格式输出时间了。strftime 函数就是实现这个功能的“格式化大师”。它支持多种占位符，让你像拼图一样组合出想要的格式。

#include <iostream>
#include <ctime>

int main() {
    time_t now = time(nullptr);
    struct tm *local_time = localtime(&now);

    char buffer[128];  // 存放格式化后的字符串

    // 使用 strftime 格式化时间
    // %Y-%m-%d %H:%M:%S 表示 2024-05-15 14:30:45
    strftime(buffer, sizeof(buffer), "%Y-%m-%d %H:%M:%S", local_time);

    std::cout << "格式化时间: " << buffer << std::endl;

    return 0;
}

💡 提示：sizeof(buffer) 是为了防止缓冲区溢出，安全编程的重要习惯。

时间差计算：两个时间点的“距离”

在程序中，我们常需要计算两个时间之间的间隔。比如：任务执行耗时、用户登录间隔等。这可以通过 time_t 的减法实现。

#include <iostream>
#include <ctime>

int main() {
    time_t start = time(nullptr);  // 记录开始时间

    // 模拟一段耗时操作（这里用 sleep 代替）
    // 注意：sleep 在 Windows 上是 _sleep(1000)，Linux 是 sleep(1)
    // 为跨平台兼容，可使用系统函数或条件编译
    #ifdef _WIN32
        Sleep(1000);  // Windows 下 1 秒
    #else
        sleep(1);     // Linux/macOS 下 1 秒
    #endif

    time_t end = time(nullptr);  // 记录结束时间

    // 计算时间差（秒）
    double elapsed = difftime(end, start);

    std::cout << "耗时: " << elapsed << " 秒" << std::endl;

    return 0;
}

difftime 函数专门用于计算两个 time_t 值之间的差值，返回类型是 double，可以精确到秒的小数部分。

日期操作：增加/减少时间

有时我们需要对某个时间进行加减操作，比如“三天后”、“两小时前”。struct tm 本身不支持直接加减，但我们可以手动修改字段，再用 mktime 重新合成 time_t。

#include <iostream>
#include <ctime>

int main() {
    time_t now = time(nullptr);
    struct tm *local_time = localtime(&now);

    // 修改时间：加 3 天
    local_time->tm_mday += 3;

    // 重新计算 time_t，自动处理进位（如 30 天加 3 天变成下个月）
    time_t new_time = mktime(local_time);

    // 格式化输出新时间
    char buffer[128];
    strftime(buffer, sizeof(buffer), "%Y-%m-%d %H:%M:%S", localtime(&new_time));

    std::cout << "三天后的时间: " << buffer << std::endl;

    return 0;
}

mktime 的神奇之处在于它能自动处理进位和借位。比如当 tm_mday 超过该月最大天数时，它会自动进位到下个月，甚至下一年。这就像“时间计算器”会自动修正错误。

实战案例：日志时间记录

现在我们来做一个完整的实战项目：实现一个简单的日志记录功能，自动记录每条日志的生成时间。

#include <iostream>
#include <fstream>
#include <ctime>
#include <string>

class Logger {
public:
    Logger(const std::string& filename) : log_file(filename) {}

    void log(const std::string& message) {
        time_t now = time(nullptr);
        struct tm *local_time = localtime(&now);

        char time_str[64];
        strftime(time_str, sizeof(time_str), "%Y-%m-%d %H:%M:%S", local_time);

        std::string log_entry = "[" + std::string(time_str) + "] " + message + "\n";

        // 写入文件
        std::ofstream file(log_file, std::ios::app);
        if (file.is_open()) {
            file << log_entry;
            file.close();
        } else {
            std::cerr << "无法打开日志文件: " << log_file << std::endl;
        }
    }

private:
    std::string log_file;
};

int main() {
    Logger logger("app.log");

    logger.log("程序启动成功");
    logger.log("用户登录成功");
    logger.log("任务执行完成");

    std::cout << "日志已记录到 app.log" << std::endl;

    return 0;
}

这个例子展示了 C++ 日期 & 时间 在实际项目中的典型应用：时间戳生成、格式化输出、文件写入。它结构清晰，可复用，是开发中非常实用的模式。

总结与建议

通过本文的学习，你应该已经掌握了 C++ 中处理日期与时间的核心技能：从 time_t 和 struct tm 的基本概念，到 strftime 格式化输出，再到时间差计算和日期操作。这些知识是构建可靠、可维护程序的重要基础。

在实际开发中，建议你：

• 优先使用 localtime 和 mktime 处理本地时间
• 使用 strftime 保证输出格式统一
• 避免手动计算时间，优先使用标准库函数
• 考虑跨平台兼容性，如 sleep 的系统差异

掌握这些技巧后，你就能在项目中自信地处理各种时间相关需求。无论是日志、定时任务，还是用户行为分析，C++ 日期 & 时间 都会成为你得力的工具。

最后提醒：时间是程序中最容易出错的部分之一。一个小小的时区问题，可能就会导致系统崩溃或数据错误。所以，务必重视时间处理的准确性与健壮性。