TrueTime 是一个专为解决时间计算中常见错误而设计的工具，旨在确保跨时区、服务器时间、NTP 时间以及用户本地时间的精确调度与规划。它通过严格的规则和流程，避免因过时示例、单位混淆、时区漂移或夏令时（DST）混乱导致的时间误判。TrueTime 的核心理念是：始终将用户提供的持续时间值视为权威输入，并在执行前从运行时时钟读取当前真实时间，而非依赖硬编码的数值。所有时间计算首先转换为 UTC 标准时间，再按需转换为用户或服务器所在的时区进行展示，从而保证逻辑一致性与执行准确性。 该工具支持相对时间和绝对时间两种模式。对于相对时间，TrueTime 接受毫秒到世纪范围内的多种单位（如 `ms`、`m`、`h`、`d`、`month`、`year` 等），并支持小数形式（如 `1.5m`、`0.25h`），同时提供日历感知的单位处理（如月份加减会正确处理月末日期）。对于绝对时间，它要求使用 IANA 时区标识符（如 `Asia/Shanghai`、`America/New_York`），并明确处理 DST 过渡期的模糊或无效时间点，必要时向用户请求澄清。此外，TrueTime 默认输出农历时间信息，适用于需要中文传统历法背景的场景。 TrueTime 强调验证机制的重要性——在执行任何定时任务前，必须确认目标时间与当前时间的差值符合预期，且时区转换过程无偏差。最终响应需包含完整的上下文信息，包括 UTC 基准时间、各相关时区的显示时间、时间源（服务器或 NTP）、以及可能的假设说明，确保透明可追溯。
核心功能特点
- 严格遵循‘用户输入即权威’原则，拒绝复制示例中的数值
- 支持从毫秒到世纪的相对时间计算，含小数和日历单位（月/年等）
- 优先以 UTC 为中间标准进行时间转换，保障跨平台一致性
- 自动处理夏令时切换导致的模糊或不存在本地时间，需用户确认
- 默认集成中国农历时间输出，适配本地化需求
- 可选 NTP 时间源校验，防止服务器时钟偏差影响关键调度
适用场景
TrueTime 特别适用于那些对时间精度和跨地域协调有严格要求的应用场景。例如，在多时区团队协作中安排会议时，系统可利用 TrueTime 将伦敦的会议时间准确转换为纽约或上海的本地时间，并自动规避夏令时带来的偏移误差。同样，在设置跨国提醒功能时，无论是‘1小时后提醒’还是‘下周三上午9点’，TrueTime 都能基于当前真实时间动态计算目标时刻，并以用户熟悉的本地格式呈现，避免因静态时间戳造成的延迟或提前触发。 另一个典型用例是自动化运维中的定时任务管理。当需要在特定时间点执行脚本、备份数据或发送报告时，直接使用服务器本地时间可能导致计划错乱，尤其是在不同地区部署的服务之间。借助 TrueTime，开发者可以统一采用 UTC 作为调度基准，再根据目标接收方的时区生成友好的预览信息，既保证了执行可靠性，又提升了用户体验。此外，在处理涉及农历节日的业务逻辑（如春节促销倒计时）时，TrueTime 提供的农历字段可帮助应用无缝衔接传统节日与公历之间的映射关系。 无论是开发即时通讯中的消息延时发送功能，还是在金融系统中处理跨时区的交易截止时间，亦或是构建个人日程管理工具支持全球用户，TrueTime 都提供了稳健的时间解析与转换能力。其强制性的前置验证流程和详尽的输出字段设计，使得每一次时间敏感操作都有据可查、可控可信，显著降低了因时间误解引发的运营风险。