的 datetime 属性必须严格符合 ISO 8601 五种合法格式，否则结构化数据工具、屏幕阅读器和 SEO 提取器会静默忽略；常见错误包括格式非法、手拼字符串、时区处理不当及语义与位置不匹配。
datetime 属性写错，<time></time> 就等于没写——所有结构化数据工具、屏幕阅读器、SEO 提取器都会跳过它，不报错，但也不认。
为什么 datetime 值为空或非法时浏览器不报错却失效
浏览器解析 <time></time> 时只做字面匹配，不尝试“猜测”或“容错”。值不是标准 ISO 8601，就直接忽略该属性，timeElement.dateTime 返回空字符串或 null。这不是 bug，是设计如此：语义标签必须无歧义。
- 常见现象：
document.querySelector('time').dateTime打印出""或null；Google Rich Results Test 显示 “Missing datePublished” - 根本原因：写了
datetime="2026/06/08"、datetime="2026-6-8"、datetime="2026-06-08 15:27"这类格式，哪怕只缺一个T或少一位数字 - 验证方法：打开 DevTools → Elements 面板中右键检查
<time></time>元素 → 确认datetime属性存在且值为合法字符串（不是灰色的“未定义”）
datetime 的五种合法格式及对应使用场景
W3C 只认这五类，其他全是无效。选哪一种，取决于你要表达的信息粒度和上下文是否已含日期。
-
YYYY-MM-DD（如"2026-06-08"）：仅需日期，如文章发布日、事件发生日；禁止"2026/06/08"或"2026-6-8" -
HH:MM或HH:MM:SS（如"15:27"、"15:27:00"）：仅用于同一日内的时刻，如课表、排班表；不能单独用于博客发布时间 -
YYYY-MM-DDTHH:MM（如"2026-06-08T15:27"）：含时间但省略秒与时区；合法但不推荐，因“本地时间”定义模糊，Safari 和 Chrome 解析行为可能不一致 -
YYYY-MM-DDTHH:MM:SSZ（如"2026-06-08T07:27:00Z"）：UTC 时间，结尾必须是大写Z，不是小写z或+00:00 -
YYYY-MM-DDTHH:MM:SS±HH:MM（如"2026-06-08T15:27:00+08:00"）：带明确时区偏移，最稳妥；禁止"CST"、"GMT+8"、"+8"
前端 JS 动态生成 datetime 的三个高危陷阱
手拼字符串、用错 API、忽略时区，三者任一踩中，datetime 就废了。
立即学习“前端免费学习笔记（深入）”；
- ❌ 用
toLocaleString()或toString()：输出类似"2026/6/8 下午3:27:00"，完全不符合 ISO 标准 - ❌ 手动拼接
getFullYear() + '-' + (getMonth()+1)：月份/日期漏补零（"2026-6-8"）、时区未处理、夏令时翻车 - ❌ 直接赋
new Date().toISOString().slice(0, 19)：得到的是 UTC 时间（如"2026-06-08T07:27:00"），若页面逻辑依赖北京时间，得手动加"+08:00"，不能直接截断 - ✅ 安全做法：要 UTC →
date.toISOString()；要本地带偏移 → 用Intl.DateTimeFormat("sv-SE", { timeZone: "Asia/Shanghai" }).formatToParts(date)构造，或引入date-fns/formatISO配{ format: "extended" }
显示文本和 datetime 不一致时，怎么才算语义对齐
二者不必相同，但必须逻辑自洽——机器能验证“显示文案”在当前上下文中是否合理指向该 datetime 值。
- ✅ 合理：
<time datetime="2026-06-08">今天</time>（页面渲染于当天）；<time datetime="2026-06-08T15:27:00+08:00">刚刚</time>（配合 JS 每秒更新textContent） - ❌ 错误：
<time datetime="2026-06-08">距今还有 3 天</time>（静态datetime与动态语义冲突，机器无法校验） - ⚠️ 注意：如果显示文本是“上周三”“明天”，而
datetime是固定值，那必须确保该值在页面生命周期内始终与文案逻辑一致；否则宁可不用<time></time>，改用普通<span></span>
最容易被忽略的点：即使 datetime 格式完全正确，如果它被放在页脚无关区域、或包裹了版本号（如 v2.3.1）、或嵌套在 <div hidden> 里，结构化数据提取器依然会跳过——语义不仅靠格式，还要靠位置和上下文可信度。</div>
