ids/8/458.txt

[7] [[HTML]] ではいくつかの[[属性]]などで[[日時]]を表す文字列が用いられています。
そのほとんどは [[ISO 8601の日付形式]]に近いものですが、歴史的な理由により異なる書式を採用している文脈もあります。

[[HTML]] で定義されている[[日付形式]]には、次のものがあります。
- [[時刻]]
- [[月]]
- [[日付]]
- [[地方日時]]
- [[大域日時]]
- [[日付か時刻]]
- [[週]]
- [CODE(DOMa)@en[[[lastModified]]]] の書式 → [CODE(DOMa)@en[[[lastModified]]]] の項を参照。

[8] 仕様書:
- [[HTML5]] <http://www.whatwg.org/specs/web-apps/current-work/#dates-and-times>

;; [51] 本項では [[HTML5]] の定義に基づき説明しますが、
構文の定義や算法の定義は必ずしも仕様書の通りではありません。仕様書の規定と等価な別な表現で説明していることがあります。

* 定義

[10] [DFN[[RUBYB[数字]@en[digit]]]]とは、
[CODE(char)[[[U+0030]]]]〜[CODE(char)[[[U+0039]]]] の[[文字]]であって、
[[十進数]]を表すために使われます [SRC@en[[[HTML5]]]]。 

[9] ある[[年]]のある[[月]]の[[日]]の数は、[[グレゴリオ暦]]に基づき、次のように定義されています
[SRC@en[[[HTML5]]]]。
- [[1月]]、[[3月]]、[[5月]]、[[7月]]、[[8月]]、[[10月]]、[[12月]]は、 '''31'''
- [[4月]]、[[6月]]、[[9月]]、[[11月]]は、 '''30'''
- [[2月]]は、
-- [[年]]が400で割り切れるか、または4で割り切れて100で割り切れないなら
([[閏年]]なら)、 '''29'''
-- それ以外なら、 '''28'''

* 時刻

[20] [DFN[[RUBYB[時刻]@en[time]]]]は、特定の[[時刻]]を表し、
[[時]]、[[分]]、[[秒]]、[[秒の小数部]]から成ります。[[時間帯]]の情報は持ちません。
[SRC@en[[[HTML5]]]]

-[21] [CODE(ABNF)[[DFN[[RUBYB[妥当な時刻文字列]@en[valid time string]]]] := 2[[数字]] ":" 2[[数字]] [":" 2[[数字]] ["." 1*[[数字]] ] ] ]]
[SRC@en[[[HTML5]]]]
-- 1つ目の[[数字]]列は、[[時]]を表す 0〜23 の[[数]]
-- 2つ目の[[数字]]列は、[[分]]を表す 0〜59 の[[数]]
-- 3つ目の[[数字]]列は、[[秒]]の[[整数部]]を表す 0〜59 の[[数]] ([[秒]]が 0 の時だけ省略可能)
-- 4つ目の[[数字]]列は、[[秒]]の[[小数部]]を表す値 ([[秒]]が[[整数]]の時だけ省略可能)

[23] [DFN[[RUBYB[時刻文字列の構文解析]@en[parse a time string]]]]
[SRC@en[[[HTML5]]]]:
= [[時刻部品の構文解析]]を行い、それが何も返さなかったら、何も返さないで終える
= [[文字列]]がそれで終わっていなければ、何も返さないで終える
= (1) で得られた[[時]]と[[分]]と[[秒]]を返す

[24] [DFN[[RUBYB[時刻部品の構文解析][parse a time component]]]]
[SRC@en[[[HTML5]]]]:
= [[文字列]]が[[正規表現]] [CODE(regexp)[([[数字]]{2}):([[数字]]{2})(?::([[数字]]{2}(?:\.[[数字]]+)?))?]] 
に[[一致]]しない場合、何も返さず終わる
= $1 を[[十進数]]として解釈したものを[[時]]とする
= $2 を[[十進数]]として解釈したものを[[分]]とする
= $3 を[[十進数]]として解釈したものを[[秒]]とする ($3 がない場合、 0 とする)
= [[時]]が 0〜23 でない場合、何も返さない
= [[分]]が 0〜59 でない場合、何も返さない
= [[秒]]が 60 [[未満]]の[[正数]]でない場合、何も返さない
= [[時]]と[[分]]と[[秒]]を返す


