C++ 中的星期几表示与计算方法

在日常开发中，我们经常需要处理日期和时间相关的逻辑，其中最常见的一项就是根据给定的日期计算出对应的星期几。C++ 提供了多种方式来实现这一功能，本文将详细介绍如何在 C++ 中表示和计算星期几，并通过代码示例帮助读者快速掌握相关技巧。

一、C++ 中的日期表示基础

在 C++ 标准库中，<ctime> 头文件提供了 struct tm 结构体，用于表示日期和时间信息。该结构体包含以下成员：

struct tm {
    int tm_sec;   // 秒 (0-59)
    int tm_min;   // 分钟 (0-59)
    int tm_hour;  // 小时 (0-23)
    int tm_mday;  // 月份中的第几天 (1-31)
    int tm_mon;   // 月份 (0-11，0 表示一月)
    int tm_year;  // 自 1900 年以来的年数
    int tm_wday;  // 星期几 (0-6，0 表示星期日)
    int tm_yday;  // 一年中的第几天 (0-365)
    int tm_isdst; // 夏令时标志
};

其中，tm_wday 成员直接表示星期几，0 对应星期日，1 对应星期一，以此类推。

二、从日期计算星期几的方法

方法一：使用 mktime 函数自动计算

mktime 是 <ctime> 库中的一个函数，可以将 struct tm 结构体转换为时间戳（秒数），同时会自动填充 tm_wday 成员。这种方法简单且高效。

#include <iostream>
#include <ctime>

int main() {
    // 创建一个 struct tm 结构体并设置日期
    struct tm date = {};
    date.tm_year = 2023 - 1900; // 年份需减去 1900
    date.tm_mon = 4 - 1;        // 月份从 0 开始计数
    date.tm_mday = 15;          // 日期

    // 使用 mktime 计算星期几
    mktime(&date);

    // 输出结果
    std::cout << "2023年5月15日是星期" 
              << (date.tm_wday == 0 ? "日" : 
                  date.tm_wday == 1 ? "一" :
                  date.tm_wday == 2 ? "二" :
                  date.tm_wday == 3 ? "三" :
                  date.tm_wday == 4 ? "四" :
                  date.tm_wday == 5 ? "五" : "六")
              << std::endl;

    return 0;
}

运行上述代码，输出结果为：

2023年5月15日是星期一

方法二：手动计算星期几

如果需要更灵活地控制计算过程，可以使用 Zeller 公式手动计算星期几。Zeller 公式适用于公历日期，公式如下：

$$ h = \left(q + \left\lfloor\frac{13(m+1)}{5}\right\rfloor + K + \left\lfloor\frac{K}{4}\right\rfloor + \left\lfloor\frac{J}{4}\right\rfloor + 5J\right) \mod 7 $$

其中：

• $ h $ 是星期几（0=星期六，1=星期日，2=星期一，...，6=星期五）
• $ q $ 是日期中的天数
• $ m $ 是月份（3=三月，4=四月，...，14=二月）
• 如果月份是 1 或 2，则年份 $ Y $ 需要减 1
• $ K $ 是年份的后两位
• $ J $ 是年份的前两位

以下是实现代码：

#include <iostream>

// 手动计算星期几的函数
int getWeekday(int year, int month, int day) {
    if (month < 3) {
        month += 12;
        year -= 1;
    }

    int K = year % 100;
    int J = year / 100;

    // Zeller 公式
    int h = (day + (13 * (month + 1)) / 5 + K + K / 4 + J / 4 + 5 * J) % 7;

    // 调整 Zeller 公式的返回值范围
    return (h + 5) % 7; // 0=星期六，1=星期日，...，6=星期五
}

int main() {
    int year = 2023, month = 5, day = 15;
    int weekday = getWeekday(year, month, day);

    // 输出结果
    std::cout << year << "年" << month << "月" << day << "日是星期"
              << (weekday == 0 ? "六" :
                  weekday == 1 ? "日" :
                  weekday == 2 ? "一" :
                  weekday == 3 ? "二" :
                  weekday == 4 ? "三" :
                  weekday == 5 ? "四" : "五")
              << std::endl;

    return 0;
}

运行结果与之前一致：

2023年5月15日是星期一

三、扩展应用：获取当前日期的星期几

除了计算特定日期的星期几外，我们还可以轻松获取当前日期的星期几。以下是实现代码：

#include <iostream>
#include <ctime>

int main() {
    // 获取当前时间
    time_t now = time(0);
    struct tm *localTime = localtime(&now);

    // 输出当前日期和星期几
    std::cout << "当前日期：" << 1900 + localTime->tm_year << "年"
              << 1 + localTime->tm_mon << "月"
              << localTime->tm_mday << "日"
              << std::endl;

    std::cout << "当前星期：" 
              << (localTime->tm_wday == 0 ? "日" :
                  localTime->tm_wday == 1 ? "一" :
                  localTime->tm_wday == 2 ? "二" :
                  localTime->tm_wday == 3 ? "三" :
                  localTime->tm_wday == 4 ? "四" :
                  localTime->tm_wday == 5 ? "五" : "六")
              << std::endl;

    return 0;
}

运行结果可能类似于：

当前日期：2023年5月15日
当前星期：一

四、注意事项与优化建议

1. 月份索引问题：在使用 struct tm 时，月份从 0 开始计数（0 表示一月），这是许多开发者容易混淆的地方。务必注意这一点。

2. 夏令时影响：mktime 函数会考虑夏令时的影响，因此在某些情况下可能会导致日期偏移。如果不需要考虑夏令时，可以手动设置 tm_isdst 为 0。

3. 性能优化：对于频繁调用的日期计算场景，可以缓存常用日期的星期几结果，避免重复计算。

4. 国际化支持：如果需要支持多语言显示星期几，可以使用标准库中的 std::locale 功能，或者自定义翻译表。

五、总结

本文详细介绍了在 C++ 中表示和计算星期几的多种方法，包括使用标准库函数 mktime 和手动实现 Zeller 公式。这些方法各有优劣，开发者可以根据实际需求选择合适的方式。无论是处理特定日期还是获取当前日期的星期几，C++ 都提供了强大而灵活的支持。希望本文能帮助读者更好地理解和应用日期计算功能，提升开发效率。

通过掌握这些技巧，您可以轻松实现各种与日期和时间相关的功能，为应用程序增添更多实用价值。