DateTime 工具 — 高级日期/时间操作

功能完备的日期时间处理工具包，支持格式转换、时区处理、日期运算及日历计算，兼容 ISO 8601、RFC 2822、Unix 时间戳以及自然语言输入。

快速开始

# UTC 当前时间
datetime-tool --now

# 解析并重新格式化
datetime-tool --parse "2026-01-15 14:30:00" --format "ISO"

# 时区转换
datetime-tool --convert "14:00 UTC" --to "Asia/Shanghai"

用法

datetime-tool [COMMAND] [INPUT] [OPTIONS]

命令：
  --now              显示当前日期/时间
  --parse INPUT      从字符串解析日期
  --convert INPUT    在不同时区之间进行转换
  --diff START END   计算两个日期之间的间隔
  --add INPUT N      向日期添加时间单位
  --sub INPUT N      从日期减去时间单位
  --calendar YEAR    显示指定年份或月份的日历

选项：
  --format FMT       输出格式：ISO、RFC2822、Unix 或自定义格式字符串
  --from TZ          源时区（默认：本地时区）
  --to TZ            目标时区
  --units            diff 输出单位：seconds、minutes、hours、days
  --json             以结构化 JSON 格式输出

示例

# 以多种格式获取当前时间
datetime-tool --now --format ISO
datetime-tool --now --format "January 2, 2006 at 3:04 PM"

# 解析并重新格式化
datetime-tool --parse "2026-01-15" --format "January 15, 2026"

# 时区转换
datetime-tool --convert "14:00 UTC" --to "Asia/Shanghai"
datetime-tool --convert "2026-01-15 09:00" --from "America/New_York" --to "Europe/London"

# 计算日期差值
datetime-tool --diff "2026-01-01" "2026-12-31" --units days

# 添加/减去时间
datetime-tool --add "2026-01-01" --days 45
datetime-tool --sub "2026-03-01" --months 2

# 日历视图
datetime-tool --calendar 2026
datetime-tool --calendar 2026-03

# 机器可读输出
datetime-tool --parse "next Friday" --json

特性

• 自然语言解析：支持如 "next Friday"、"last day of month"、"+2 weeks" 等表达
• 时区转换：支持任意 IANA 时区（如 UTC、local、Asia/Shanghai 等）
• 日期运算：支持按天、周、月、年进行加减运算
• 时间间隔计算：精确计算任意两个日期之间的持续时间
• 多种输出格式：支持 ISO 8601、RFC 2822、Unix 时间戳及自定义模板
• 日历显示：支持按月或按年展示，含周序号
• JSON 输出：结构化输出，便于管道消费
• ISO 周序号与年积日（day-of-year）：适用于排程与会计场景