** 文脈

[54] [CODE(HTMLa)@en[[[type]]]] が [CODE(HTML)@en[[[time]]]] の [CODE(HTMLe)@en[[[input]]]]
[[要素]]で使われます。

* 月

[11] [DFN[[RUBYB[月]@en[month]]]]は、[[グレゴリオ暦]]上の[[日付]]を表します。ただし、
[[月]]は[[時間帯]]の情報を持ちませんし、[[日付]]の精度は[[年]]と[[月]]だけで、[[日]]は特定しません。
[SRC@en[[[HTML5]]]]

- [13] [CODE(ABNF)[[DFN[[RUBYB[妥当な月]@en[valid month]]]] := 4*[[数字]] "-" 2[[数字]]]]
[SRC@en[[[HTML5]]]]
-- 1つ目の[[数字]]列は、[[年]]を表す[[正数]]
-- 2つ目の[[数字]]列は、[[月]]を表す 1〜12 の[[数]]

[14] [DFN[[RUBYB[月文字列の構文解析]@en[parse a month string]]]]
[SRC@en[[[HTML5]]]]:
= [[月部品の構文解析]]を行い、それが何も返さなかったら、何も返さないで終える
= [[文字列]]がそれで終わっていなければ、何も返さないで終える
= (1) で得られた[[年]]と[[月]]を返す

[15] [DFN[[RUBYB[月部品の構文解析][parse a month component]]]]
[SRC@en[[[HTML5]]]]:
- 与えられた[[文字列]]が[[正規表現]] [CODE(regexp)[([[数字]]{4,})-([[数字]]{2})]]
に[[一致]]すれば、
-= $1 を[[十進数]]として解釈したものを[[年]]とする
-= $2 を[[十進数]]として解釈したものを[[月]]とする
-= [[年]]が 0 なら、何も返さない
-= [[月]]が 1〜12 でなければ、何も返さない
-= そうでない場合、[[年]]と[[月]]を返す
- そうでない場合、何も返さない

** 文脈

[52] [CODE(HTMLa)@en[[[type]]]] が [CODE(HTML)@en[[[month]]]] の [CODE(HTMLe)@en[[[input]]]] [[要素]]で使用されます。

* 日付

[16] [DFN[[RUBYB[日付]@en[date]]]]は、[[グレゴリオ暦]]上の[[日付]]を表します。
[[日付]]には[[年]]、[[月]]、[[日]]が含まれますが、[[時間帯]]は含まれません。
[SRC@en[[[HTML5]]]]

-[17] [CODE(ABNF)@en[[DFN[[RUBYB[妥当な日付文字列]@en[valid date string]]]] := [[妥当な月文字列]] "-" 2[[数字]]]]
[SRC@en[[[HTML5]]]]
-- 最後の[[数字]]列は、[[年]]と[[月]]に基づく[[日]]の数 (>>9) [[以下]]の[[正数]]で、[[日]]を表す

[18] [DFN[[RUBYB[日付文字列の構文解析]@en[parse a date string]]]]
[SRC@en[[[HTML5]]]]:
= [[日付部品の構文解析]]を行い、それが何も返さなかったら、何も返さないで終える
= [[文字列]]がそれで終わっていなければ、何も返さないで終える
= (1) で得られた[[年]]と[[月]]と[[日]]を返す

[19] [DFN[[RUBYB[日付部品の構文解析][parse a date component]]]]
[SRC@en[[[HTML5]]]]:
= [[月部品の構文解析]]により、[[年]]と[[月]]を得る。何も返されなかった場合、何も返さず終わる
= [[文字列]]の続きが[[正規表現]] [CODE(regexp)[-([[数字]]{2})]] に[[一致]]しない場合、何も返さず終わる
= $1 を[[十進数]]として解釈したものを[[日]]とする
= [[日]]が[[年]]と[[月]]に基づく[[日]]の数 (>>9) [[以下]]の[[正数]]でなければ、何も返さず終わる
= [[年]]と[[月]]と[[日]]を返す

** 文脈

[53] [CODE(HTMLa)@en[[[type]]]] が [CODE(HTML)@en[[[date]]]] の [CODE(HTMLe)@en[[[input]]]]
[[要素]]で使われます。

