time元素必须带datetime属性才能被机器识别,正确写法是2024年5月20日,且datetime值须为iso 8601格式、不含冗余文字、与时区一致。

time 元素必须带 datetime 属性才能被机器识别
浏览器不会自动把 <time>2024-05-20</time> 当作有效日期,它只是普通内联文本。搜索引擎、屏幕阅读器或结构化数据工具(如 Google Rich Results Test)只认带 datetime 的版本。没这个属性,<time></time> 就退化成 <span></span>。
正确写法是:
<time datetime="2024-05-20">2024年5月20日</time>
常见错误包括:
-
datetime值用中文或口语格式(如"今天"、"5月20号")→ 无效 - 省略
datetime,只留可视化文本 → 无语义价值 - 时间格式不规范,比如
"2024/05/20"或"20-05-2024"→ 不符合 HTML 标准,解析失败
发布日期推荐用完整 ISO 8601 时间戳(含时分秒和时区)
仅标日期(YYYY-MM-DD)够用,但加时分秒和时区能避免跨时区歧义,尤其对 RSS、JSON-LD、Schema.org 等依赖精确时间的场景很关键。
例如博客文章发布时间,建议写成:
<time datetime="2024-05-20T14:30:00+08:00">2024年5月20日 14:30</time>
注意点:
-
T是日期与时间的固定分隔符,不能省略或换成空格 - 时区推荐用
+08:00这类偏移量,而非CST(缩写易歧义) - 如果发布系统支持,优先用 UTC(
Z结尾),比如"2024-05-20T06:30:00Z" - 纯日期场景(如版权年份)可用
datetime="2024",但仅限年份;<time datetime="2024">2024年</time>合法,但语义弱于具体日期
不要用 time 包裹非时间内容,比如“更新于”文字
<time></time> 只应包裹**时间值本身**,不是标签或说明文字。下面这种写法是错的:
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图,自动匹配视觉风格。触发场景:文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
<time datetime="2024-05-20">更新于:2024年5月20日</time>
它会让机器误以为“更新于:”也是时间的一部分。正确拆分是:
<span>更新于:</span><time datetime="2024-05-20">2024年5月20日</time>
其他典型误用:
-
<time datetime="2024-05-20">发布日期:2024-05-20</time>→ “发布日期:”必须剥离 -
<time datetime="2024-05-20">约2024年5月</time>→ “约”字破坏精确性,datetime必须是确切值 - 在
<time></time>里嵌套<strong></strong>或<em></em>改变语义 → 可以,但别影响可读性与解析
配合 meta 和 script 使用时,datetime 值必须严格一致
如果页面同时用 <meta name="article:published_time"> 或 JSON-LD 中的 datePublished,它们的值要和 <time></time> 的 datetime 完全一致,否则结构化数据校验会失败,导致富摘要不显示。
例如,以下三处必须同步:
<time datetime="2024-05-20T14:30:00+08:00">2024年5月20日</time><br><meta property="article:published_time" content="2024-05-20T14:30:00+08:00"><br>{ "datePublished": "2024-05-20T14:30:00+08:00" }
容易忽略的细节:
- HTML 中
datetime值不支持毫秒,但 JSON-LD 和 Open Graph 允许;统一时建议都去掉毫秒 - 服务端渲染时,确保所有时间字段来自同一时间源(比如同一个
new Date().toISOString()调用),避免因时区转换或格式化差异导致微小偏差 - 前端动态生成的
<time></time>,务必用toISOString()或toUTCString()生成值,别用toLocaleDateString()
最常被跳过的其实是时区一致性——哪怕只差一分钟,Google 的结构化数据测试工具就可能报 warning,而多数人只检查了 HTML 是否闭合。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










