time要素:日時の表示とdatetimeの正しい書き方
この記事では、日時を意味づけて表すHTMLのtime要素と、機械が読み取れる日時の指定方法を説明します。
この記事でわかること
timeが日付・時刻・期間を表す役割- 表示用テキストと
datetimeの分け方 - ISO 8601形式で機械可読な日時を書く方法
timeは日時の意味を示す。入力欄は作らない
見える文字は読みやすく書き、datetimeにはプログラムが読める値を書きます。自動で時計が動いたり、別の国の時刻に変わったりする仕組みではありません。入力してもらう場合はinput type="time"を使います。
<time datetime="2026-11-15">2026年11月15日</time>
<time datetime="11-27">11月27日(誕生日)</time>
<time datetime="--11-27">11月27日(同じ意味)</time>
年を付けない日付では、11-27と--11-27の両方が使えます。先頭の--は省略できます。
| 用途 | datetimeの値 | 表示例 |
|---|---|---|
| 日付 | 2026-11-15 | 2026年11月15日 |
| 年なし日付 | 11-27 | 11月27日 |
| 時刻 | 14:30 | 午後2時30分 |
| 日付・時刻・UTCとの差 | 2026-11-15T09:30+09:00 | 11月15日9時30分(日本時間) |
| 長さとしての時間 | PT45M | 45分間 |
日本時間の2026年11月15日09:30(+09:00)は、UTCの同日00:30(Z)と同じ瞬間です。+09:00をZに置き換えるだけでは、同じ瞬間になりません。時刻も換算します。
日付と時刻の間にはTまたは半角スペースを使えます。このページの例はTでそろえています。datetimeを省く場合は、timeの中の文字自体が有効な日時の形式である必要があります。
確かめ方:画面の文字を「午後2時30分」に変えても、datetime="14:30"の値は変わりません。表示と値のどちらを変更したかを区別してみてください。
根拠:HTMLのtime要素、年なし日付の形式。
The <time> element lets you show dates and times in a human-friendly way while also adding a machine-readable ISO value in datetime, so things like publish dates, deadlines, and yearless birthdays are understood correctly.
time 要素
time は、見た目は「2025年10月29日」みたいな普通の書き方でOKにしつつ、同時に datetime にISO形式を入れて機械にも正しく伝えるための要素で、公開日・締切・誕生日(年なし)などをきちんと表せます。
time 要素とは?
time 要素は、24時間表記の時刻、新暦のグレゴリオ暦における正確な日付を表します。タイムゾーン・オフセットを加えることもできます。この要素は、日付や時刻を機械にも分かる形で扱うために用意されています。
time 要素は、ブラウザやロボットなどから、その時刻を正確に読み取ることができるようにすることを想定して用意された要素です。
datetime を付けない場合は、YYYY-MM-DD や HH:MM(:SS) など決まった形だけが使えます。
でも datetime を付ければ、見た目は日本語のまま(例:「今月の23日」)でも、機械には正確な日時を伝えられます。
HTML
<time>16:02</time>
<time>16:02:06</time>
<time>2012-09-12</time>
<time>2012-09-12T16:02</time>
<time>2012-09-12T16:02:06</time>
<time>2012-09-12T16:02:06+09:00</time>
<time>2012-09-12T16:02:06Z</time>
日付の区切りには半角ハイフン、時刻の区切りには半角コロンを使います。日付と時刻の間はTまたは半角スペースです。このページではTを使います。特定の瞬間を示す場合は、日付・時刻にUTCとの差(+09:00など)を加えます。
前述のマークアップ例のように、時分だけ、時分秒だけ、日付だけ、といった表記も可能です。このほか、月・週・年なし日付・期間を示す形式もあります。
datetime を付けない場合は、書ける形が決まっています。
例えば 2012-09-12(日付)や 16:02:06(時刻)など、ISOのパターンに沿う必要があります。
でも datetime を付ければ、見た目は自由に、日本語で書いてOK です。
機械向けの正しい形だけ datetime に入れておけば、月だけ(YYYY-MM)・週だけ(YYYY-Www)・年なしの日付(MM-DDまたは--MM-DD) も扱えます。
迷ったら 「見た目は自由、意味は datetime」 と覚えておくと安心です。
HTML
<p>請求月:<time datetime="2025-10">2025年10月</time></p>
<p>対象週:<time datetime="2025-W44">2025年 第44週</time></p>
<p>誕生日:<time datetime="--11-27">11月27日</time></p>
以上のように、time要素に datetime属性を指定しない限り、所定のフォーマットで表された日時を入れなければいけません。しかし、現実的に、このようなマークアップができるシーンは限定的と言えるでしょう。やはり日本であれば、 ではなく 2010年9月12日と表現したいところでしょう。
datetime 属性
いくらマシン可読であることが目的の要素だとはいえ、前述のサンプルではなかなか使うことができません。そこで、time要素には datetime属性が規定されており、ここにマシン可読なフォーマットの日時情報を指定することができます。
time要素が表す日時は、datetime属性が指定されていれば、それが優先されます。この場合、time要素の中には、それに対応する日時を表すものであれば、何でも入れることができるようになります。
HTML
<time datetime="2013-01-23">今月の23日</time>
<time datetime="1976-11-27">彼の誕生日</time>
<time datetime="19:30">午後7時半</time>
FAQ
- Q. 日本語で「2025年10月29日」と書きたいです。
- A. 見た目はそのままでOK。
datetime="2025-10-29"を付けましょう。 - Q. 世界共通の時刻にしたいときは?
- A.
Zかオフセットを使います。例:2025-10-29T10:30:00Z(UTC)/+09:00(JST)。 - Q. 誕生日を「11月27日」のように年なしで表したい
- A. 見た目は「11月27日」、
datetime="11-27"またはdatetime="--11-27"を使えます。先頭の--は省略できます。 - Q. 月だけ・週だけでも使える?
- A.
datetime="2025-10"(月)やdatetime="2025-W44"(週)のように書けます。用途が合うときだけ使いましょう。 - Q. pubdate は使いますか?
- A. 使いません(廃止)。公開日は
time datetimeとJSON-LDで扱うのが現代的です。
よくあるエラー早見表
- 機械可読の値がない
- 見た目の日本語だけで書いている。
datetimeを付ける。 - 区切り文字違い
- 日付の区切りがスラッシュなど。ISOではハイフン(
YYYY-MM-DD)。 - 日付と時刻の区切りを間違える
- 日付と時刻の間は
Tまたは半角スペース。このページではTを使います。 - 先頭ゼロなし
- 月・日・時などはゼロ埋め(例:
09)。 - JSTを文字で書く
- 日本時間には
+09:00、UTCにはZを使います。同じ瞬間を表すなら、時刻の数字も換算してください。 - 年なし表現の誤り
11-27と--11-27は両方とも有効です。月・日を2桁にし、存在する日付か確認します。- pubdateを使う
- 廃止。使わない。公開日は
time datetimeと構造化データで。