* 地方日時

[25] [DFN[[RUBYB[地方日時]@en[local date and time]]]]は、
[[グレゴリオ暦]]上の[[日時]]を表します。
[[年]]、[[月]]、[[日]]、[[時]]、[[分]]、[[秒]]、[[秒の小数部]]から成ります。
[[時間帯]]の情報は含みません。
[SRC@em[[[HTML5]]]]

-[26] [CODE(ABNF)@en[[DFN[[RUBYB[妥当な地方日時文字列]@en[valid local date and time string]]]] := [[妥当な日時文字列]] 'T' [[妥当な時刻文字列]]]]
[SRC@em[[[HTML5]]]]
-- 「T」は[[大文字]]でなければなりません。

[27] [DFN[[RUBYB[地方日時文字列の構文解析]@en[parse a local date and time string]]]] [SRC@en[[[HTML5]]]]:
= [[日付部品の構文解析]]により、[[年]]と[[月]]と[[日]]を得る。何も返されなかった場合、
何も返さず終わる
= [[文字列]]の次の[[文字]]が[[大文字]]の「[CODE(char)[[[T]]]]」でない場合、
何も返さず終わる
= [[時刻部品の構文解析]]により、[[時]]と[[分]]と[[秒]]を得る。何も返されなかった場合、
何も返さず終わる
= [[文字列]]がそれで終わっていなければ、何も返さず終わる
= [[年]]と[[月]]と[[日]]と[[時]]と[[分]]と[[秒]]を返す


** 文脈

[55] [CODE(HTMLa)@en[[[type]]]] が [CODE(HTML)@en[[[datetime-local]]]] の [CODE(HTMLe)@en[[[input]]]]
[[要素]]で使われます。

* 時間帯

[28] [[大域日時]]や[[日付や時刻]]には[RUBYB[[[時間帯]]]@en[timezone]]の情報を含めることができます。
[[時間帯]]には、[[時]]と[[分]]の情報が含まれます。

- [CODE(ABNF)@en[[DFN[時間帯]] := '[[Z]]' / ("[[+]]" / "[[-]]") 2[[数字]] ":" 2[[数字]]]]
[SRC@en[[[HTML5]]]]
-- 「[CODE(char)[[[Z]]]]」は [[UTC]] を表す
-- 1つ目の[[数字]]列は[[時差]]の[[時]]を表す 0〜23 の[[数]]
-- 2つ目の[[数字]]列は[[時差]]の[[分]]を表す 0〜59 の[[数]]

[29] [DFN[[RUBYB[時間帯部品の構文解析]@en[parse a timezone component]]]] [SRC@en[[[HTML5]]]]:
= 次の[[文字]]が[[大文字]]の「[CODE(char)[[[Z]]]]」 であれば、
[[時]]として 0、[[分]]として 0 を返して終わる
= [[文字列]]が[[正規表現]] [CODE(regexp)[([+-]2[[数字]]):(2[[数字]])]] に[[一致]]しない場合、
何も返さずに終わる
= $1 を[[十進数]]として解釈したものを[[時]]とする
= $2 を[[十進数]]として解釈したものを[[分]]とする
= [[時]]が -23〜23 でない場合、何も返さない
= [[分]]が 0〜59 でない場合、何も返さない
= [[時]]と[[分]]を返す

[30] [[RFC 3339の日付形式]]などでは [[-00:00]] に[[時間帯]]不明という意味が与えられていますが、
[[HTML]] の[[日付形式]]では特にそのような規定はありません。

* 大域日時

[31] [DFN[[RUBYB[大域日時]@en[global date and time]]]]は、
[[グレゴリオ暦]]上の[[日時]]を表します。
[[年]]、[[月]]、[[日]]、[[時]]、[[分]]、[[秒]]、[[秒の小数部]]、[[時間帯]]から成ります。
[SRC@em[[[HTML5]]]]

-[32] [CODE(ABNF)@en[[DFN[[RUBYB[妥当な大域日時文字列]@en[valid global date and time string]]]] := [[妥当な日時文字列]] '[[T]]' [[妥当な時刻文字列]] [[時間帯]]]]
[SRC@em[[[HTML5]]]]
-- 「[CODE(char)[[[T]]]]」は[[大文字]]でなければなりません。

