このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
<time>: (日付)時刻要素
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2017年10月.
<time> は HTML の要素で、特定の時の区間を表します。datetime 属性を使用して、機械可読な形式の日付を記述することができ、検索エンジンの結果を改善したりリマインダーなどの独自機能に使用したりすることができます。
次のうちの一つを表します。
試してみましょう
<p>
The Cure will be celebrating their 40th anniversary on
<time datetime="2018-07-07">July 7</time> in London's Hyde Park.
</p>
<p>
The concert starts at <time datetime="20:00">20:00</time> and you'll be able
to enjoy the band for at least <time datetime="PT2H30M">2h 30m</time>.
</p>
time {
font-weight: bold;
}
属性
他のすべての HTML 要素と同様に、この要素はグローバル属性に対応しています。
datetime-
この属性は要素の日付や時刻を表し、下記に示す書式のうちの一つでなければなりません。
使用上のメモ
この要素は、機械可読な形式で日付や時刻を表現するためのものです。例えばユーザーエージェントが、ユーザーのカレンダーにイベントの予定情報を提供することに役立てることができます。
この要素はグレゴリオ暦導入前の日付に対して使用するべきではありません(日付の計算で混乱するため)。
datetime 値(機械可読な日時の値)は要素の datetime 属性の値であり、正しい書式(下記参照)でなければなりません。要素に datetime 属性がない場合、子孫要素を持ってはならず、 datetime 値 は要素のテキストの内容になります。
有効な datetime 値
- 有効な年の文字列
-
2011 - 有効な月の文字列
-
2011-11 - 有効な日付の文字列
-
2011年11月18日 - 年のない有効な日付の文字列
-
11-18 - 有効な週の文字列
-
2011-W47 - 有効な時刻の文字列
-
14:5414:54:3914:54:39.929 - 有効なローカル日時の文字列
-
2011年11月18日T14:54:39.9292011年11月18日 14:54:39.929 - 有効なグローバル日時の文字列
-
2011年11月18日T14:54:39.929Z2011年11月18日T14:54:39.929-04002011年11月18日T14:54:39.929-04:002011年11月18日 14:54:39.929Z2011年11月18日 14:54:39.929-04002011年11月18日 14:54:39.929-04:00 - 有効な期間の文字列
-
PT4H18M3S
例
>単純な例
HTML
<p>
コンサートは <time datetime="2018-07-07T20:00:00">20:00</time> に始まります。
</p>
結果
datetime の例
HTML
<p>
コンサートは
<time datetime="2001-05-15T19:00">5 月 15 日</time>に開催されます。
</p>
結果
技術的概要
| コンテンツカテゴリー | フローコンテンツ, 記述コンテンツ, 知覚可能コンテンツ |
|---|---|
| 許可されている内容 | 記述コンテンツ |
| タグの省略 | なし。開始タグと終了タグの両方が必須です。 |
| 許可されている親要素 | 記述コンテンツを受け入れるすべての要素 |
| 暗黙の ARIA ロール | 対応するロールなし |
| 許可されている ARIA ロール | すべて |
| DOM インターフェイス | HTMLTimeElement |
仕様書
| Specification |
|---|
| HTML> # the-time-element> |
ブラウザーの互換性
Loading...
関連情報
<data>要素では、他の種類の値を示すことが可能です。