390.txt

[4] [[HTML]] の [DFN[[CODE(HTMLe)@en[time]] [[要素]]]]は、[[日時]]や[[日付]]や[[時刻]]を表します。

* 仕様書

[REFS[
- [94] [CITE@en-US-x-hixie[HTML Standard]] ([TIME[2014-05-05 21:57:42 +09:00]] 版) <http://www.whatwg.org/specs/web-apps/current-work/#the-time-element>
]REFS]

* 分類

[95] [CODE(HTMLe)@en[[[time]]]] [[要素]]は、
- [[触知可能内容]]
- [[字句内容]]
- [[フロー内容]]

... です [SRC[>>94]]。

* タグ

[97] [[開始タグ]]も[[終了タグ]]も、省略できません [SRC[>>94]]。

* 属性

[98] [[大域属性]]の他、 [DFN[[CODE(HTMLa)@en[[[datetime]]]]]] [[属性]] (>>103) があります [SRC[>>94]]。

* 内容モデル

[96] [CODE(HTMLe)@en[[[time]]]] [[要素]]の[[内容]]は、[[字句内容]]です [SRC[>>94]]。ただし制限があります (>>103)。

* [CODE(DOMi)@en[HTMLTimeElement]] インターフェイス (DOM)

[99] [CODE(HTMLe)@en[[[time]]]] [[要素]]の[[要素インターフェイス]]は、
[DFN[[CODE(DOMi)@en[[[HTMLTimeElement]]]]]] [[インターフェイス]]です [SRC[>>94]]。

[100] [CODE(DOMi)@en[[[HTMLTimeElement]]]] [[インターフェイス]]は、 
[CODE(DOMi)@en[[[HTMLElement]]]] [[インターフェイス]]を[[継承]]しています [SRC[>>94]]。

[101] [CODE(DOMa)@en[[[dateTime]]]] [[IDL属性]]は、[[データ型]]
[CODE(DOMi)@en[[[DOMString]]]] の[[属性]]で、 [CODE(HTMLa)@en[[[datetime]]]]
[[内容属性]]を[[反映]]しています [SRC[>>94]]。

;; [108] 普通の[[文字列]]としての[[反映]]になります。

* レンダリング

[102] [CODE(HTMLe)@en[[[time]]]] [[要素]]は、その[[内容]]と、 [CODE(HTMLa)@en[[[datetime]]]]
[[属性値]]の機械可読形とを[[表現]]します。 [SRC[>>94]]

* マイクロデータ

[110] [[マイクロデータ]]の[[特性値]]としては、 [CODE(HTMLe)@en[[[time]]]] [[要素]]の場合[[日時値]]が用いられます。

[111] [CODE(HTMLa)@en[[[itemValue]]]] [[属性]]は、[[取得時]]には[[日時値]]を返し、
[[設定時]]は [CODE(DOMa)@en[[[datetime]]]] [[内容属性]]を[[反映]]します。

* 日時値

[103] [DFN[[RUBYB[[[日時値]]]@en[datetime value]]]]は、 [CODE(HTMLa)@en[[[datetime]]]]
[[内容属性]]があればその[[属性値]]、なければ [CODE(DOMa)@en[[[textContent]]]]
[[IDL属性値]]です。 [SRC[>>94]]

[104] [CODE(HTMLa)@en[[[datetime]]]] [[内容属性]]がないときは、[[子孫]]に[[要素]]があっては[['''なりません''']]
[SRC[>>94]]。

[105] [CODE(HTMLa)@en[[[datetime]]]] [[内容属性]]の値は、[[要素]]の[[内容]]を機械可読な形で表したものでなければ[['''なりません''']]
[SRC[>>94]]。

[106] [[日時値]]は、次のいずれかでなければ[['''なりません''']] [SRC[>>94]]。
[FIG(short list)[
- [[妥当な月文字列]]
- [[妥当な日付文字列]]
- [[妥当な月日文字列]]
- [[妥当な時刻文字列]]
- [[妥当な地方日時文字列]]
- [[妥当な時差文字列]]
- [[妥当な大域日時文字列]]
- [[妥当な月文字列]]
- 4桁以上の[[ASCII数字]]で [CODE[[[0]]]] 以外を含むもの ([[年]])
- [[妥当な時間文字列]]
]FIG]

