技能介绍

问题：时间戳与日期转换的常见痛点

开发者在处理系统日志、API响应或数据库记录时，常需在Unix时间戳与人类可读日期间转换。然而手动计算存在三大问题：一是时区偏差导致显示时间与实际业务时间不符（如UTC存储的时间戳需转换为Asia/Shanghai）；二是秒级与毫秒级时间戳精度混淆（如JavaScript的Date.now()返回毫秒，而部分Unix工具默认秒）；三是日期格式不统一（如"2023-10-01"与"2023-10-01 12:00:00"需区分处理）。

技能工作原理：双向转换与精准控制

该技能通过参数化设计解决上述问题。核心能力包括：

双向转换：支持--from-ts将时间戳转日期，--from-date将日期转时间戳
精度控制：通过--sec指定输入为秒级时间戳（默认毫秒）
时区适配：--tz参数支持Asia/Shanghai、UTC、America/New_York等时区（默认Asia/Shanghai）
当前时间查询：--now可同时获取时间戳与日期

关键步骤示例：

转换毫秒级时间戳：timestamp --from-ts 1696118400000 --tz Asia/Shanghai
转换秒级时间戳：timestamp --from-ts 1696118400 --sec --tz UTC
日期转时间戳：timestamp --from-date "2023-10-01 12:00:00" --tz America/New_York

适用边界与注意事项

时区规则依赖：技能使用IANA时区数据库，极端情况（如历史时区变更）需确保系统时区数据更新
格式严格性：--from-date仅支持YYYY-MM-DD HH:mm:ss或YYYY-MM-DD格式，其他格式（如"Oct 1 2023"）会报错
精度陷阱：未指定--sec时默认处理毫秒，若输入秒级时间戳会导致结果偏差1000倍
跨平台一致性：时区名称需与系统支持的格式一致，建议使用IANA标准时区标识