x humantime

在秒数和人性化时间格式之间互相转换。
支持自动识别输入类型（整数转为可读格式，字符串转为秒数）。
常用于计算缓存过期时间、显示持续时间等场景。

时间单位：d(天), h(小时), m(分钟), s(秒)

TIP

自动模式: 直接输入时间，自动识别类型转换

• 整数（如 3600）→ 转为可读格式（1h）
• 字符串（如 2h30m）→ 转为秒数（9000）

显式子命令: fromsec, tosec, toms, in, auto

内部函数: fromsec_, tosec_（返回 x_ 变量，不输出）

例子

示例: 3600秒转为可读格式（自动识别）

x humantime 3600

示例: 2小时30分钟转为秒数（自动识别）

x humantime 2h30m

示例: 显式使用 fromsec 子命令转时间格式

x humantime fromsec 86400

示例: 1天12小时转为秒数

x humantime tosec 1d12h

示例: 判断240秒是否在5分钟内（返回0表示在范围内）

x humantime in 5m 240

示例: 无参数时使用当前时间戳（EPOCHSECONDS）

x humantime

示例: 支持小数秒（3661.5秒 = 1h1m1.5s）

x humantime 3661.5

子命令

名称	描述
x humantime fromsec	将秒数转为可读时间格式（如 3600 → 1h）
x humantime tosec	将可读时间格式转为秒数（默认整数，带 --decimal 显示三位小数）
x humantime toms	将可读时间格式转为毫秒数（如 2h30m → 9000000）
x humantime auto	自动识别输入类型并转换（默认子命令）
x humantime in	判断给定秒数是否在指定时间范围内

TIP

在交互式终端中（如 zsh, bash ...），可以使用 Tab 获取补全信息

运行 CMD SUBCOMMAND --help 可以获取命令的更多信息