tiempo
基于Temporal API的时区处理库，解决JavaScript日期处理的痛点。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：tiempo。 它的用途是：基于Temporal API的时区处理库，解决JavaScript日期处理的痛点。 完整的 Skill 内容见：https://321skill.com/skills/tiempo/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我的后端API返回UTC时间字符串`2025-03-09T07:00:00Z`，我需要在前端将其转换为纽约用户的时间，并计算出明天的同一时刻，最后格式化成`Monday at 2:00 AM`这样的可读字符串。'，AI会建议你使用tiempo的`toZonedTime`、`addDays`和`format`函数，并给出示例代码，确保即使那天纽约进入夏令时，计算出的'明天'也是准确的。
介绍
tiempo是一个专注于解决JavaScript中时区处理难题的日期时间库。它旨在消除因时区转换、夏令时（DST）切换和精度不足而引发的各类bug，为开发者提供可靠、精确的时间操作工具。
该库基于新兴的Temporal API提案构建，提供了直观的API。开发者可以轻松地将UTC时间转换为任意IANA时区，进行跨时区的日期运算（如加减天数），并格式化为用户友好的字符串，最后再转换回标准的ISO 8601格式用于数据交换。其API设计借鉴了date-fns等流行库，学习成本低。
tiempo特别适合需要处理国际化用户时间、进行复杂日期计算或对时间精度有严格要求的前端、后端及全栈开发者。无论是构建全球化的SaaS应用、金融交易系统，还是需要精确时间戳的日志服务，它都能提供坚实保障。
使用tiempo时，建议开发者仔细阅读其官方文档，了解Temporal API与原生Date对象的差异。虽然它极大地简化了时区处理，但在迁移现有基于Date的代码时仍需注意API的变化。对于尚未支持Temporal API的极旧环境，可能需要考虑备选方案。
核心特点
核心区别在于其完全基于Temporal API构建，提供了真正的IANA时区支持和纳秒级精度，从根本上避免了传统JS Date对象基于UTC偏移量计算导致的时区bug和夏令时处理错误。
注意事项
不适合需要在尚未支持Temporal提案的旧版JavaScript环境（如某些旧浏览器或Node.js版本）中直接运行的场景。
常见问题
tiempo和date-fns/moment.js有什么区别？
tiempo基于下一代Temporal API，提供真正的时区支持和纳秒精度，能从根本上解决夏令时转换等边界case，而传统库基于Date对象存在固有缺陷。
这个库可以在浏览器中使用吗？
可以，但需要运行环境支持Temporal API，现代浏览器的新版本正在逐步支持，也可通过polyfill使用。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/tiempo/raw/index.md 读取 tiempo 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/tiempo/raw/index.md（查看排版版本）