Temporal 是 JavaScript 内置 API，需在 script 中使用，仅 Chromium 120+/Firefox 122+ 原生支持；判断支持须检测 Temporal.Now.plainDateISO 等具体方法而非仅 typeof，且不可直接替换 new Date()，因语义、时区、序列化均不同。
HTML 本身不支持 Temporal API —— 它是 JavaScript 的内置模块，必须在 <script></script> 中使用，且当前仅 Chromium 120+ 和 Firefox 122+ 原生支持，Safari 尚未启用。 想在网页中用 Temporal.PlainDateTime 或 Temporal.Now.plainDateISO()，得先确认运行环境，再写 JS 逻辑，HTML 只负责承载容器或输出结果。
怎么判断浏览器是否支持 Temporal
不能靠 typeof Temporal !== 'undefined' 轻率判断 —— 有些环境（如旧版 Node.js 或 polyfill 注入后）可能有 Temporal 对象但方法缺失。应检测关键构造器和静态方法：
if (typeof Temporal === 'object' &&
typeof Temporal.Now?.plainDateISO === 'function' &&
typeof Temporal.PlainDate?.from === 'function') {
// ✅ 可安全使用
} else {
// ❌ 降级到 new Date() 或加载 polyfill（如 @js-temporal/polyfill）
}
- 只检测
Temporal.Now.plainDateISO不够：它可能返回undefined（Firefox 122 前存在此 bug） - 生产环境建议用
try/catch包裹具体调用，而非仅做存在性检查 - Webpack/Vite 项目若需兼容旧浏览器，
import '@js-temporal/polyfill'必须放在所有业务代码之前
Temporal.PlainDateTime vs new Date()：为什么别直接替换
Temporal.PlainDateTime 是无时区、无毫秒精度的纯日历时间类型，和 new Date() 的语义完全不同。强行替换会导致时区错乱、序列化失败、比较逻辑反转：
-
new Date('2024-03-15T14:30')解析为本地时区的时刻；Temporal.PlainDateTime.from('2024-03-15T14:30')仅表示“3月15日14:30”，不关联任何时区 -
Temporal.PlainDateTime实例无法传给JSON.stringify()（会抛TypeError），必须显式调用.toString() - 与后端交互时，若 API 要求 ISO 8601 字符串（如
"2024-03-15T14:30Z"），必须用Temporal.ZonedDateTime或手动拼接，PlainDateTime无法生成带Z的字符串
HTML 表单输入与 Temporal 的衔接难点
原生 <input type="date"> 和 <input type="datetime-local"> 返回的是字符串，不是 Temporal 实例。直接传给 Temporal.PlainDate.from() 看似可行，但有隐含陷阱：
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
立即学习“前端免费学习笔记（深入）”；
-
<input type="date" value="2024-03-15">→Temporal.PlainDate.from(input.value)✅ 安全 -
<input type="datetime-local" value="2024-03-15T14:30">→Temporal.PlainDateTime.from(input.value)❌ 失败：该字符串含隐式本地时区，而PlainDateTime.from()不接受带偏移量的格式（即使没显式写+08:00） - 正确做法：对
datetime-local值，先用Temporal.PlainDateTime.from(input.value + ':00')补秒位，或改用Temporal.ZonedDateTime.from(input.value + 'Z')显式转为 UTC 时间
服务端渲染（SSR）中 Temporal 的坑
Node.js 20.7+ 才默认启用 Temporal，且需启动参数 --harmony-temporal（旧版本）或确保 V8 版本 ≥ 11.5。在 Next.js / Nuxt 等框架中 SSR 时容易踩两个雷：
- 构建时（build time）Node.js 版本支持 Temporal，但部署服务器（runtime）Node.js 版本过低 → 运行时报
ReferenceError: Temporal is not defined - 使用
Temporal.Now.zonedDateTimeISO()获取当前时间，在 SSR 中返回的是服务器时区时间，而非用户本地时间 —— 若用于渲染“今天”标签，需配合客户端 hydration 修正 - Next.js App Router 中，
server components里调用Temporal.Now是允许的，但不能在use client组件顶层执行（会触发 React Server Components 约束错误）
Temporal 不是 new Date() 的平滑升级，它是另一套时间模型。用错类型（比如拿 PlainDate 去算时差）、忽略序列化限制、或在不支持环境硬用，比写错正则还容易引发静默故障。
