構文定義

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

最短形

[104] 妥当な正規化済み地方日時文字列や妥当な正規化済みUTC大域日時文字列では、 妥当な時刻文字列の最短形を使うことになっています。これはすなわち、

• [105] 秒の小数部は、小さい方の桁が 0 なら、それを省略します。
• [107] 秒の小数部が 0 なら、 . と小数部を省略します。
• [106] 秒が整数部も小数部も 0 なら、 : と秒を省略します。

構文解析

[23] 時刻文字列の構文解析 (parse a time string) HTML5:

1. 時刻部品の構文解析を行い、それが何も返さなかったら、何も返さないで終える
2. 文字列がそれで終わっていなければ、何も返さないで終える
3. (1) で得られた時と分と秒を返す

[24] 時刻部品の構文解析 (parse a time component) HTML5:

1. 文字列が正規表現 (数字{2}):(数字{2})(?::(数字{2}(?:\.数字+)?))? に一致しない場合、何も返さず終わる
2. $1 を十進数として解釈したものを時とする
3. $2 を十進数として解釈したものを分とする
4. $3 を十進数として解釈したものを秒とする ($3 がない場合、 0 とする)
5. 時が 0〜23 でない場合、何も返さない
6. 分が 0〜59 でない場合、何も返さない
7. 秒が 60 未満の正数でない場合、何も返さない
8. 時と分と秒を返す

数値表現

[63] valueAsNumber DOM属性では、 1970年1月1日の0時0分 (UTC) からのミリ秒の数によって表現されます。 HTML5

[64] valueAsDate DOM属性では、 1970年1月1日における時刻 (UTC) とした Date 物体によって表現されます。 HTML5

[65] 時刻を入力する input 要素の step 属性では、 時間が秒単位の数によって表現されます。 HTML5

文脈

[54] type が time の input 要素で使われます。

[130] time 要素で使われます。

[131] 妥当な大域日時文字列や妥当な地方日時文字列や妥当な日付文字列と省略可能な時刻の定義で用いられています。

[132] 時間帯で使われる時分の表記と似ていますが、異なるものとして定義されています。

構文

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

構文解析

[18] 日付文字列の構文解析 (parse a date string) HTML5:

1. 日付部品の構文解析を行い、それが何も返さなかったら、何も返さないで終える
2. 文字列がそれで終わっていなければ、何も返さないで終える
3. (1) で得られた年と月と日を返す

[19] 日付部品の構文解析 (parse a date component) HTML5:

1. 月部品の構文解析により、年と月を得る。何も返されなかった場合、何も返さず終わる
2. 文字列の続きが正規表現 -(数字{2}) に一致しない場合、何も返さず終わる
3. $1 を十進数として解釈したものを日とする
4. 日が年と月に基づく日の数 (>>9) 以下の正数でなければ、何も返さず終わる
5. 年と月と日を返す

数値表現

[70] valueAsNumber DOM属性では、 1970年1月1日の0時0分 (UTC) からその日の真夜中 (UTC) までのミリ秒の数によって表現されます。 HTML5

[71] valueAsDate DOM属性では、 その日の真夜中 (UTC) を表す Date 物体によって表現されます。 HTML5

[72] 日付を入力する input 要素の step 属性では、 時間が日単位の数によって表現されます。 HTML5

文脈

[53] type が date の input 要素で使われます。

[126] time 要素で使われます。

[127] autofill の定義で使われます。

[128] 妥当な大域日時文字列、妥当な地方日時文字列、妥当な日付文字列と省略可能な時刻の一部として使われます。

[129] vCard、vEvent のマイクロデータで使われます。

関連

[45] JavaScript では、 Date オブジェクトの toISODateString メソッドにより取得できます。 (厳密には定義が異なりますが、実用上は無視できる程度の違いです。)

構文定義

[26] 妥当な地方日時文字列 (valid local date and time string) は、 次のような文字列です >>8。

[102] 妥当な正規化済み地方日時文字列 (valid normalized local date and time string) は、 >>26 のうち、 >>98 が T であり、 >>99 が最短形のものです >>8。

構文解析

[27] 地方日時文字列の構文解析 (parse a local date and time string) は、 次のように行います >>8。

数値表現

[73] valueAsNumber DOM属性では、 1970年1月1日の0時0分からのミリ秒の数によって表現されます。 HTML5

[74] valueAsDate DOM属性での表現は定義されていません。 HTML5

[75] 地方日時を入力する input 要素の step 属性では、 時間が秒単位の数によって表現されます。 HTML5

文脈

[55] type が datetime-local の input 要素で使われます。

[133] time 要素で使われます。

関連

[146] ISO 8601の日付形式 (>>25)に、類似形式との比較があります。

構文定義

[32] 妥当な大域日時文字列 (valid global date and time string) は、次のような文字列です >>8。

構文解析

[33] 大域日時文字列の構文解析 (parse a global date and time string) HTML5:

1. 日付部品の構文解析により、年と月と日を得る。何も返されなかった場合、 何も返さず終わる
2. 文字列の次の文字が大文字の「T」か U+0020 でない場合、 何も返さず終わる
3. 時刻部品の構文解析により、時と分と秒を得る。何も返されなかった場合、 何も返さず終わる
4. 時差部品の構文解析により、時間帯の時と分を得る。何も返されなかった場合、 何も返さず終わる
5. 文字列がそれで終わっていなければ、何も返さず終わる
6. 年~秒を、時間帯の情報を使って UTC に換算する
7. 年と月と日と時と分と秒と時間帯の時と分を返す

数値表現

[76] valueAsNumber DOM属性では、 1970年1月1日の0時0分 (UTC) からのミリ秒の数によって表現されます。 HTML5