[33] [DFN[[RUBYB[大域日時文字列の構文解析]@en[parse a global date and time string]]]] [SRC@en[[[HTML5]]]]:
= [[日付部品の構文解析]]により、[[年]]と[[月]]と[[日]]を得る。何も返されなかった場合、
何も返さず終わる
= [[文字列]]の次の[[文字]]が[[大文字]]の「[CODE(char)[[[T]]]]」でない場合、
何も返さず終わる
= [[時刻部品の構文解析]]により、[[時]]と[[分]]と[[秒]]を得る。何も返されなかった場合、
何も返さず終わる
= [[時間帯部品の構文解析]]により、[[時間帯]]の[[時]]と[[分]]を得る。何も返されなかった場合、
何も返さず終わる
= [[文字列]]がそれで終わっていなければ、何も返さず終わる
= [[年]]~[[秒]]を、[[時間帯]]の情報を使って [[UTC]] に換算する
= [[年]]と[[月]]と[[日]]と[[時]]と[[分]]と[[秒]]と[[時間帯]]の[[時]]と[[分]]を返す


** 文脈

[56] [CODE(HTMLa)@en[[[type]]]] が [CODE(HTML)@en[[[datetime]]]] の [CODE(HTMLe)@en[[[input]]]]
[[要素]]で使われます。

[57] [CODE(HTMLe)@en[[[ins]]]] [[要素]]や [CODE(HTMLe)@en[[[del]]]] [[要素]]の
[CODE(HTMLa)@en[[[datetime]]]] [[属性]]で使われます。

** 例

[34] [CODE(HTML example)[0037-12-13T00:00Z]] [SRC@en[[[HTML5]]]]

[[ローマ皇帝]][[ネロ]]の[[誕生日]] ([[ユリウス暦]]37年12月15日の[[グレゴリオ暦]]換算) 
の[[真夜中]]を表します。なお、
[CODE(HTML bad example)[[[37-12-13]]]] は[[年]]が4桁に満たないので、
[[妥当な大域日時文字列]]ではありません。

[35] [CODE(HTML example)[1979-10-14T12:00:00.001-04:00]] [SRC@en[[[HTML5]]]]

[[北米東海岸]]の[[夏時刻]]中の1979年10月14日の[[正午]]から1[[ミリ秒]]後を表します。

[36] [CODE(HTML example)[8592-01-01T02:09+02:09]] [SRC@en[[[HTML5]]]]

将来の[[時刻]]です。端数の[[時間帯]]は現在[[地球上]]では用いられていませんが、
仕様上は認められています。

* 日付か時刻

[47] [DFN[[RUBYB[日付か時刻の文字列]@en[date or time string]]]]は、
[[日付]]か[[時刻]]か[[大域日時]]のいずれかです。
[SRC@en[[[HTML5]]]]

-[48] [CODE(ABNF)[[DFN[[RUBYB[妥当な日付か時刻の文字列]@en[valid date or time string]]]] := [[妥当な日付文字列]] / [[妥当な時刻文字列]] / [[妥当な大域日時文字列]]]]
-[49] [CODE(ABNF)[[DFN[[RUBYB[妥当な内容中の日付か時刻の文字列]@en[valid date or time string in content]]]] := *[[White_Space]] [[妥当な日付か時刻の文字列]] *[[White_Space]]]]

[50] [DFN[[RUBYB[日付か時刻の文字列の構文解析][parse a date or time string]]]] [SRC@en[[[HTML5]]]]:
= 先頭と末尾から [[White_Space]] を除去する (「内容中」の場合のみ)
= [[大域日時文字列の構文解析]]が値を返すなら、それを返して終わる
= [[日付の構文解析]]が値を返すなら、それを返して終わる
= [[時刻の構文解析]]が値を返すなら、それを返して終わる
= 何も返さないで終わる


** 文脈

[59] [CODE(HTMLe)@en[[[time]]]] [[要素]]で使われます。
[CODE(HTMLa)@en[[[datetime]]]] [[属性]]では[[妥当な日付か時刻の文字列]]、
[[内容]]では[[妥当な内容中の日付か時刻の文字列]]の定義が用いられます。

* 週

