Temporal Parser

产品简介 Temporal Parser 是 Taskade 团队开源的 JavaScript/TypeScript 日期时间解析库，采用编译器式的词法分析+语法解析架构，将 ISO 8601、RFC 3339 和 IXDTF 时间表达式转换为结构化的抽象语法树（AST），区别于传统正则表达式匹配方案，提供更可靠、可维护的时间数据处理能力。

核心功能 编译器式解析架构：区别于传统日期时间库依赖正则表达式或启发式猜测的做法，Temporal Parser 将时间字符串视为形式语言，通过词法分析器（Lexer）将输入切分为 Token 流，再由语法分析器（Parser）构建结构化 AST。解析逻辑清晰可维护、支持增量扩展、错误处理规范。

支持多种时间标准格式：基础日期（2025-01-12）、时间（T10:30:45）、时区偏移（+08:00、-05:00）、IANA 时区标识（[Asia/Singapore]）、时长表达式（P1Y2M3DT4H5M6S）、时间区间（2025-01-01/2025-12-31）以及 IXDTF 注解扩展（[u-ca=gregory]）。

交互式在线演练场：官方提供在线演练场（lxcid.com/tools/temporal-playground/），用户无需本地安装即可在浏览器中输入任意时间字符串，实时查看词法分析 Token 着色输出和对应 AST 结构。

零依赖+完整类型支持：库本身零外部依赖，完整 TypeScript 类型声明，支持 ESM 和 CommonJS 双模块格式。通过 npm install @taskade/temporal-parser 安装。

技术实现 Temporal Parser 核心使用 JavaScript/TypeScript 实现，解析流程为：输入字符串 → Lexer Token 化 → Parser 构建 AST → 返回结构化结果对象。AST 节点包含 kind（类型）、year/month/day/hour/minute/second（各字段值）、offset（UTC 偏移）、timeZone（时区标识）、annotations（IXDTF 注解）等完整元数据。

适用人群 面向需要在应用中处理复杂时间数据的开发者：构建日程管理系统的工程师、开发协作工具中时间相关功能的团队、处理跨时区数据管道的数据工程师，以及任何需要在 JavaScript/TypeScript 项目中可靠解析非规范化时间字符串的开发场景。

应用场景 该库适用于日历应用时间输入解析、跨时区会议时间处理、历史数据时间字段清洗、日程安排 UI、事件管理平台、数据管道时间戳规范化等多种需要处理复杂时间表达式的技术场景。

出品方 由 Taskade 团队维护并开源（github.com/taskade/temporal-parser）。Taskade 是一家专注协作工具开发的团队，该项目源于其内部构建日程和日历功能时积累的时间解析经验，现以开源形式回馈社区。