Taskwarrior 时间处理模块升级：周起始日配置的改进与影响分析

Taskwarrior 作为一款高效的任务管理工具，其时间处理功能一直是核心能力之一。近期开发团队针对时间处理模块中的周起始日（weekstart）配置进行了重要改进，这些变更主要涉及底层库 libshared 的更新以及上层应用的适配工作。

背景与问题根源

在时间计算领域，周起始日的定义存在国际差异：国际标准 ISO8601 规定周一作为一周起始（weekstart=1），而北美地区习惯采用周日作为起始（weekstart=0）。旧版 Taskwarrior 在处理周相关计算时存在两个关键问题：

1. 周数解析逻辑与用户配置脱节，始终按照周日作为周起始日进行计算
2. 快捷日期表达式（如 sonw/sopw 等）固定采用周一作为计算基准，无法反映用户配置

这种不一致性导致用户在设置非默认周起始日时，部分时间计算功能会产生预期外的结果。

技术实现方案

本次改进通过分层解决方案实现了完整的周起始日支持：

底层库增强

libshared 时间处理模块进行了以下关键修改：

• 重构周数解析逻辑，使其能够根据 weekstart 配置动态调整计算方式
• 修复了周数计算中的边界条件错误（涉及跨年周的计算）
• 提供全局 weekstart 配置接口，允许上层应用传递用户设置

应用层适配

Taskwarrior 主程序相应进行了架构调整：

• 初始化阶段将用户配置的 rc.weekstart 值传递至底层时间模块
• 保持现有快捷日期表达式的行为一致性（暂时维持周一基准）
• 为未来完整的周起始日支持预留扩展接口

影响范围与兼容性

此次变更带来的主要影响包括：

1. 行为变化：使用 weekstart=1 配置的用户将直接获得符合 ISO8601 标准的周数计算结果
2. 向后兼容：维持 weekstart=0 配置的用户仍能获得与传统版本一致的行为
3. 待完善功能：快捷日期表达式目前仍固定使用周一基准，将在后续版本中完善

开发者建议

对于基于 Taskwarrior 进行二次开发的开发者，需要注意：

• 检查应用中是否依赖特定的周数计算逻辑
• 如需保持旧版行为，应显式设置 weekstart=0
• 关注后续版本中快捷日期表达式的行为变更

此次改进标志着 Taskwarrior 在时间处理标准化方面迈出了重要一步，为全球用户提供了更符合本地习惯的时间计算体验。开发团队计划在后续版本中进一步完善相关功能，实现完整的周起始日配置支持。