Timewarrior日期格式详解：全面掌握时间追踪工具的时间表示法

Timewarrior日期格式详解：全面掌握时间追踪工具的时间表示法

引言

Timewarrior作为一款强大的时间追踪工具，其核心功能依赖于对日期时间的精确处理。本文将全面解析Timewarrior支持的日期时间格式，帮助用户高效使用这一工具进行时间管理。

基础日期时间格式

Timewarrior基于ISO-8601标准，支持多种日期时间表示方式：

扩展日期时间格式

• YYYY-MM-DD：标准年月日格式，如2023-05-15
• YYYY-MM：年月格式，自动补全为当月1日
• YYYY-DDD：年份加儒略日（001-366）
• YYYY-WwwD：年份加周数和周内日数
• YYYY-Www：年份加周数，自动补全为当周周一

紧凑日期时间格式

• YYYYMMDD：紧凑型年月日
• YYYYWww：紧凑型年份加周数
• YYYYDDD：紧凑型年份加儒略日

时间表示

• hh:mm[:ss]Z：UTC时间，带Z标识
• hh:mm[:ss][+/-hh:mm]：带时区偏移的本地时间
• hhmm[ss]Z：紧凑型UTC时间
• hhmm[ss][+/-hh[mm]]：紧凑型带时区时间

特殊日期时间表示法

Timewarrior提供了一系列人性化的特殊日期表示方式，极大提升了使用便利性：

常用时间快捷方式

• now：当前精确时间
• today/yesterday/tomorrow：当日/昨日/明日午夜
• <星期名称>：最近的上一个该星期日的午夜
• <月份名称>：最近的上一个该月1日的午夜

周期边界标识

• sopd/eopd：前一天的开始/结束
• sod/eod：当天的开始/结束
• sopw/eopw：前一周的开始/结束
• soww/eoww：当前工作周的开始/结束（周一至周五）
• sopm/eopm：前一月的开始/结束
• soq/eoq：当前季度的开始/结束
• soy/eoy：当前年的开始/结束

节假日支持

• easter：复活节周日
• goodfriday：受难日
• pentecost：圣灵降临节
• midsommar：仲夏节（6月20日后第一个周六午夜）

实用技巧与注意事项

1. 时间范围界定：使用today作为范围终点时，实际不包含当天数据，因为其代表当天午夜。如需包含当天，应使用now或tomorrow。

2. POSIX时间限制：最小值为315532800（1980-01-01），避免与紧凑日期格式混淆。

3. 12小时制支持：可使用8am、3:30pm等格式表示时间。

4. 序数日期：支持24th等表示方式，代表最近的上一个该日期。

典型应用示例

# 查询昨天到今天的时间记录
timew summary yesterday now

# 查询上周工作时间
timew summary sopw eopw

# 查询本季度至今的时间分配
timew summary soq now

结语

掌握Timewarrior丰富的日期时间表示法，可以显著提升时间追踪的效率和精确度。无论是标准ISO格式还是人性化的快捷方式，都能满足不同场景下的需求。建议用户根据实际使用习惯，灵活组合各种时间表示方法，充分发挥Timewarrior的强大功能。