[43] [DFN[[RUBYB[週]@en[week]]]]は、
[RUBYB[[[週年]]]@en[week‐year]]番号と週番号から成り、
7日間の期間を表します。 [SRC@en[[[HTML5]]]]

[[週]]は次のようなものです [SRC@en[[[HTML5]]]]。
- 1つの[[週年]]は52か53の[[週]]を含みます。
-- [[木曜日]]から始まる[[年]]と[[閏年]]は '''53''' です。
-- それ以外の[[年]]は '''52''' です。
-- なお、[[週年]]の最後の[[日]]を含む[[週]]の番号が[DFN[[RUBYB[最終日の週番号]@en[week number of the last day]]]]です。
- [[週]]は7日間の期間です。
- [[1970年]]の 1 番の[[週]]は[[1969年]]12月29日 ([[月曜日]]) に始まります。

;; [[グレゴリオ暦]]における[[年]]の中で最初の[[木曜日]]を含む[[週]]が、
ある[[週年]]の最初の[[週]]になります。 [SRC@en[[[HTML5]]]]

[61] つまり、[[週]]は[[月曜日]]に始まり[[日曜日]]に終わります。

[62] [[1月1日]]が[[月曜日]]〜[[木曜日]]なら[[1月1日]]はその[[年]]と同じ[[週年]]の最初の[[週]]に属しますが、
[[金曜日]]〜[[日曜日]]なら[[年]]の1つ前の[[週年]]の最後の[[週]]に属します。
[[12月29日]]〜[[12月31日]]は次の[[年]]と同じ[[週年]]に属する可能性があります。
[[1月1日]]〜[[1月3日]]は前の[[年]]と同じ[[週年]]に属する可能性があります。

-[44] [CODE(ABNF)[[DFN[[RUBYB[妥当な週文字列]@en[valid week string]]]] := 4*[[数字]] '-W' 2[[数字]]]]
[SRC@en[[[HTML5]]]]
-- 1つ目のの[[数字]]列は[[週年]]を表す[[正数]]
-- 2つ目の[[数字]]列は[[週]]を表す[[最終日の週番号]][[以下]]の[[正数]]

[45] [DFN[[RUBYB[週文字列の構文解析]@en[parse a week string]]]] [SRC@en[[[HTML5]]]]:
= 与えられた[[文字列]]''全体''が[[正規表現]] [CODE(regexp)[([[数字]]{4,})-W([[数字]]{2})]]
に[[一致]]しない場合、何も返さないで終わる
= $1 を[[十進数]]として解釈したものを[[週年]]とする
= $2 を[[十進数]]として解釈したものを[[週]]とする
= [[週年]]が 0 なら、何も返さないで終わる
= [[週]]が 1〜[[最終日の週番号]] でなければ、何も返さないで終わる
= [[週年]]と[[年]]を返す


** 文脈

[58] [CODE(HTMLa)@en[[[type]]]] が [CODE(HTML)@en[[[week]]]] の [CODE(HTMLe)@en[[[input]]]]
[[要素]]で使われます。

* 暦法との関係

** 過去の日付

[12] [[HTML]] は[[グレゴリオ暦]] (だけ) を採用しています。[[グレゴリオ暦]]が採用される以前の[[日付]]も表すことができますが、
[[グレゴリオ暦]]を過去に延長した場合に相当する[[日付]]を使って表されます
([[先発グレゴリオ暦]] (proleptic グレゴリオ暦) などと呼ばれます)。

[39] [[年]]は[[正数]]のみを指定できます。0年や負の年は認められていません。

** 将来の日付

[37] 現在の版の [[HTML5]] では、[[年]]の桁数が4桁以上で無制限とされており、[[1万年問題]]は存在しません。

[38] 過去の版の [[HTML5]] 案や [[Web Forms 2.0]] や [[HTML4]] では[[年]]は4桁に制限されていました。

** 閏秒

[22] [[HTML]] の[[日付形式]]は[[閏秒]]に対応していません。[[秒]]の部分に 60 や 61
を使うことは認められていません。

* 歴史

[46] [[HTML]] の[[日付形式]]は、 [[HTML 4.0]] で [CODE(HTMLa)@en[[[datetime]]]]
[[属性]]が導入されたことではじめて規定され、後に [[Web Forms 2.0]] と [[HTML5]]
により拡張され現在に至っています。