[77] valueAsDate DOM属性では、 UTC におけるその時刻を表す Date 物体によって表現されます。 HTML5

[78] 大域日時を入力する input 要素の step 属性では、 時間が秒単位の数によって表現されます。 HTML5

文脈

[56] type が datetime の input 要素で使われます。

[57] ins 要素や del 要素の datetime 属性で使われます。

[136] time 要素で使われます。

[139] vCard マイクロデータの rev の値で使われます。

[138] vEvent マイクロデータの created, last-modified の値で使われます。

[137] 妥当な日付文字列と省略可能な時刻やHTMLの時刻の範囲の形式で使われます。

レンダリング

[140] ins/del の datetime 属性では、指定された時間帯で表示するべきとされています。

関連

[147] ISO 8601の日付形式 (>>25)に、類似形式との比較があります。

[44] JavaScript では、 Date オブジェクトの toISOString メソッドにより取得できます。 (厳密には定義が異なりますが、実用上は無視できる程度の違いです。)

例

[34] 0037-12-13T00:00Z HTML5

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

[35] 1979-10-14T12:00:00.001-04:00 HTML5

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

[36] 8592-01-01T02:09+02:09 HTML5

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

過去の日付

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

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

将来の日付

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

閏年

[95] HTMLの日付形式は先発グレゴリオ暦に従って閏年に対応しています。

[96] 年を含んでいない妥当な月日文字列については、閏年同様2月29日 (--02-29) が認められています。

閏秒

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

%Datetime; 型 (HTML4/XHTML1)

[1] HTML 4 の %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
  • A.1.1. XHTML-1.0-Strict http://www.w3.org/TR/2002/REC-xhtml1-20020801/dtds.html#dtdentry_xhtml1-strict.dtd_Datetime
  • A.1.2. XHTML-1.0-Transitional http://www.w3.org/TR/2002/REC-xhtml1-20020801/dtds.html#dtdentry_xhtml1-transitional.dtd_Datetime
  • 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
  • 4.3. Attribute Types IW:XHTML1m12n:"abstraction.html#dt_Datetime"

[5]

引数実体名

%Datetime (HTML 4, XHTML 1.0)

抽象属性型名

Datetime (XHTML m12n)

属性型名

datetime (HTML 4)

SGML 属性型

CDATA

XML 属性型

CDATA

大文字・小文字

区別あり

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

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

[4] ins 要素や del 要素の datetime 属性が %Datetime 型です。

HTML5

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

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

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

[29] フォーム制御子用の日時の値は、 WF2 で当初から規定されていました。 <input type> ごとに (現在とほぼ同じ) 多数の形式が用意されていました。 最初は、完全に ISO 8601 を参照していました >>30。 後の版では、 ISO 8601 を参照しつつ、構文が明示的に定義されていた一方で、 構文解析の方法はまだ明確にされていませんでした >>28。

[13] ins 要素と del 要素は、 2005年4月16日版 (現存せず) WA1 で追加されました。 datetime 属性もこのときに追加されました。

[15] この当時は、属性値の適合性は、 妥当な大域日時文字列に相当するものが直接規定されていました。 一方で構文解析は ISO 8601 を参照する形になっており、 ISO 8601 に従い解釈できない場合は無視することとされていました。 >>14

[82] Issues relating to the syntax of dates and times (Ian Hickson <ian@...> 著, 2008-11-25 11:22:31 +09:00 版) http://permalink.gmane.org/gmane.org.w3c.whatwg.discuss/16763

[83] (X)HTML5 Tracking (2009-08-23 10:09:22 +09:00 版) http://html5.org/tools/web-apps-tracker?from=2380&to=2381

[84] (X)HTML5 Tracking (2009-08-23 10:11:22 +09:00 版) http://html5.org/tools/web-apps-tracker?from=2381&to=2382

[85] (X)HTML5 Tracking (2009-10-18 17:21:48 +09:00 版) http://html5.org/tools/web-apps-tracker?from=3717&to=3718

[87] (X)HTML5 Tracking (2009-10-25 11:25:22 +09:00 版) http://html5.org/tools/web-apps-tracker?from=4317&to=4318

[88] Web Applications 1.0 r6235 Define the serialisation requirments for type=datetime. ( (2011-06-16 08:13:00 +09:00 版)) http://html5.org/tools/web-apps-tracker?from=6234&to=6235

[89] Basic Data Types and Interfaces – SVG 1.1 (Second Edition) ( (2011-08-10 12:35:27 +09:00 版)) http://www.w3.org/TR/2011/REC-SVG11-20110816/types.html#DataTypeTime

[90] Web Applications 1.0 r6892 Limit the number of digits in the fraction part of a seconds time component to 3, since more than that and you lose precision when converting to milliseconds, e.g. for use with Date objects in the API. ( (2012-01-12 08:14:00 +09:00 版)) http://html5.org/tools/web-apps-tracker?from=6891&to=6892

[91] [whatwg] Time Parsing (2012-01-12 09:07:23 +09:00 版) http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2012-January/034344.html

[92] Web Applications 1.0 r6893 Define how to convert a time to a Date object if it's not a round number of milliseconds. ( (2012-01-12 09:03:00 +09:00 版)) http://html5.org/tools/web-apps-tracker?from=6892&to=6893

[9] Sort out the handling of seconds in "parse a time component" · whatwg/html@06059a8 (2016-03-08 18:27:51 +09:00 版) https://github.com/whatwg/html/commit/06059a864e93441cb85d10d719cf306985aa1c48

[43] RFC 3339 デマについては RFC 3339の日時形式を参照。

[47] W3C の HTML 5.2 などでは年の値域がおかしい問題があるようですが、 誰も W3C の HTML 5.x は相手にしていないので、 無視して大丈夫です。 (問題があることを知っている人すらほとんどいない。)