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