C++ chrono中的time_of_day用法-C++-PHP中文网

time_of_day 不是 c++ 标准库组件，而是 howard hinnant date 库中的非标准类型，定义在中，用于封装一天内的时间点并支持格式化访问；标准 std::chrono 仅提供持续时间类型如 hours、minutes。

c++ chrono中的time_of_day用法

time_of_day 不是 C++ 标准库 std::chrono 的一部分 —— 它根本不存在于 ISO C++20 或 C++23 标准中。

为什么搜不到 `time_of_day`？它压根不是标准 chrono 组件

很多人在查“C++ 获取当天几点几分”时，被某些博客或 Stack Overflow 旧回答误导，以为 time_of_day 是 std::chrono 的官方类型。实际上，它是 Howard Hinnant 的 date 库（一个广泛使用的、非标准但事实上的 chrono 扩展）里定义的类模板，头文件为 <date></date>。

如果你没显式引入 date 库，只用了 <chrono></chrono> 和 <ctime></ctime>，编译器会直接报错：‘time_of_day’ was not declared in this scope。

标准 std::chrono 提供的是 std::chrono::hours、std::chrono::minutes 等持续时间类型，不提供“带 AM/PM 或格式化语义的‘时间-of-day’抽象”
date::time_of_day<duration></duration> 是对 Duration（如 std::chrono::seconds）的封装，支持 .hours()、.minutes()、.subseconds() 等成员访问
它的主要用途是配合 date::sys_days 构造完整时间点，比如 sys_days{2024y/June/15} + time_of_day{14h + 30min}

如何正确使用 `date::time_of_day`？三步走

前提是已安装并链接 Howard Hinnant 的 date 库（推荐用 vcpkg 或 conan 安装，或直接包含单头文件 date.h）。

包含头文件：#include <date></date>（注意不是 <chrono></chrono>）
使用命名空间：using namespace date; 或显式写 date::time_of_day<:chrono::seconds></:chrono::seconds>

构造方式示例：

auto t = time_of_day<:chrono::seconds>{14h + 30min + 5s};<br>std::cout </:chrono::seconds>

注意：time_of_day 默认以 std::chrono::seconds 为模板参数，所以 time_of_day{14h} 等价于 time_of_day<seconds>{14h}</seconds>；若需毫秒精度，得写 time_of_day<milliseconds>{14h + 30min + 5000ms}</milliseconds>

想从系统时间提取“今天几点”？别硬套 `time_of_day`

常见需求其实是“获取当前时刻的时分秒”，这时候直接用 std::chrono + std::time_t 更轻量、无依赖：

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

auto now = std::chrono::system_clock::now();<br>std::time_t t = std::chrono::system_clock::to_time_t(now);<br>std::tm tm = *std::localtime(&t);<br>std::cout 
<p>如果坚持用 date 库做这件事，更推荐组合 <code>floor<seconds>(now)</seconds></code> 和 <code>make_time</code>：</p>

auto t = floor<:chrono::seconds>(now);</:chrono::seconds> 截断到秒级
auto tod = make_time(t.time_since_epoch()); 得到 time_of_day<seconds></seconds>
再调用 tod.hours().count() 等取整数部分

但要注意：make_time 返回的是基于 epoch 起始的 time_of_day，和本地时区无关 —— 若需本地时间，必须先用 zoned_time 转换时区，否则可能差 8 小时。

容易踩的坑：模板参数、时区、头文件路径

time_of_day 的行为高度依赖模板参数和上下文，几个高频翻车点：

忘记 #include <date></date>，只 include <chrono></chrono> → 编译失败
误用 std::chrono::time_of_day（加了 std::chrono:: 前缀）→ 名字查找失败
构造时传入负值（如 time_of_day{-1h}）不会报错，但后续格式化可能出意外（比如显示 23:00:00 而非 -01:00:00）
用 time_of_day<milliseconds></milliseconds> 构造后，调用 .hours() 返回的是 std::chrono::hours 类型，不能直接 cout，得写 .hours().count()
date 库默认不启用时区支持；若要用 zoned_time 或本地时间，必须额外定义 DATE_BUILD_TZ_LIB 并链接 tz 库