** [CODE(SGML)[%Datetime;]] 型 (HTML4/XHTML1)

[1] [[HTML 4]] の [DFN[[CODE(SGML)[%Datetime]]]] 型は、
[[W3C-DTF]] の2番目に長い (秒未満までは表現できない)
形式です。

[6] 仕様書:
- [[HTML 4]]
-- <IW:HTML4:"types.html#type-datetime">
-- [[厳密DTD]]  <IW:HTML4:"sgml/dtd.html#Datetime">
-- [[移行用DTD]]  <IW:HTML4:"sgml/loosedtd.html#Datetime">
-[[XHTML 1.0]]
-- [CSECTION[A.1.1. XHTML-1.0-Strict]]
<http://www.w3.org/TR/2002/REC-xhtml1-20020801/dtds.html#dtdentry_xhtml1-strict.dtd_Datetime>
-- [CSECTION[A.1.2. XHTML-1.0-Transitional]]
<http://www.w3.org/TR/2002/REC-xhtml1-20020801/dtds.html#dtdentry_xhtml1-transitional.dtd_Datetime>
-- [CSECTION[A.1.3. XHTML-1.0-Frameset]]
<http://www.w3.org/TR/2002/REC-xhtml1-20020801/dtds.html#dtdentry_xhtml1-frameset.dtd_Datetime>
- [[XHTML m12n]]
--[CSECTION[4.3. Attribute Types]]
<IW:XHTML1m12n:"abstraction.html#dt_Datetime">

[5]
:[[引数実体名]]:[CODE(SGML)[%Datetime]] ([[HTML 4]], [[XHTML 1.0]])
:抽象属性型名:[CODE[Datetime]] ([[XHTML m12n]])
:属性型名:[Q[datetime]] ([[HTML 4]])
:[[SGML]] [[属性型]]:[CODE(SGML)[[[CDATA]]]]
:[[XML]] [[属性型]]:[CODE(XML)[[[CDATA]]]]
:大文字・小文字:区別あり

[2] 大文字・小文字は区別されます。
[CODE(HTML)[T]] と [CODE(HTML)[Z]] が使われ得ますが、
いずれも大文字でなければなりません。

[3] 時・分・秒が得られない時は、 [CODE(HTML)[00]]
としてもよいことになっています。
閏秒の 60秒は W3C‐DTF では表現できません。

[4]
[CODE(HTMLe)[[[ins]]]] 要素や [CODE(HTMLe)[[[del]]]] 要素の [CODE(HTMLa)[[[datetime]]]] 属性が [CODE(SGML)[%Datetime]] 型です。

** HTML5 案

[40] 現在 [[HTML]] で定義されている[[日付形式]]のほとんどは、 [[Web Forms 2.0]]
で[[日時]]関係の[[フォーム制御子]]を実現するために導入されました。

[41] [[HTML5]] では [[HTML4]] から引き継いだ [CODE(HTMLe)@en[[[ins]]]] [[要素]]や
[CODE(HTMLe)@en[[[del]]]] [[要素]]の [CODE(HTMLa)@en[[[datetime]]]] [[属性]]のための[[日付形式]] 
(現在の[[大域日時]]) に加え、
[CODE(HTMLe)@en[[[time]]]] [[要素]]のための[[日付や時刻]]の書式が導入されました。

[42] その後 [[Web Forms 2.0]] が [[HTML5]] に統合された際に、これらの定義は整理され、
本稿で紹介したような形になりました。この時、[[1万年問題]]への対応など細かい点が改められています。

* 関連

[60] [[時刻]]でなく[[時間]]を表すものとしては、
[CODE(HTMLa)@en[[[http-equiv]]]] [[属性]]が [CODE(HTTP)@en[[[Refresh]]]]
の場合の [CODE(HTMLa)@en[[[content]]]] [[属性値]]の書式 ([[秒]]数を指定) があります。

以前の [[HTML5]] 案には [CODE(HTMLe)@en[[[audio]]]] [[要素]]や [CODE(HTMLe)@en[[[video]]]] [[要素]]に[[媒体]]中の[[時間]]的位置を表す[[内容属性]]がありましたが、
既に削除されています。
[[秒]]数を返す [[DOM属性]]は削除されずに残っています。