Bttf：一款命令行日期时间瑞士军刀

背景

在命令行工具生态中，date 命令几乎是每个 Linux 或 macOS 用户的标配，用于处理日期和时间。然而，正如作者所指出的，date 命令的用法并不直观，其标志位和行为逻辑常常令人困惑，导致用户不得不频繁查阅手册才能有效使用。此外，date 命令在处理复杂的时间算术、多时区转换或从非结构化文本中提取时间戳时，往往显得力不从心或需要编写冗长的管道命令。

在此背景下，bttf 应运而生。这是一个用 Rust 编写的命令行工具，旨在成为日期时间处理的“瑞士军刀”。它最初名为 Biff，后更名为 bttf。该项目由 Jiff 库的作者开发，主要目的是在命令行层面暴露 Jiff 库的功能，同时通过实际使用场景（即“带着怒气使用”）来推动 Jiff 库走向 1.0 稳定版本。bttf 采用 MIT 或 UNLICENSE 双重许可。

核心内容

bttf 不仅仅是一个简单的日期打印工具，它提供了一套完整的日期时间算术、解析、格式化及处理功能。其核心设计理念是简洁、强大且专注于日期时间数据，同时通过引入标签（tagging）机制增强了处理非结构化数据的能力。

基础时间与格式化

bttf 默认输出当前时间，例如：

$ bttf
Sat, May 10, 2025, 8:02:04 AM EDT

用户可以通过 time fmt 子命令自定义输出格式。它支持 RFC 3339、RFC 9557 等标准格式，也支持类 strftime 的格式字符串（如 %Y-%m-%d %H:%M:%S %Z）。值得注意的是，bttf 对本地化支持有特定要求，若未配置 BTTF_LOCALE 环境变量，输出可能会呈现为未本地化的格式（如 2025 M05 10）。

相对时间与时间算术

bttf 能够处理复杂的相对时间描述，并支持在单次命令中处理多个时间点：

$ bttf time fmt -f '%c' now -1d 'next sat' 'last monday'

此外，它支持时间加法运算，可以添加具体的持续时间（如 -1w 表示一周前，6mo 表示六个月后），并支持自然语言描述的时间段（如 '1 week, 12 hours ago'）。

时区与精度控制

工具支持跨时区转换，例如将当前时间转换为曼谷时间，并可以将其舍入到最近的 15 分钟增量：

$ bttf time in Asia/Bangkok now | bttf time round -i 15 -s minute

在计算时间跨度（span）时，bttf 允许用户指定精度级别（如年、天），并将结果舍入到所需的精度：

$ bttf span since 2025-01-20T12:00 -l year
3mo 20d 21h 1m 25s 171ms 886µs 534ns

日志处理与数据流集成

bttf 的一个独特优势是其处理非结构化数据的能力。通过 tag 和 untag 命令，它可以从日志文件中提取时间戳，转换为本地时间，重新格式化，再移除标签，从而实现原地修改或管道处理：

$ head -n3 /tmp/access.log | bttf tag lines /tmp/access.log | bttf time in system | bttf time fmt -f '%c' | head -n3 | bttf untag -s

序列生成

bttf 提供了强大的 time seq 命令，用于生成日期序列。它可以生成特定星期几的序列（如周一、周三、周五），指定次数、时间，甚至支持“每月的第二个星期二”或“未来12个月中最后一个工作日”等复杂逻辑：

$ bttf time seq -c12 monthly -w mon,tue,wed,thu,fri --set-position -1

架构与依赖

bttf 本身包含的逻辑相对较少，核心的日期时间逻辑由 Jiff 库提供，本地化功能则由 ICU4X 提供，并通过 jiff-icu 集成。这种架构使得 bttf 能够利用 Rust 生态中高性能且正确的日期时间处理库。

关键要点

• 非 POSIX 兼容：bttf 明确声明不兼容 POSIX date 命令，也不是其直接替代品。它不关心 POSIX 标准（除了 TZ 环境变量）。如果用户需要严格的 date 兼容性，应继续使用 POSIX date 的实现。
• 格式兼容性：尽管不兼容 POSIX，但 bttf time fmt 命令支持大量与 GNU date 兼容的 strftime 语法。
• 安装方式多样：
  • 提供 Windows、macOS 和 Linux 的预编译二进制文件（Linux 和 Windows 为静态链接）。
  • Rust 开发者可通过 cargo install bttf 安装。
  • 若希望减小二进制文件大小并加快编译速度，可通过 --no-default-features 禁用本地化支持进行安装。
• 标签机制（Tagging）：bttf 引入了 tag 命令，将检测到的日期时间包装为 JSON Lines 格式。这使得 bttf 可以处理任意数据中的时间戳，这是其他日期时间工具较少具备的功能。
• 开发动机：作者开发 bttf 是为了在命令行层面暴露 Jiff 库的功能，并通过实际使用发现 Jiff 的 API 缺失或性能问题，从而推动 Jiff 达到 1.0 版本。
• 警告：由于项目仍处于早期阶段，作者可能会发布任意且不兼容的破坏性更改（breaking changes）。

意义与影响

bttf 的出现反映了开发者对命令行工具“简洁性”与“功能性”平衡的持续追求。虽然 date 命令历史悠久且广泛可用，但其复杂的标志位和晦涩的行为逻辑一直是用户体验的痛点。bttf 通过提供直观的相对时间语法（如 next sat）、强大的管道集成能力（通过 tag/untag 处理非结构化数据）以及现代化的 Rust 底层实现，为系统管理员、DevOps 工程师和开发者提供了一个更现代、更强大的替代方案。

此外，bttf 与 Jiff 库的深度绑定具有战略意义。它不仅是 Jiff 的命令行前端，更是 Jiff 走向生产级稳定（1.0）的试金石。通过在 bttf 中集成 ICU4X 本地化支持，作者验证了 Jiff 在复杂国际化场景下的能力。对于 Rust 社区而言，bttf 展示了如何利用现代系统编程语言构建高效、可组合的命令行工具，同时也为其他库提供了通过 CLI 暴露核心功能的优秀范例。尽管它目前可能不适合需要严格 POSIX 兼容性的传统脚本环境，但在追求开发效率和处理复杂时间逻辑的场景中，bttf 提供了极具价值的解决方案。