结构体 ara::tsync::TimeBase

类 ara::tsync::TimeBase 在 C++ 标准库系统中充当伪时钟（Pseudo-Clock），并用作 std::chrono::time_point 的时钟模板参数，以表示相对于 TimeBase 资源的本地时间 [SWS_TS_01264]。为了满足时钟要求，它提供了用于纳秒分辨率和持续时间的标准化类型别名。作为决定性的约束条件，该时钟通过 is_steady = false 被指定为非单调的，从而考虑了同步过程引起的时间跳变 [SWS_TS_01265]。

更多 ›

上下文

类或结构体 ara::tsync::TimeBase 在 AUTOSAR Adaptive Platform 的模块 tsync 中承担伪时钟（Pseudo-Clock）的角色。它在 C++ 层面主要用作 std::chrono::time_point 的第一个模板参数，以便在语义上指定时间戳表示相对于尚未详细说明的 TimeBase 资源（timeBaseResource）的本地时间 [SWS_TS_01264]。TimeBase 本身并不作为具有静态时间查询功能的活动时间源，而是在标准库中充当形式上的纽带 std::chrono。

通过提供标准化的类型定义，TimeBase 将 C++ 时间测量的通用机制绑定到同步模块。处理时间点或持续时间的消费者和组件使用该结构体的别名类型来交换类型化时间戳。通过这种方式，可以确保时间值通过 std::chrono::time_point 明确分配给本地 TimeBase，而不会被错误地与绝对系统时钟或其他时间源混淆。

上下文图：将 TimeBase 作为伪时钟嵌入到 C++ Chrono 类型系统中，以将时间点绑定到 TimeBase 资源。来源：[SWS_TS_01263]、[SWS_TS_01264]

生命周期

作为纯数据和类型结构（在头文件 ara/tsync/timestamp.h 中声明为 struct TimeBase），ara::tsync::TimeBase 不具备作为已初始化或正在运行的运行时组件意义上的动态生命周期阶段。实例化该结构的受保护对象对于预定功能并不是强制必需的；它主要在编译时存在于 C++ 类型系统层级。

为了满足 C++ 时钟要求（C++ Clock Requirements）的形式要求，TimeBase 定义了所有必需的类型别名和常量。这包括用于表示时间刻度数 [SWS_TS_01261] 的作为 std::int64_t 的基本计数器类型 rep，以及作为 std::nano [SWS_TS_01262] 的时间刻度间隔 period，这对应于纳秒范围内的分辨率。用于测量自纪元以来时间的持续时间通过类型别名 duration 作为 std::chrono::duration<rep, period> 提供 [SWS_TS_01263]。

关于并发性以及在运行系统中的行为，该结构体声明了布尔值为 false [SWS_TS_01265] 的静态常量 is_steady。这向 C++ Chrono 框架表明底层时钟不是单调的（steady）。解释：这可能是因为模块 tsync 中的时间同步过程可能会导致本地 TimeBase 发生调整或跳变，因此连续测量不能保证严格的单调性。 问题 Q-93a56c0eb2d35c7b (未决)由于该结构体本身不封装可变状态，因此所有类型的使用和常量的访问在本质上都是并发安全的。

使用路径

ara::tsync::TimeBase 的典型使用路径在于同步应用程序中时间值的声明、处理和传递。开发人员和自适应软件组件不会实例化时钟本身，而是访问定义为 std::chrono::time_point<TimeBase> 的核心类型别名 time_point [SWS_TS_01264]。

• 类型定义与接口规范：应用程序包含头文件 ara/tsync/timestamp.h 并使用 ara::tsync::TimeBase::time_point [SWS_TS_01264] 来声明时间戳的签名。解释：由此确保时间点在语义上保持与特定的本地 TimeBase 耦合。 问题 Q-549e2d377c0a6845 (未决)
• 算术与差值计算：若两个时间点相减，表达式会自动产生类型 ara::tsync::TimeBase::duration [SWS_TS_01263]。该类型基于纳秒步长（period）[SWS_TS_01262] 和 64 位整数（rep）[SWS_TS_01261]，从而允许进行符合标准的持续时间计算以及转换为其他时间单位。
• 与标准算法的互操作性：通过完全满足时钟类型要求，时间点和时间段可以无缝传递给 std::chrono 的标准库函数，而无需使用专有的时间结构。

解释：由于 TimeBase 被设计为伪时钟，它本身不提供静态成员函数 now()；此类 time_point [SWS_TS_01264] 的具体时间值确定可能由模块 tsync 中连接到所引用的 timeBaseResource 的其他服务或接口完成。 问题 Q-2a528a99023dad41 (未决)