<time></time>
更新日 | |
---|---|
仕様 | HTML Living Standard |
分類 | フロー・コンテンツ / フレージング・コンテンツ / パルパブル・コンテンツ |
利用場所 | フレージング・コンテンツが置ける場所 |
内容 | datetime属性がある場合:フレージング・コンテンツ / ない場合:テキスト(書式に沿った記述に限る 本文参照) |
time要素は、正確な日付や時刻を表します。
- この要素で指定する日時は、コンピュータで使用されることを想定したものとなります。そのため、time要素を使用する場合は、正確な日付や時刻を定められた書式で記述する必要があります。
<time>2022-12-03</time>
属性 | 値 | ||
---|---|---|---|
任意属性 | |||
datetime="" |
機械可読形式の日付や時刻 | YYYY-MM-DDThh:mm:ssTZD 等 |
書式に沿った日時の文字列 |
datetime属性の詳細については、下記のページを参考にしてください。
time要素は、24時間表記の時刻、またはグレゴリオ暦による正確な日付を表す際に使用します。
次のように、時刻のみ、日付のみ、日付と時刻、といったパターンで記述できるほか、必要であればタイムゾーンも指定することができます。
- 24時間表記の時刻(13時5分)
-
<time>13:05</time>
- 正確な日付(2022年12月3日)
-
<time>2022-12-03</time>
- 日時とタイムゾーン(2022年12月3日 13時5分30秒 日本時間 +09:00)
-
<time>2022-12-03T13:05:30+09:00</time>
time要素の内容について
datetime属性によって機械可読形式の日時が示されている場合は、time要素の内容に任意形式の日時を記述することができます。
<time datetime="2022-12-03">2022年12月3日</time>
また、次のように日時以外の内容を記述することもできます。
<time datetime="2022-12-03">今日</time>
datetime属性が指定されていない場合は、time要素の内容は書式に沿った日付や時刻である必要があります。
<time>2022-12-03</time>
日時の書式
日付と時刻は、以下の書式で記述します。
- 時刻のみ(時:分)
13:05
- 時刻のみ(時:分:秒)
13:05:30
- 日付のみ(年-月-日)
2022-12-03
- 日付と時刻(日付と時刻を T または半角スペースで区切る)
2022-12-03T13:05
2022-12-03T13:05:30
2022-12-03 13:05:30
- タイムゾーンの指定(日本時間は +09:00)
2022-12-03T13:05+09:00
- 協定世界時(UTC)を表す(末尾に Z)
2022-12-03T04:05Z
- 上記以外にも様々な書き方があります(週や期間を示すこともできます)。詳しくは仕様書の例でご確認ください。
- 旧HTMLからの変更点
-
- HTML5:time要素が定義されました。
- HTML5.1:コンテンツ・モデルが微妙に変わりました。(フレージング・コンテンツ → datetime属性がある場合:フレージング・コンテンツ / ない場合:テキスト)