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