[107] [DFN[[RUBYB[[[要素の内容の機械可読な等価値]]]@en[machine-readable equivalent of the element's contents]]]]とは、
>>106 に対応する構文解析方法によって解釈した結果の値です。いずれによっても解釈できなければ、
そのような値はありません。 [SRC[>>94]] >>106 の各構文は互いに完全に区別可能となっているので、
いずれであるかは曖昧無く決まります。

* 歴史

** 前史

[1] [[日時]]を [[HTML]] で記述する手法は古くから要求があり、[[要素]]を新たに追加するもの、
既存の[[要素]]を流用するものなど、様々な提案がありました。

*** 新しい要素の提案

[2]
[CITE[Aural Cascading Style Sheets (ACSS)]] <http://www.w3.org/TR/WD-acss-970630#speech-properties>

> This [INS[('[CODE(CSS)@en[[[speak-date]]]]' property)]] would be most useful when combined with
a new HTML tag used to identify dates, such as this theoretical example:
[PRE(HTML example code)[
   <p>The campaign started on <date value="1874-oct-21">
   the twenty-first of that month</date> and finished 
   <date value="1874-oct-28">a week later</date>
]PRE]

[16]
[CITE@en[W3C I18N FAQ: Date formats]] ([TIME[2007-05-20 22:36:46 +09:00]] 版) <http://www.w3.org/International/questions/qa-date-format#bytheway>

>
Some have advocated the creation of a <date> tag that would display dates according the locale of the user agent. This is subject to the same practical issues as described for dynamic date generation with the Japanese example. The appropriate format is generally a function of the linguistic context of a page, rather than the user's platform.

*** 既存要素の流用

[63] [[マイクロフォーマット]]界隈では、 [CODE(HTMLe)@en[[[abbr]]]] [[要素]]を[[日時]]の表記に流用する
「[[デザイン・パターン]]」を発明しました。 (詳しくは [CODE(HTMLe)@en[[[abbr]]]]
の項を参照してください。)

[62] [CITE@en-us[Tantek's Thoughts]] ([[Tantek Çelik]] 著, [TIME[2006-05-20 00:13:35 +09:00]] 版) <http://tantek.com/log/2005/01.html#d26t0100>

>
My first instinct was to try the <object> tag, since it has a nice mechanism for providing data within its 'data' attribute, and fallback plain text inside the element itself, e.g. (simplified for sake of discussion):
[PRE(HTML example code)[
<object data="20050125">January 25</object>
]PRE]
This worked great in typical modern browsers, except for one: Safari (v1.2.1). Unfortunately, to put it mildly, Safari's <object> support sucks. It doesn't handle <object> fallbacks, it doesn't know when not to handle <object> mime types that it doesn't support, it doesn't support display:inline on <object>, and it doesn't do proper intrinsic sizing of <object> replaced elements. These are all trivial to reproduce bugs.

>Humans don't think of dates and times in terms of fully qualified year, month, date, hour, minute, second, time-zone values. Humans think of dates and times in terms of only that which is necessary. The day, or the day and the month, or perhaps just the hour. What do all these have in common? They are all abbreviations for a fully qualified date and time.
>
Lucky for us, XHTML has an element for abbreviations: <abbr>.
>
Thus, the ISO8601 date 20050125 should be marked up as:
[PRE(HTML example code)[
<abbr title="20050125">January 25th</abbr>
]PRE]

[64] しかしこれに対しては「[CODE(HTMLe)@en[[[abbr]]]] は[[略語]]を表すが、[[日時]]は[[略語]]ではない」
などの批判があり、[[マイクロフォーマット]]界隈を越えて普及するには至りませんでした。

** HTML5

@@ 最初は [CODE(HTML)@en[[[date]]]] だった。

*** [CODE(HTMLe)@en[t]] 要素

[3]
[[Ian Hickson]] は、[[日時]]を表す[[要素]]の追加の要求が古くから強いことを踏まえ、
[CODE(HTMLe)@en[[[t]]]] [[要素]]を [[HTML5]] 仕様案に追加しました。

[5]
現地時間が記述されていても、 tooltip で利用者の地方時が表示されるようなブラウザにwktk
([[名無しさん]] [WEAK[2006-09-25 23:41:07 +00:00]])

[6]
[CITE[[whatwg] Joe Clark's Criticisms of the WHATWG and HTML 5]] <http://listserver.dreamhost.com/pipermail/whatwg-whatwg.org/2006-October/007513.html>
([[名無しさん]] [WEAK[2006-10-31 00:54:15 +00:00]])

[7] >>6
[CITE['''['''whatwg''']''' Joe Clark's Criticisms of the WHATWG and HTML 5]] ([TIME[2009-03-09 12:00:26 +09:00]] 版、
[[Ian Hickson]] 著) <http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2006-October/007513.html>

><t> (or an equivalent) has been widely requested, especially in the 
microformats and CSS communities. Several microformats have need for 
encoding specific times and/or dates, and are currently (ab?)using <abbr> 
for this purpose. The CSS community has requested a <date> or <time> 
element because they want to restyle dates and times according to locale. 
The blogging and content publishing communities have also raised the need 
for a way to unambiguously mark up what part of their document is a date 
and/or time, though in their case (as with microformats) they need a way 
to then mark each date/time element as being a particular semantic 
(publishing date, birth date, calendar event time etc).
>
Also, the aforementioned research indicated that there are substantial 
amounts of content on the Web that uses invented elements, IDs, and class 
attributes to mark up dates and times. For example, I found about the same 
number of pages with the obscure ID "updatedtime" as I did pages with a 
<button> element; "date" was the 14th most frequently seen class name.

*** [CODE(HTMLe)@en[time]] 要素 (第1世代)

[8] 「[CODE(HTMLe)@en[[[t]]]]」は短すぎるということで、後に [CODE(HTMLe)@en[[[time]]]]
に改められました。

[17]
[CITE[Sam Ruby: The <time> element]] ([TIME[2007-04-19 08:32:25 +09:00]] 版) <http://www.intertwingly.net/blog/2007/04/17/The-time-element>
([[名無しさん]] [WEAK[2007-04-18 23:39:35 +00:00]])

[76] [CITE[''''''[''''''whatwg'''''']'''''' <time> element feedback]]
( ([TIME[2010-12-08 08:42:59 +09:00]] 版))
<http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2010-December/029363.html>

[67] [CITE[''''''[''''''whatwg'''''']'''''' proposal: extend <time> to markup durations]]
( ([TIME[2011-07-30 04:20:12 +09:00]] 版))
<http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2011-July/032456.html>

*** [CODE(HTMLe)@en[time]] 要素 (第2世代)

[90] 2011年10月に [CODE(HTMLe)@en[[[time]]]] [[要素]]は削除され、かわりに [CODE(HTMLe)@en[[[data]]]]
[[要素]]が導入されました。11月に新たに [CODE(HTMLe)@en[[[time]]]] [[要素]]が追加されました。
([CODE(HTMLe)@en[[[data]]]] [[要素]]も残っています。)

[91] 第1世代の [CODE(HTMLe)@en[[[time]]]] [[要素]]は [[Webブラウザー]]に相応のレンダリングを求めるものでしたが、
実際には[[著者]]は独自のレンダリングを望んでおり、[[Webブラウザー]]も独自のレンダリングを実装する意思がないことから、
同名の新しい[[要素]]を改めて定義しなおしたものだと説明されています。

[92] しかしこの変更への反発から [[W3C]] [[HTML WG]] を中心に大きな混乱が生じ、
それまで [[WHATWG]] の [[HTML5]] の複製だった [[W3C]] の [[HTML5]]
に独自の変更が加えられ、それをきっかけに両者が同期されなくなりました
[WEAK[(それまでは [[W3C]] が独自の変更を決議しても、 [[Ian Hickson]] が編集している [[WHATWG]] [[HTML5]] のソースファイルから [[W3C]] [[HTML5]] を生成していました)]]。
[[W3C]] の [[HTML5]] はこの騒動の後しばらく放置されていましたが、最終的には [[W3C]]
が独自の編集者を雇用し、 [[WHATWG]] と決別して独自の仕様書を発行するようになります。

;; [93] 最終的には [[W3C]] も [[WHATWG]] 側の [CODE(HTMLe)@en[[[time]]]] [[要素]]の定義に揃えたようです。
ただし独自の編集を加えているようです。

[69] [CITE@en[Web Applications 1.0 r6783        Drop <time> and replace it with <data>. Drop the Atom conversion section entirely. Convert a bunch of examples that used to use <time pubdate> to using schema.org, to show how to annotate publication dates and the like in a machine-processable way.]]
( ([TIME[2011-10-29 14:38:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=6782&to=6783>

[70] [CITE[IRC logs: freenode / #whatwg / 20111102]]
( ([TIME[2011-11-05 12:41:15 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20111102>

[71] [CITE[IRC logs: freenode / #whatwg / 20111102]]
( ([TIME[2011-11-05 12:41:15 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20111102>

[72] [CITE@en[HTML5 spec reverted to cvs r1.5431, svn r6782 ''''''[''''''was: Revert request  for r6783'''''']'''''']]
( ([[Michael'''['''tm''']''' Smith]] 著, [TIME[2011-11-11 03:06:27 +09:00]] 版))
<http://lists.w3.org/Archives/Public/public-html/2011Nov/0098.html>

[73] [CITE[IRC logs: freenode / #whatwg / 20111110]]
( ([TIME[2011-11-12 00:39:03 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20111110>

[74] [CITE[IRC logs: freenode / #whatwg / 20111111]]
( ([TIME[2011-11-12 00:43:00 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20111111>

[75] [CITE@en[Ian Hickson responds over HTML5 getting 'time' element back | News | .net magazine]] ([TIME[2011-11-12 01:05:16 +09:00]] 版) <http://www.netmagazine.com/news/ian-hickson-responds-over-html5-getting-time-element-back-111552>

[77] [CITE@en[Time element - WHATWG Wiki]]
( ([TIME[2011-11-06 10:06:26 +09:00]] 版))
<http://wiki.whatwg.org/wiki/Time_element>

[78] [CITE@en[Web Applications 1.0 r6827        the <time> element is dead, long live the <time> element]]
( ([TIME[2011-11-19 04:43:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=6826&to=6827>

[79] [CITE@en[Web Applications 1.0 r6829        extend timezone format to also allow omitting the colon]]
( ([TIME[2011-11-19 08:22:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=6828&to=6829>

[80] [CITE@en[(3) Google]]
( ([TIME[2011-11-19 13:57:07 +09:00]] 版))
<https://plus.google.com/107429617152575897589/posts/3ZEQAVkF6xd>

[81] [CITE[IRC logs: freenode / #whatwg / 20111116]]
( ([TIME[2011-11-18 00:23:14 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20111116>

[82] [CITE[IRC logs: freenode / #whatwg / 20111118]]
( ([TIME[2011-11-20 12:06:23 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20111118>

[83] [CITE[IRC logs: freenode / #whatwg / 20111129]]
( ([TIME[2011-11-29 08:57:16 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20111129>

[84] [CITE[IRC logs: freenode / #whatwg / 20111206]]
( ([TIME[2011-12-07 08:32:57 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20111206#l-1112>

[85] [CITE['''['''whatwg''']''' proposal: extend <time> to markup durations]]
([TIME[2011-12-07 09:36:37 +09:00]] 版)
<http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2011-December/034091.html>

[86] [CITE@en[Web Applications 1.0 r6845        Update the date-and-time microsyntaxes to support having the 'T' replaced by a single space. (Note: multiple spaces are invalid and will cause parse failures. Only a single space is supported.) Based on proposal and implementation evidence from Tantek documented at http://wiki.whatwg.org/wiki/Time_element#permit_space_instead_of_T_in_datetimesAffected topics: HTML, Microdata]]
( ([TIME[2011-12-07 08:00:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=6844&to=6845>

[87] [CITE[''''''[''''''whatwg'''''']'''''' proposal: extend <time> to markup durations]]
( ([TIME[2011-12-09 08:14:18 +09:00]] 版))
<http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2011-December/034091.html>

[88] [CITE@en[Web Applications 1.0 r7435       Make the year-only format for <time> more in line with how it works elsewhere.]]
( ([TIME[2012-10-06 07:50:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=7434&to=7435>

* 実装

[61] [CODE(HTMLe)@en[[[time]]]] [[要素]]を[[利用者]]の[[時間帯]]・[[ロケール]]の文字列として[[レンダリング]]する[[スクリプト]]。
「○分前」みたいな表示もできます。
<http://suika.fam.cx/www/style/ui/time.js.u8>

* 関連

[109] [CODE(HTMLa)@en[[[sortable]]]] な[[表]]の[[整列]]には、 [CODE(HTMLe)@en[[[time]]]]
[[要素]]の[[日時値]]が使われることがあります。

[65] [CODE(HTMLe)@en[[[time]]]] [[要素]]以前にも [[HTML]] には [CODE(HTMLe)@en[[[ins]]]]
[[要素]]と [CODE(HTMLe)@en[[[del]]]] [[要素]]に [CODE(HTMLa)@en[[[datetime]]]]
[[属性]]があり、編集の日時を表記するためにはこれが用いられていました。 [[CSS]]
によって [CODE(HTMLa)@en[[[datetime]]]] [[属性]]を[[レンダリング]]させている人もいました。

[9] [CODE(HTMLe)@en[[[time]]]] [[要素]]は[[文書]]中の[[日時]]を[[マーク付け]]するものですが、
[[フォーム]]において[[利用者]]に[[日時]]を入力させるものとしては
[CODE(HTML)@en[[[<input type=datetime>]]]]、
[CODE(HTML)@en[[[<input type=datetime-local>]]]]、
[CODE(HTML)@en[[[<input type=date>]]]]、
[CODE(HTML)@en[[[<input type=time>]]]] があります。

[10] [[文書]]の[[作成日時]]や[[変更日時]]を [[Dublin Core]] を用いて
[CODE(HTMLe)@en[[[meta]]]] [[要素]]に記述する人達もいました。

[89] [[HTML+RDFa 1.1]] は [CODE(HTMLe)@en[[[time]]]] [[要素]]の独自の解釈を規定しています。
([[RDFa処理器]]の項を参照。)

[112] [CODE(HTMLe)@en[[[data]]]] [[要素]]は、[CODE(HTMLe)@en[[[time]]]] 
[[要素]]を一般化して[[日時]]以外にも拡張したものです。 [CODE(HTMLe)@en[[[data]]]]
[[要素]]も[[日時]]の表記に利用できます。

[EG[
[113] 例えば [[HTML Standard]] には、 [[Unix time]] を [CODE(HTMLa)@en[[[value]]]]
[[属性]]に指定した [CODE(HTMLe)@en[[[data]]]] [[要素]]の例が掲載されています。
]EG]

[11] [CITE@en[HTML5TimeZone - Internationalization]]
([TIME[2014-08-27 19:33:53 +09:00]] 版)
<https://www.w3.org/International/wiki/HTML5TimeZone>

[12] [CITE@en[Fix #426, time element content model contradiction · whatwg/html@a14ca08]]
([TIME[2015-12-30 10:28:50 +09:00]] 版)
<https://github.com/whatwg/html/commit/a14ca08fae3b2d2feec88544dd24b2b3db21ae16>

[FIG(quote)[
[FIGCAPTION[
[13] [CITE@ja[【皇室ウイークリー】(番外編)佳子さまお誕生日〈45枚のお写真で振り返るこの1年〉(1/6ページ) - 産経ニュース]]
([[SANKEI DIGITAL INC.]] 著, [TIME[2015-12-29 07:04:50 +09:00]] 版)
<http://www.sankei.com/premium/news/151229/prm1512290006-n1.html>
]FIGCAPTION]

> 
> <time><!-- date --><span id="__r_publish_date__">2015.12.29 06:00</span><!-- date end --></time><span class="speech">更新</span>
> 

]FIG]


[FIG(quote)[
[FIGCAPTION[
[14] [CITE@ja[社労士:書き込み「社員うつにさせる方法」会員権停止に - 毎日新聞]]
([TIME[2015-12-08 15:44:48 +09:00]] 版)
<http://mainichi.jp/articles/20151230/k00/00m/040/090000c>
]FIGCAPTION]

> 
> <p class="post">毎日新聞<time>2015年12月30日 07時45分</time><time>(最終更新 12月30日 07時45分)</time></p>
> 

]FIG]


[FIG(quote)[
[FIGCAPTION[
[15] [CITE@ja[年賀状のサルを12年前と比べてみたら...デザイナーは同じ人、ヒツジでも話題に]]
([TIME[2015-12-31 14:21:46 +09:00]] 版)
<http://www.huffingtonpost.jp/2015/12/30/new-years-card-monkey-2004-and-2016_n_8893298.html>
]FIGCAPTION]

> 
>                                 <time datetime="2015-12-31">2015年12月31日</time>

]FIG]


[FIG(quote)[
[FIGCAPTION[
[18] [CITE@ja[年賀状のサルを12年前と比べてみたら...デザイナーは同じ人、ヒツジでも話題に]]
([TIME[2015-12-31 14:25:31 +09:00]] 版)
<http://www.huffingtonpost.jp/2015/12/30/new-years-card-monkey-2004-and-2016_n_8893298.html>
]FIGCAPTION]

> 
>         投稿日: <time datetime="2015-12-30T05:14:20-05:00">
>             2015年12月30日 19時14分 JST        </time>

]FIG]


[FIG(quote)[
[FIGCAPTION[
[19] [CITE@ja[時事ドットコム:文化庁の京都移転有力に=「一部機能」軸に検討-政府]]
([TIME[2015-12-31 14:45:39 +09:00]] 版)
<http://www.jiji.com/jc/zc?k=201512/2015123000492&g=pol>
]FIGCAPTION]

> との期待もあり、石破氏の手腕が問われている。 <span id="pub_time">(2015/12/30-17:59)</span><span style="visibility: hidden;"><time itemprop="datePublished" datetime="2015-12-30 17:59" pubdate="pubdate">2015/12/30-17:59</time></span></p></div>

]FIG]


[FIG(quote)[
[FIGCAPTION[
[20] [CITE[今年も来年もアニメはMX! 今年もアニメ攻勢がすごいTOKYO MXの年末年始特番、そして2016年について聞いてみた!!|おたぽる]]
([TIME[2015-12-31 15:00:36 +09:00]] 版)
<http://otapol.jp/2015/12/post-5150.html>
]FIGCAPTION]

> 
> <div class="entryDate smallFont" itemprop="datePublished" content="2015-12-28">2015.12.28</div>

]FIG]


[FIG(quote)[
[FIGCAPTION[
[21] [CITE@ja[二次創作について - カクヨムヘルプセンター]]
([TIME[2016-01-01 15:12:46 +09:00]] 版)
<https://kakuyomu.jp/help/entry/fan_fiction_sources>
]FIGCAPTION]

> 
>           <time pubdate datetime="2015-12-09T06:16:36Z" title="2015-12-09T06:16:36Z">
>             <span class="date-year">2015</span><span class="hyphen">-</span><span class="date-month">12</span><span class="hyphen">-</span><span class="date-day">09</span>
>           </time>

]FIG]