HTML <time> datetime 属性

定义和用法

datetime 属性表示 <time> 元素的机器可读的格式。

有效日期时间值的例子:

日期:

<time datetime="1914">  <!-- 表示 1914 年 -->
<time datetime="1914-12">  <!-- 表示 1914 年 12 月 -->
<time datetime="1914-12-20">  <!-- 表示 1914 年 12 月 20 日 -->
<time datetime="12-20">  <!-- 表示每年的 12 月 20 日 -->
<time datetime="1914-W15">  <!-- 表示 1914 年的第 15 周 -->

日期和时间:

<time datetime="1914-12-20T08:00">  <!-- 表示 1914 年 12 月 20 日上午 8 点 -->
<time datetime="1914-12-20 08:00">  <!-- 也表示 1914 年 12 月 20 日上午 8 点 -->
<time datetime="1914-12-20 08:30:45">  <!-- 包含分和秒 -->
<time datetime="1914-12-20 08:30:45.687">  <!-- 包含分、秒、毫秒 -->

时间:

<time datetime="08:00">  <!-- 表示上午 8 点 -->
<time datetime="08:00-03:00">  <!-- 表示里约热内卢时间(UTC-3 小时)上午 8 点。  -->
<time datetime="08:00+03:00">  <!-- 表示马达加斯加时间(UTC+3 小时)上午 8 点  -->

时长:

<time datetime="P2D">  <!-- 表示为期 2 天 -->
<time datetime="PT15H10M">  <!-- 表示为期 15 小时 10 分钟 -->

实例

已设置机器可读的 datetime 属性的 time 元素:

<p>我在 <time datetime="2017-02-14">情人节</time> 有个约会。</p>

亲自试一试

语法

<time datetime="YYYY-MM-DDThh:mm:ssTZD">

属性值

描述

YYYY-MM-DDThh:mm:ssTZD

或者

PTDHMS

规定的日期或时间。成分说明:

  • YYYY - 年(例如 2011)
  • MM - 月(例如 01 表示一月)
  • DD - 天(例如 08)
  • T 或空格 - 分隔符(如果还规定了时间则需要)
  • hh - 时(例如 22 表示晚上 10 点)
  • mm - 分(例如 55)
  • ss - 秒(例如 03)
  • TZD - 时区指示符(Z 表示祖鲁语,也称为格林威治标准时间)
  • P - "Period" 的前缀
  • D - "Days" 的前缀
  • H - "Hours" 的前缀
  • M - "Minutes" 的前缀
  • S - "Seconds" 的前缀

浏览器支持

表中的数字注明了首个完全支持该属性的浏览器版本。

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
62.0 18.0 22.0 7.0 49.0