Edit

Page

Page title:

Page body:

[14] [DFN[RFC 3339の日時形式]]は、[[インターネット]]の[[標準化団体]] [[IETF]] が [[RFC 3339]] 
で規定した[[日時形式]]です。

[192] 
[[RFC 3339の日時形式]]は、
[[ISO 8601の日時形式]]の[[プロファイル]]の1つであり、
[[21世紀]]に入ってから作られた色々な [[IETF]] の[[プロトコル]]で採用されています。

[EG[
[101] [CODE[2006-04-13[[T]]14:12:53.4242+05:30]] は、
[[UTC]] から[TZ[5時間30分進んだ][+05:30]][[地方時]]における、
[TIME[平成18(2006)年4月13日14時12分53秒4242][2006-04-13T14:12:53.4242+05:30]]
を表しています。
]EG]

* 代替

[31] [[RFC 3339の日時形式]]は近年の [[IETF]] の仕様ではよく使われていますが、
それ以外ではあまり使われていません。 [[IETF]] 
内でも細かなバリエーションがあって統一しきれていません。
[[IETF]] が規定する仕様を利用する場合を除き、本[[日時形式]]は使うべきではなさそうです。

[184] 類似した[[日時形式]]の中では [[HTMLの日時形式]]がより厳密に規定されており、
利用しやすくなっています。

* 仕様書

[REFS[
- [24] [CITE@en[RFC 3339 - Date and Time on the Internet: Timestamps]] ([TIME[2014-09-29 15:50:28 +09:00]] 版) <https://tools.ietf.org/html/rfc3339>
-- [79] [CITE@en[RFC 3339 - Date and Time on the Internet: Timestamps]] ([TIME[2017-05-07 16:17:18 +09:00]]) <https://tools.ietf.org/html/rfc3339#section-4>
-- [82] [CITE@en[RFC 3339 - Date and Time on the Internet: Timestamps]] ([TIME[2017-05-07 16:17:18 +09:00]]) <https://tools.ietf.org/html/rfc3339#section-5>
- [25] [CITE[RFC Errata Report]] ([TIME[2014-11-13 04:10:16 +09:00]] 版) <http://www.rfc-editor.org/errata_search.php?rfc=3339>
]REFS]

[196] 
[[RFC 3339]] 
[DFN[[CITE[Date and Time on the Internet: Timestamps]]]]
は、 [[IETF]] [[標準化過程RFC]] です。
状態は[[提案標準]]です ([[インターネット標準]]では''ありません'')。

[197] 
なお、 [[RFC]] は、[[提案標準]]か[[インターネット標準]]かいずれかに関わらず、
採用すると定められた場面以外での強制力はありません。

[EG[
[198] 
[[Atom 1.0]] は [[RFC 3339]] を使うと定めているので、
[[RFC 3339の日時形式]]を使わなければなりません。
]EG]

[EG[
[199] 
新しい
[[Web API]]
で使う [[JSON]]
データ形式を設計するとき、
[[日時]]の表現に
[[RFC 3339の日時形式]]を使う義務はありません。
]EG]

[EG[
[240] 
[[インターネットメール]]の [CODE[Date:]] [[ヘッダー]]では
[[RFC 5322の日時形式]]を使うと定められていて、
[[RFC 3339の日時形式]]は使えません。
]EG]

* 暦法

[186] 
[[RFC 3339]] 内には [[ISO 8601]] の[[グレゴリオ暦]]記述法を使う、
というような簡単な言及のみしかありません。
不親切ですね ([[ISO 8601]] は有料です)。

[241] 
[[RFC 3339の日時形式]]は [[ISO 8601のプロファイル]]ですので、
[[ISO 8601]] の規定が適用されます。
[SEE[ [[ISO 8601暦]] ]]

[242] 
つまり [[RFC 3339]] の[[暦法]]も[[先発グレゴリオ暦]]です。

[EG[
[243] 
[[明治改暦]]や[[グレゴリオ改暦]]より前の[[日時]]も記述できますが、
[[先発グレゴリオ暦]]で記述しなければなりません。

]EG]

[245] 
[[旧暦]]、[[イスラム暦]]、[[ユリウス暦]]、
その他の[[暦法]]には対応していません。
[[グレゴリオ暦]]に[[変換][暦の換算]]して記述しなければなりません。

;; [269] 正確に換算できない場合や、未だ換算が定まっていない場合は、
[[RFC 3339の日時形式]]では記述できないということになります。
記述能力の欠如ということになりますが、[[インターネット]]の[[プロトコル]]での内部的な利用という設計上の想定用途にはこれで十分ということなのでしょう。
[[インターネット]]の[[プロトコル]]以外での利用の際には注意が必要です。

;; [246] 
[[RFC 3339の日時形式]]はあくまで[[機械可読]]な[[情報交換]]用の構文に過ぎません。
[[人間]]用に表示するときは、
[[利用者]]に応じて適切に変換することが期待されます
(>>83)。

* 構文

[85] 構文は [[RFC 3339]] で [[ABNF]] により規定されています [SRC[>>82]]。

[86] [[ISO 8601]] の[[プロファイル]]である [SRC[>>82]] とされており、
[[ISO 8601]] と見比べれば自明ということなのか、規定された構文の[[意味]]はほとんど説明がありません。
不親切ですね ([[ISO 8601]] は有料です)。

[87] また、一般に [[RFC 3339の日時形式]]とされるものは[[生成規則]]
[CODE(ABNF)@en[date-time]] が[[受理]]する[[言語]]と解されていますが、
[[RFC 3339]] 自身にはどの[[生成規則]]が[[プロトコル]]等に埋め込まれて使われるべきものかが明記されていません。
よって、

- [270] [[RFC 3339]] は[[日時]]形式を1つ規定している

... という解釈もあれば、

- [271] [[RFC 3339]] は[[日時]]、[[日付]]、[[時刻]]など複数の形式を規定している

... という解釈もあります
(変種の項も参照)。
ただ、 [[RFC 3339]] に例示があるのはすべて [CODE(ABNF)@en[date-time]] です。

[247] 
「[[RFC 3339]] の定める日時の形式」
と
「[[RFC 3339]] の[[生成規則]] [CODE[date-time]]」
が同じなのかどうかも、[[仕様書]]の厳密な解釈の問題としては存在します。
(>>104 も参照。)

;; [200] 
[[近代]]的な[[標準技術仕様書][仕様書]]として見れば低品質と評さざるを得ませんが、
この時代の [[RFC]] ではまともな方でした。

;; [248] 
こういう曖昧さを内包し、しかもそのことを見えにくくしてしまうのが、
[[ABNF]] のような[[形式言語]]による標準仕様の記述が好ましくないと
[[Web標準]]の世界で考えられるようになった一因ですね。

-*-*-

[89] [DFN[[CODE(ABNF)@en[date-time]]]] は、
[CODE(ABNF)@en[full-date]]、[CODE[T]]、[CODE(ABNF)@en[full-time]] 
を連ねたものです。 [SRC[>>82]]

[272] [[ISO 8601]] によれば、これが1つの[[日時]]を表すと解されます。

[FIG(railroad)[
= [CODE(ABNF)@en[full-date]]
= |
== [CODE[T]]
= [CODE(ABNF)@en[full-time]]
]FIG]

[NOTE[
[201] ここで区切りに使う [CODE[T]] は、
[[ISO 8601]] 
で定められたものです。
[[語源]]は [[time]]
と思われますが、
深い意味はなく、単なる区切りの記号と理解するべきものです。

[244] この [CODE[T]] があるために、
[[RFC 3339の日時形式]]は世界のどこの[[地域]]のどこの[[言語]]の[[日時表示]]としても不自然で、
専ら[[機械処理用][機械可読]]の[[日時形式]]としてしか利用できなくなっています。

なお、 >>17 も参照。
]NOTE]

-*-*-

[90] [DFN[[CODE[full-date]]]] は、
[[年月日]]を [CODE[-]] で連結したものです [SRC[>>82]]。

[273] [[ISO 8601]] によれば、これが1つの[[日付]]を表します。

[FIG(railroad)[
= [[年]]
= [CODE[-]]
= [[月]]
= [CODE[-]]
= [[日]]
]FIG]

-*-*-

[91] [DFN[[CODE[full-time]]]] は、[[時刻]]と[[時差]]を連ねたものです [SRC[>>82]]。

[FIG(railroad)[
= [[時刻]]
= [[時差]]
]FIG]

[95] [[時刻]]は、[[時]]、[[分]]、[[秒]]と[[秒の小数部]]を [CODE[:]] で連結したものです。
[SRC[>>82]]

[FIG(railroad)[
= [[時]]
= [CODE[:]]
= [[分]]
= [CODE[:]]
= [[秒]]と[[秒の小数部]]
]FIG]

-*-*-

[93] [[月]]は、 [CODE[01]] - [CODE[12]] の2桁の[[ASCII数字]]です [SRC[>>82]]。
[[ISO 8601]] によれば[[1月]]から[[12月]]までの[[暦月]]をそれぞれ表します。

[94] [[日]]は、 [CODE[01]] - ([CODE[28]], [CODE[29]], [CODE[30]], [CODE[31]] のいずれか)
の2桁の[[ASCII数字]]で、最大値は[[年]]と[[月]]による[[日の数]]です。 [SRC[>>82]]
[[ISO 8601]] によれば[[月の日]]の番号を表しています。

[96] [[時]]は、 [CODE[00]] - [CODE[23]] の2桁の[[ASCII数字]]です [SRC[>>82]]。
[[ISO 8601]] によれば[[日の時刻]]の[[時]]を表します。

;; [106] [[ISO 8601]] では認められている [CODE[24]] は、
[[RFC 3339]] では認められません [SRC[>>82]]。

[98] [[分]]は、 [CODE[00]] - [CODE[59]] の2桁の[[ASCII数字]]です [SRC[>>82]]。
[[ISO 8601]] によれば[[日の時刻]]の[[分]]を表します。

[187] [[月]]、[[日]]、[[時]]、[[分]]はいずれも2桁の[[ASCII数字]]ですから、
1桁の場合[[先導0]]が必須となります。

[EG[
[188] [CODE[2019-3-5T4:3:3]] は不正です。
[CODE[2019-03-05T04:03:03]]
としなければなりません。
]EG]

* 年

[92] [[年]]は、4桁の[[ASCII数字]]です [SRC[>>82]]。

;; [[値域]]制限はありません。

[FIG(railroad)[
= [[ASCII数字]]
= [[ASCII数字]]
= [[ASCII数字]]
= [[ASCII数字]]
]FIG]

[19] [[ISO 8601]] [WEAK[(の [[RFC 3339]] 制定当時の版)]] に従い、
[[年号]]は4桁でなければなりません。
1万年以降や[[0年]]よりも前は記述できません。

;; [1] [[2000年問題]]には対応していますが,
[[10000年問題]]には対応出来ません。
[SEE[ [[ISO 8601の日時形式]] ]]

;; [216] 
将来的に5桁[[以上]]も認める形に拡張できるかもしれませんが、
[[固定長]]であるという特徴が失われるので注意する必要があります。
また、拡張したものは
[[RFC 3339の日時形式]]ではなくなります。

[2] 
[TIME[西暦1年][year:1]]〜[TIME[西暦999年][year:999]]を表すには[[先導0]]
を補わなければならないことに注意が必要です。

[EG[

[259] 
[CODE[0123]] は、[TIME[西暦123年][123]]です。

]EG]

[202] 
[[暦]] (>>242) の違いにも注意が必要です。
[SEE[ [[ISO 8601の年]] ]]

-*-*-

[211] 
[[ISO 8601]] の[[年]]は[[西暦年]]です。

[212] 
[[元号年]]、[[民国紀元]]、[[ヒジュラ紀元]]など各国の[[紀年法]]には対応していません。
[[西暦年]]に変換して記述しなければなりません。

;; [215] 
[[RFC 3339の日時形式]]はあくまで[[機械可読]]な[[情報交換]]用の構文に過ぎません。
[[人間]]用に表示するときは、
[[利用者]]に応じて適切に変換することが期待されます
(>>83)。

* 秒と秒の小数部

[97] [[秒]]は、 [CODE[00]] - ([CODE[58]], [CODE[59]], [CODE[60]] のいずれか)
の2桁の[[ASCII数字]]で、最大値は[[閏秒]]規則によります [SRC[>>82]]。

[99] [[秒の小数部]]は、 [CODE[.][小数点]] の後に1桁[[以上]]の
[[ASCII数字]]を連ねたものです [SRC[>>82]]。

[274] 
[[ISO 8601]] によれば、[[日の時刻]]の[[秒]]およびそれ未満の部分を表します。

[FIG(railroad)[
= [[ASCII数字]]
= [[ASCII数字]]
= ?
== [CODE[.][小数点]]
== +
=== [[ASCII数字]]
]FIG]

[144] [[秒の小数部]]は、構文上、任意の桁数が認められています。
しかし、その[[精度]]をどう解釈するべきなのか 
[WEAK[(例えば末尾に [CODE[0]] があるのとないのとでは意味が違うのかどうか、実装の都合で[[丸め]]て解釈していいのかどうか、など)]]
や、
[[プロトコル]]依存で桁数の上限を定めていいのかどうかなど、
詳細は[[仕様書]]に何も書かれていません。

** 閏秒

[18] [[RFC 3339]] は[[閏秒]]に対応しています。
[[正閏秒]]として60秒を使うことができ、
[[負閏秒]]では59秒を使いません [SRC[>>82]]。

[105] [[応用]]は、
[[正閏秒]]が[[広告]]されるまで、
これを含む[[タイムスタンプ]]を[[生成]]するべきではありません。 [SRC[>>82]]

[32] 実装がこれを正しく扱えるのかどうかは定かではありません。
多くのシステムは[[閏秒のないUTC]]を採用しているので、
[[閏秒]]の[[タイムスタンプ]]を[[生成]]することはありませんし、
[[閏秒]]の[[タイムスタンプ]]を与えられたとき、
前後の[[秒]]と認識してしまうか、
不正な[[タイムスタンプ]]とみなされてしまう危険性があります。
あるいは[[閏秒]]かどうかの判断を回避するため、すべての[[分]]で60秒を認めてしまう実装もあるかもしれません。

[260] 不正な[[閏秒]]が記述されていたとき、これを解釈する実装がどう処理するべきなのかは、
[[仕様書]]には書かれていません。不正な入力として拒絶される可能性もあれば、
次の[[秒]]と解釈される可能性も、前の[[秒]]と解釈される可能性もあります。
まったく違う値と誤解する実装もあるかもしれません。

;; [261] このような動作の違いは、ときに[[セキュリティー]]問題を引き起こす危険性があります。

[262] 
[[RFC 3339]] に限った問題ではありませんが、
[[閏秒]]の実施の有無が決定するまで、
ある文字列が正当な値かどうかが定まらない
(実施の有無が決定する前と後とで、その入力に対する処理結果が変化する可能性がある)
のは、
実装上よくよく注意が必要です。

* 時間帯

[4] [[UTC]] との[[時差を記述][時差の記述]]することができます。

;; [80] これは [[fingerprinting vector]] です。
[SEE[ [[日時のプライバシー]] ]]

[100] [[時差]]は、 [CODE[Z]] または数値時差です。
数値時差は、符号、[[時]]、[CODE[:]]、[[分]]を連ねたものです。
符号は、 [CODE[+]] または [CODE[-]] です。 [SRC[>>82]]

[FIG(railroad)[
= |
== [CODE[Z]]
== =
=== |
==== [CODE[+]]
==== [CODE[-]]
=== [[ASCII数字]]
=== [[ASCII数字]]
=== [CODE[:]]
=== [[ASCII数字]]
=== [[ASCII数字]]
]FIG]

[EG[
[220] 
[[日本時間]] ([[中央標準時]]) は 
[CODE[+09:00]]
となります。
]EG]

[78] [[時差]]は[[分]]単位です。[[秒]]単位の[[時差]]は記述できず、
適当な[[分]]単位の[[時差]]になおして記述するしかありません [SRC[>>79]]。

;; [263] [[現代]]の各国政府の定める[[標準時]]・[[夏時刻]]はこれでカバーできていますが、
[[過去の日時]]は記述できないことがあります。
また、[[現代]]でも、[[船内時]]など私的な[[日時]]の記述はできない可能性があります。

[185] [[RFC 822の日時形式]]とは違って、時と分の間に [CODE[:]]
が必須となっていることに注意。
これが欠けている誤った形式が使われることもあります。

[EG[
[221] 
[CODE[+09:00]] が正しく、 [CODE[+0900]] は'''誤り'''です。
]EG]

-*-*-

[81] [[UTC]] での[[時刻]]はわかるものの[[地方時]]が不明なことを示す特別な[[時差]]表記
[CODE[-00:00]] があります。

;; [39] これは [[RFC 822の日時形式]]由来の慣習で、 
[[ISO 8601の日時形式]]にはない独自の解釈です。
他の [[ISO 8601のプロファイル]]や [[HTMLの日時形式]]はこの解釈を採用していません。
(この慣習は、 [[ISO 8601]] に[[適合]]しない疑いがあります。)
[SEE[ [[-00:00]] ]]

[252] なお、紛らわしいですが、
[[時差]]の不明な [[floating time]] とは異なるので注意。

-*-*-

[264] 
[[標準時]]や[[夏時刻]]は、政府の決定で変更されることが (かなりの頻度で) あります。
[[将来の日時]]を記述したいなら、
現在の制度が変更されない期待のもとで[[時差]]を記述するほかありません。

[EG[

[265] 「来年の3月10日の9時12分」を記述したいとき、
「来年の3月10日」時点の[[標準時]]での「9時12分」を意味していることが多そうですが、
[[RFC 3339の日時形式]]だけでは (厳密には) 記述できません。

]EG]

* 指示子

[17] [CODE[T]] と [CODE[Z]] は、[[大文字]]でも[[小文字]]でも構いませんが、
[[大文字]]を使う[SHOULD[べき]]です [SRC[>>82]]。

[102] [[XML]] など[[大文字]]と[[小文字]]を区別する状況で使う[[プロトコル]]は、
[[大文字]]でなければならないと制約しても構いません。 [SRC[>>82]]

;; [103] [[インターネット]]の[[プロトコル]]でも、値の[[大文字]]と[[小文字]]を区別できない状況は稀です。
そもそも [[ISO 8601]] は[[大文字]]を使えない状況で[[小文字]]で代用しても良いとしているだけなので、
そのような状況がほとんど考えられない[[インターネット]]の新しい[[プロトコル]]向けの
[[RFC 3339]] がなぜわざわざ[[小文字]]も認めることにしたのかは、謎です。
(確かに [[IETF]] では[[大文字]]と[[小文字]]を区別しない[[プロトコル]]が伝統的ではあったのですが...)

[26] [[日時]]の境界は、 [[ABNF]] 構文では [CODE[T]] ([[大文字]]または[[小文字]])
とされています。しかし NOTE で、
[[応用]]は[[可読性]]のため[[間隔]]その他の他の区切りを選んでも構わない
[SRC[>>82]] とされています。
選択次第で
[[ISO 8601のプロファイル]]の範囲を逸脱してしまいます。

;; [104] [[ABNF]] では [CODE[T]] に限定されているということは、
「[[RFC 3339]] の [CODE(ABNF)@en[date-time]]」と明示的に参照している[[プロトコル]]においては、
[CODE[T]] を使うことが要求されていると解釈するべきでしょうか。
「[[RFC 3339]] の[[日時]]」のような曖昧な参照方法の[[プロトコル]]は、
他の区切り文字が認められている可能性があります。

* 処理

[145] 構文的に不正な値や値域を外れた値をどう解釈するべきかにはまったく言及されていません。

[249] 構文的に適正でも受信した装置が処理できない値 
([[過去][過去の日時]]すぎる、
[[未来][将来の日時]]すぎるなど)
をどう処置するべきかにもまったく言及がありません。

[250] 適切かどうか判断し難い値や適切かどうかが変化した値 (具体的には[[閏秒]])
を受信した時どう処理するべきかは不明です (>>260)。

[EG[
[251] 60秒と書かれた値は[[閏秒]]の実施不実施が決定されるまで適切な値かどうか不定ですし、
不実施が決定されてからは不適切な値になります。
]EG]

* レンダリング

[83] [[クライアント]]は、[[言語]]や[[時差]]に応じて適切に表示できるようにする[SHOULD[べきです]]
[SRC[>>82]]。
[SEE[ [[日時表示]] ]]

[181] つまり、この[[日時形式]]はあくまで[[プロトコル]]の[[情報交換]]に用いられる構文を定めるものに過ぎず、
それを[[利用者エージェント]]がどのように[[利用者]]に提示するかは、
[[利用者エージェント]]の裁量の範囲内 ([[実装の品質]]の問題)
ということになります。

[EG[
[182] 例えば[[英語圏]]では[[月名]]を[[数字]]ではなく[[英語の名前][欧米月名]]で表示するのが適切かもしれません。
]EG]

[EG[
[253] 例えば[[日本]]では[[年]]を[[元号年]]と[[西暦年]]の併記で表示するべきかもしれません。
]EG]

[EG[
[183] 
「○分前」のような [[ambtime]] 形式で表示するのが便利な場面もあるかもしれません。
]EG]

* 文脈

[84] 新しい[[インターネット]]の[[プロトコル]]では、
本形式を使う[SHOULD[べきです]] [SRC[>>82]]。

[FIG(middle list)[ [110] [[RFC 3339]] [CODE(ABNF)@en[date-time]] の採用例
- [225] [[CPIM]] [CODE[DateTime:]] [SRC[>>111]]
-- 変種: >>224
- [CODE(URI)@en[DAV:creationdate]] [SRC[>>109]]
- [CODE[yang:date-and-time]]
- [[媒体素片]] [CODE[clock][wall-clock time code]]
]FIG]

[FIG(middle list)[ [116] [[RFC 3339]] Section 5.6 [CSECTION@en[Internet Date/Time Format]] 形式の採用例

- [CODE(HTTP)@en[report-uri]] に送信される [[JSON]] の [CODE[date-time]] [SRC[>>115]]
- [[Data Package]]

]FIG]

[FIG(middle list)[ [124] [[RFC 3339]] の[[日時形式]]の採用例
- [[RDAP]] [SRC[>>123]]
]FIG]

[266] 
実はオリジナルの [[RFC 3339]] を参照している規格はそれほど多くはありません。
ほとんどは変種を使っています。変種の項を参照。

[REFS[
- [111] [CITE@en[RFC 3862 - Common Presence and Instant Messaging (CPIM): Message Format]] ([TIME[2017-05-07 17:28:12 +09:00]]) <https://tools.ietf.org/html/rfc3862#section-4.4>
- [115] [CITE@en[RFC 7469 - Public Key Pinning Extension for HTTP]] ([TIME[2017-05-07 16:17:40 +09:00]]) <https://tools.ietf.org/html/rfc7469#section-3>
- [123] [CITE@en[RFC 7483 - JSON Responses for the Registration Data Access Protocol (RDAP)]] ([TIME[2017-05-07 17:28:01 +09:00]]) <https://tools.ietf.org/html/rfc7483#section-3>
]REFS]

[FIG(quote)[
[FIGCAPTION[
[34] [CITE@ja[ScalaでRSSフィードの処理を書いてみたら思ったより大変でした - argius note]]
([TIME[2016-01-07 17:36:27 +09:00]] 版)
<http://argius.hatenablog.jp/entry/20130830/1377867921>
]FIGCAPTION]

> RSS2.0の日付もRFC 3339になっているケースが割とありました。

]FIG]

;; [11] 本来は [[RFC 822の日時形式]]

* 変種

[204] 
[[RFC 3339の日時形式]]には[[変種]]が無数にあります。
それらが「[[RFC 3339の日時形式]]」と (不正確に)
いわれることがあり、
円滑な[[情報交換]]の障害となっています。

;; [205] 
これだけバリエーションが多いというのは、
[[RFC 3339]]
が要求に十分に応えられていない (が要求に近いものではある)
ことを表し、
[[標準化]]戦略が不完全だったことを意味しています。
ふつうなら標準仕様を改訂すれば済むことですが、
[[RFC]]
の改訂コストが極めて高い
[[IETF]]
の[[標準化手続き]]のためか、
長らく放置されています。

;; [254] 
>>147 のように追加の制約が意味不明だったりすると、
何のために標準規格があって何のためにそれを採用したのか、
わからなくなってしまいますね。

[FIG(quote)[
[FIGCAPTION[
[146] [CITE@en[フォトコレクション | docomo Developer support | NTTドコモ]]
([TIME[2017-05-18 00:36:29 +09:00]])
<https://dev.smt.docomo.ne.jp/?p=docs.api.page&api_name=photo_collection&p_name=api_1>
]FIGCAPTION]

> タイムゾーンは任意に設定してよい。
> RFC 3339 の date-time フォーマットで 秒の1の位まで指定する。
> サンプル値) yyyy-mm-ddThh:mi:ss+09:00 (JSTの例) 
> yyyy-mm-ddThh:mi:ssZ (UTCの例)

]FIG]

[147] 「秒の1の位まで指定する」の意図が不明。[[秒の小数部]]は使えないのだろうか。

** RFC 2518

[8] [[RFC 2518]] には、 [[RFC 3339]] 
になるの前の [[I-D]] の規定の一部が[[コピペ]]されています。
[[ISO 8601]] 形式であること、 [[ABNF]] 構文、特別な[[時間帯]]である [CODE[-00:00]]
が含まれていますが、それ以外の説明は省かれています。 [SRC[>>107]]

[3] [[ABNF]] はほとんど [[RFC 3339]] と同じですが、[[負閏秒]]への言及が欠けています。

[108] [CODE(URI)@en[DAV:creationdate]] は、 
[CODE(ABNF)@en[date-time]] を使うと規定されています [SRC[>>107]]。

[27] [[RFC 3339]] の出版を待たずに [[RFC 2518]] を出版するため、[[コピペ]]したのでしょう
[WEAK[(この時代の[[標準]]開発では [[IETF]] に限らずこのような中長期的な視点を欠いた仕事がしばしば見られました [SEE[ [[新規格の先行コピペ]] ]])]]。
[[RFC 2518]] の改訂版である [[RFC 4918]] では当該部分が削除され、 [[RFC 3339]]
の [CODE(ABNF)@en[date-time]] が参照されています [SRC[>>109]]。

[206] 
このような方法を採られると、はたして [[RFC 2518]]
の規定するものが
[[RFC 3339の日時形式]]と同じものなのかどうか、
読者が個別に検証しなければならなくなります。

[207] 
そして先述のような軽微な違いが存在します。
これを同じものと解釈してよいのかどうか、
見解は人によって異なり得ます。
こんなささいな違いから、
[[情報交換]]の失敗や大きな不具合につながることがあります。

[REFS[
- [107] [CITE@en[RFC 2518 - HTTP Extensions for Distributed Authoring -- WEBDAV]] ([TIME[2017-05-07 16:42:04 +09:00]]) <https://tools.ietf.org/html/rfc2518#section-23.2>
- [109] [CITE@en[RFC 4918 - HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)]] ([TIME[2017-05-07 17:54:50 +09:00]]) <https://tools.ietf.org/html/rfc4918#section-15.1>
]REFS]

** 秒の小数部を認めない変種

[122] [[SMTP]] では [CODE(ABNF)@en[date-time]] から[[秒の小数部]]を除いたものが使われる場合があります
[SRC[>>121]]。

[REFS[
- [121] [CITE@en[RFC 7293 - The Require-Recipient-Valid-Since Header Field and SMTP Service Extension]] ([TIME[2017-05-14 17:05:27 +09:00]]) <https://tools.ietf.org/html/rfc7293#section-3.1>

[FIG(quote)[
[FIGCAPTION[
[190] [CITE@ja[JavaScriptのプログラムに渡す時刻の文字列の形式は何が良いか – 或る阿呆の記]],
投稿日: 2018年9月11日 投稿者: hackle,
[最終更新] 2018年9月12日
([TIME[2019-07-08 13:01:39 +09:00]])
<https://hack-le.com/js-date-time-string/#ISO8601RFC3339>
]FIGCAPTION]

> この手の話を調べていると、ISO8601ではなくてRFC3339という呼ばれ方をしているものが散見される。「RFC3339 インターネット上の日付と時間:タイムスタンプ」
<http://www5d.biglobe.ne.jp/stssk/rfc/rfc3339j.html>
を読むと、RFC3339は、ISO8601拡張形式をシンプルかつ明示的に再定義したものだ。
> 文脈的にはほぼ同義のように扱われていることが多いが、RFC3339においてはミリ秒を定義せず、YYYY-mm-ddTHH:MM:SSZの形式であるようだ。自分はこの表記が一番馴染みがある。

]FIG]

[191] このような誤った情報はままみられます。
参照されている
「RFC3339 インターネット上の日付と時間:タイムスタンプ」
は [[RFC 3339]] の[[和訳][RFCの和訳]]で、
本当に「読」んだのであれば[[秒の小数部]]が使えることがかなり明確に書かれていることに気づいたはずです。
自分の「馴染み」に引っ張られてしまったのでしょうか。

]REFS]

-*-*-

[268] [CODE[sigT]] では

- [[RFC 3339]] 
- [[日時]]は [[UTC]]
- [[秒の小数部]]なし

と規定しています。 [SRC[>>267]]

[REFS[

-
[267] 
[CITE@ja[TS 119 182-1 - V1.1.1 - Electronic Signatures and Infrastructures (ESI); JAdES digital signatures; Part 1: Building blocks and JAdES baseline signatures - ts_11918201v010101p.pdf]], [TIME[2021-03-16T13:08:20.000Z]], [TIME[2024-06-05T03:51:37.779Z]] <https://www.etsi.org/deliver/etsi_ts/119100_119199/11918201/01.01.01_60/ts_11918201v010101p.pdf#page=15>

]REFS]

** IETF の XML 系の変種

[15] [[IETF]] の [[XML]] 系仕様では [[XML Schema]] や [[RELAX NG]] のデータ型としては [CODE(XML)@en[[[xs:dateTime]]]]
([[XML Schemaの日付形式]]) を採用しつつ、本文で「[[RFC 3339]] の [CODE[[[date-time]]]] かつ [CODE[[[T]]]]
と [CODE[[[Z]]]] は[[大文字]]」とされていることが多いです。[[スキーマ]]が[[規定]]か[[参考]]かは仕様によりますが、
[[RFC 3339]] と [[XML Schema]] の両方の規定の[[積集合]]に従わなければならないということになります。
[SEE[ [[ISO 8601の日付形式]>>25]に、両者の比較があります。 ]]

[6] [CODE[xs:dateTime]] は[[10000年問題]]に対応していますが、
[[RFC 3339の日時形式]]は対応していません。
両方の規定に従うためには、9999年までの[[年]]しか扱えません。

-*-*-

[140] [[RFC 3863]] は、 [[PIDF]] [CODE(XMLe)@en[timestamp]] [[要素]]を
[[XML Schema]] では [CODE[xs:dateTime]] としながら、
本文では [[RFC 3339]] [DFN[IMPP datetime format]] で、
[CODE[T]] と [CODE[Z]] は[[大文字]]と規定しています [SRC[>>139, >>141]]。

[NOTE[
[142] [[RFC 3339の日時形式]]をそのまま使っている [[RFC 3862]] [[CPIM]] [SRC[>>111]]、
[[XML Schema]] で使っている [[RFC 3863]] [[PIDF]] [SRC[>>139]]、
そして [[RFC 3339]] はいずれも同じ [[ietf-impp]] [[WG]] で同時期に開発されたものでした。
つまり [[RFC 3339]] の様々なバリエーションの混乱は、はじめから存在していたのです。

[208] あとから新しい要件が発見されてバリエーションが生じたのでなく、
最初からバリエーションがあったとすると、
[[標準化]]戦略は最初から間違っていたと言わざるを得ません。
]NOTE]

[229] 
[[RFC 3923]]
は
[[PIDF]]
の[[応用]]の1つを定めていましたが、
「UTC with no offset」
でなければ[MUST[ならない]]との追加の制約を[[規定]]していました。
[SRC[>>223]]

[REFS[
- [139] [CITE@en[[[RFC 3863]] - Presence Information Data Format (PIDF)]] ([TIME[2017-05-07 17:28:02 +09:00]]) <https://tools.ietf.org/html/rfc3863#section-4.1.7>
- [141] [CITE@en[[[RFC 3863]] - Presence Information Data Format (PIDF)]] ([TIME[2017-05-07 17:28:02 +09:00]]) <https://tools.ietf.org/html/rfc3863#section-4.4>
]REFS]

-*-*-

[133] [[RFC 5070]] では、 date-time string は DATETIME data type
で表されるとし、 date-time string は [[RFC 3339]] にある [[ISO 8601]]
の[[部分集合]]で表し、 DATETIME data type は [CODE[xs:dateTime]]
で実装される [SRC[>>132]] とされています。果たしてこれが何を意味するのかは不明です
([[RFC 3339の日時形式]]と [CODE[xs:dateTime]] の両方が適用されるという意味でしょうか)。

[135] その改訂版の [[RFC 7970]] では、謎の規定は削除されて、
[CODE[xs:dateTime]] だけになっています [SRC[>>134]]。

[138] [[RFC 5388]] は、 [[XML Schema 1.0]] 第2版 [CODE[xs:dateTime]]
としながらも、 [[RFC 3339]] の値に制約される [SRC[>>136、>>137]] と規定しています。
両方で共通して認められる値のみ指定可能ということなのでしょうが、
[CODE[-00:00]] がどう扱われるのかは、はっきりしません。

[REFS[
- [132] [CITE@en[RFC 5070 - The Incident Object Description Exchange Format]] ([TIME[2017-05-07 20:04:30 +09:00]]) <https://tools.ietf.org/html/rfc5070#section-2.8>
- [134] [CITE@en[RFC 7970 - The Incident Object Description Exchange Format Version 2]] ([TIME[2017-05-14 16:49:04 +09:00]]) <https://tools.ietf.org/html/rfc7970#section-2.7>
- [136] [CITE@en[RFC 5388 - Information Model and XML Data Model for Traceroute Measurements]] ([TIME[2017-05-07 16:57:43 +09:00]]) <https://tools.ietf.org/html/rfc5388#section-5.1>
- [137] [CITE@en[RFC 5388 - Information Model and XML Data Model for Traceroute Measurements]] ([TIME[2017-05-07 16:57:43 +09:00]]) <https://tools.ietf.org/html/rfc5388#section-7>
]REFS]

-*-*-

[70] [[WS-BaseFaults]] 1.2 は、[[時間帯]]が省略された場合には [[UTC]]
と解釈しなければ[MUST[なりません]]と規定しています。

[228] [[時間帯]]の省略は構文上認められていないのですが、
これは[[エラー処理]]の規定でしょうか?

*** Date construct (Atom 1.0)

[48] [[Atom]] [SRC[>>46]] および [[Metalink]] [SRC[>>47]]
では、[[日時]]の指定は [DFN[[[Date construct]]]] と呼ばれています。

[49] [[Date construct]] 中には[[空白]]を含めては[['''なりません''']]
[SRC@en[[[Atom 1.0]] 3.]]。

[50] [[RFC 3339]] の [CODE[[[date-time]]]] ([[RFC 3339の日付形式]]) でなければなりません。
記号 [CODE[[[T]]]] と [CODE[[[Z]]]] は[[大文字]]でなければ[['''なりません''']]。 [SRC[>>46, >>47]]

[51] [[RELAX NG]] [[スキーマ]] ([[参考]]) では [CODE[[[xsd:dateTime]]]] となっています [SRC[>>46, >>47]]。

[131] [[RFC 7049]] は、“[[RFC 4287]] 3.3 節で refine された [[RFC 3339]] 形式”
を採用しています [SRC[>>130]]。 これに [[RELAX NG]] [[スキーマ]] ([[参考]])
で示された制約まで含まれるのかは不明です。

[218] 
「SmartFormat仕様書(Atom準拠)」
は
[[Atom 1.0]]
とは違う[[日時形式]]を規定しています (当然 [[Atom 1.0]] 仕様違反)。
[SEE[ [[SmartFormatの日時形式]] ]]

[REFS[
- [46] [CITE@en[RFC 4287 - The Atom Syndication Format]] ([TIME[2008-08-30 23:12:03 +09:00]] 版) <https://tools.ietf.org/html/rfc4287#section-3>
-- [CSECTION@en[3.3.  Date Constructs]]
- [47] [CITE@en[RFC 5854 - The Metalink Download Description Format]] ([TIME[2014-09-14 16:54:14 +09:00]] 版) <https://tools.ietf.org/html/rfc5854#section-3.2>
- [130] [CITE@en[RFC 7049 - Concise Binary Object Representation (CBOR)]] ([TIME[2017-05-07 16:11:09 +09:00]]) <https://tools.ietf.org/html/rfc7049#section-2.4.1>
]REFS]

;; [53] [[Atom 0.3]] では [[W3C-DTF]] が用いられていました。 [[Atom 1.0]]
の定義とほとんど変わりませんが、厳密には多少の違いがあります。

[FIG(quote)[
[FIGCAPTION[
[41] [CITE@en[Commit e188b782a1dc1bd8e9e0006fea476b6c92fd04a7 to hakobe's pig - GitHub]] ([TIME[2009-05-24 10:33:12 +09:00]] 版) <http://github.com/hakobe/pig/commit/e188b782a1dc1bd8e9e0006fea476b6c92fd04a7>
]FIGCAPTION]

>Gmailのフィードがhoursが24以上の日付を返してくる
]FIG]

[42] [[W3C]] の[[メーリングリスト]]の[[アーカイブ]]の [[Atomフィード]]は、
[PRE(XML code)[
    <updated>2014-03-01T11:01:35+0000(UT:C)</updated>
]PRE]
... のようなおかしな日付を出力します。

([[RFC 822の日付形式]]から変換するときに、[[注釈]]を考慮せずに[[時間帯]]の「:」を補っているようですね・・・。)

*** EPP

[54] [[EPP]] では、 [[RFC 3339]] と
[[XML Schema]] [CODE(XML)[[VAR[xsd:]][[dataTime]]]]
の両方の部分集合である日付形式を規定しています。

[REFS[
- [55] [[RFC 3730]] [CITE[Extensible Provisioning Protocol (EPP)]]
<urn:ietf:rfc:3730>
-- [CSECTION[5.  Internationalization Considerations]]
- [56] [[RFC 3731]] [CITE[Extensible Provisioning Protocol (EPP) Domain Name Mapping]]
<urn:ietf:rfc:3731>
-- [CSECTION[2.4.  Dates and Times]]
-- [CSECTION[5.  Internationalization Considerations]]
- [57] [[RFC 3732]] [CITE[Extensible Provisioning Protocol (EPP) Host Mapping]]
<urn:ietf:rfc:3732>
-- [CSECTION[2.4.  Dates and Times]]
-- [CSECTION[5.  Internationalization Considerations]]
- [58] [[RFC 3733]] [CITE[Extensible Provisioning Protocol (EPP) Contact Mapping]]
<urn:ietf:rfc:3733>
-- [CSECTION[2.7.  Dates and Times]]
-- [CSECTION[5.  Internationalization Considerations]]
- [59] [[RFC 3915]] [CITE[Domain Registry Grace Period Mapping for the Extensible Provisioning Protocol (EPP)]]
<urn:ietf:rfc:3915>
-- [CSECTION[3.3.  Dates and Times]]
]REFS]

[60] RFC 3730〜3733 によれば:

- [61] 基本的には [[RFC 3339の日付形式]] ([CODE(ABNF)[[[date-time]]]]) です。
- [62] [[時間帯]]は [CODE[Z]] でなければ'''なりません'''。
- [63] [CODE[T]] と [CODE[Z]] は大文字でなければ'''なりません'''。

[64] 例:

- [65] [SAMP[2000-06-06T22:00:00.0Z]]
- [66] [SAMP[2005-11-26T22:00:00.0Z]]

*** UTC 固定の変種

[SEE[ >>222 ]]

*** RFC 5070

[38] [[RFC 5070]] は、 [[RFC 3339]] と [CODE[xs:dateTime]] に加えて
[[ISO 8601:2000]] にも言及しています。これが[[適合性]]と処理にどう影響するのか評価するのは難しいです。
([[RFC 3339]] も [CODE[xs:dateTime]] も [[ISO 8601]] をベースにはしていますが、
細部は違っています。)

[FIG(quote)[
[FIGCAPTION[
[29] [CITE@en[RFC 5070 - The Incident Object Description Exchange Format]]
([TIME[2015-07-11 22:59:28 +09:00]] 版)
<https://tools.ietf.org/html/rfc5070#section-2.8>
]FIGCAPTION]

>    Date-time strings are formatted according to a subset of ISO 8601:
2000 '''['''13''']''' documented in RFC 3339 '''['''12''']'''.
The DATETIME data type is implemented as an "xs:dateTime" '''['''3''']''' in the
schema.

]FIG]

** UTC 固定の変種

[224] 
[[RFC 3923]]
は 
[[CPIM]] メッセージ ([CODE[message/cpim]], >>225)
の[[応用]]の1つを規定するもので、
「UTC with no offset」
でなければ[MUST[ならない]]との追加の制約を定めていました。
[SRC[>>223]]

[226] 
[CODE[Z]] か [CODE[z]] か [CODE[+00:00]] かには特に言及がありません。

[REFS[
- [223] [CITE@en[rfc3923]], [TIME[2021-06-22T03:13:59.000Z]] <https://datatracker.ietf.org/doc/html/rfc3923#section-6.9>
]REFS]

-*-*-

[117] [[RFC 7808]] は [[RFC 3339]] [CODE[date-time]]
の[[時間帯]]を [CODE[Z]] とするものを
[DFN[[RUBYB[UTC [CODE[date-time]]値]@en[UTC [CODE[date-time]] value]]]]と呼んでいるようです
[SRC[>>118]]。

[227] 
「use a "Z" suffix, and not fixed numeric offsets」
と説明されており [SRC[>>118]]、曖昧ながら [CODE[Z]] でも [CODE[z]]
でも良さそうに読めます。

[REFS[
- [118] [CITE@en[RFC 7808 - Time Zone Data Distribution Service]] ([TIME[2017-05-14 17:06:59 +09:00]]) <https://tools.ietf.org/html/rfc7808>
]REFS]

-*-*-

[222] [[IETF]] の [[XML]] 系の変種 (>>15) で、更に [[UTC]] 
限定の制約が付いたものがありました。

[67] [[RFC 3982]] は[[時間帯]]を [[UTC]] ([CODE[Z]])
に固定しています。 ([[XML Schema]] 定義では
[CODE(XML)[[VAR[xs:]]dateTime]] を使用。)

[REFS[
- [68] [[RFC 3982]] [CITE[IRIS:  A Domain Registry (dreg) Type for the Internet Registry Information Service (IRIS)]]
<urn:ietf:rfc:3982>
-- [CSECTION[3.2.1.  Privacy Labels]]
]REFS]

[69] [[EPPの日付形式]]は [CODE(XML)[[VAR[xs:]]dataTime]]
と [[RFC 3339の日付形式]]の両方の部分集合で、
時間帯を [CODE[Z]] に固定した上で [CODE[T]] と [CODE[Z]]
を[[大文字]]で記述すると規定しています。
([[XML Schema]] 定義では [CODE(XML)[[VAR[xs:]]dateTime]] を使用。)

** Sieve の日時

[125] [[Sieveの日時形式]]で [CODE[iso8601]] と呼ばれるものは、
[[RFC 3339]] の [CODE(ABNF)@en[date-time]] に次の制限を加えたものです [SRC[>>126]]。

- [127] [[大文字]]を使う
- [128] [TZ[+00:00]] ではなく [CODE[Z]] を使う

;; [129] [[UTC]] 以外の[[時差]]や [CODE[-00:00]] を使うことは禁止されていないようです。
[[一意性]]を意識した制約でしょうか。

[REFS[
- [126] [CITE@en[RFC 5260 - Sieve Email Filtering: Date and Index Extensions]] ([TIME[2017-05-07 22:48:17 +09:00]]) <https://tools.ietf.org/html/rfc5260#section-4.2>
]REFS]

** Syslog の日時

[20] [[Syslog]] の [CODE[[[TIMESTAMP]]]] は [[RFC 3339の日時形式]]を採用していますが、
次の制約を加えています [SRC[>>13]]。
[FIG(list)[
- [21] [[大文字]]を使わなければ[['''なりません''']]。
- [22] [CODE[[[T]]]] を使わなければ[['''なりません''']]。
- [44] [[閏秒]]を使っては[MUST[なりません]]。
]FIG]

[203] 
[[負閏秒]]はどう扱われるのでしょうか。

[SEE[ [[閏秒のない時刻系]] ]]

[REFS[
- [13] [CITE@en[RFC 5424 - The Syslog Protocol]] ([TIME[2014-09-14 04:23:15 +09:00]] 版) <https://tools.ietf.org/html/rfc5424#section-6.2.3>
]REFS]

** JMAP の日時

[FIG(quote)[
[FIGCAPTION[
[35] [CITE[JSON Mail Access Protocol Specification (JMAP)]]
([TIME[2016-03-11 14:55:42 +09:00]] 版)
<http://jmap.io/spec.html>
]FIGCAPTION]

> Where the API specifies Date as a type, it means a string in RFC3339 date-time format, with the time-offset component always Z (i.e. the date-time MUST be in UTC time) and time-secfrac always omitted. The “T” and “Z” MUST always be upper-case. For example, "2014-10-30T14:12:00Z".
> Where the API specifies LocalDate as a type, it means a string in the same format as Date, but with the Z omitted from the end. This only occurs in relation to calendar events. The interpretation in absolute time depends upon the time zone for the event, which MAY not be a fixed offset (for example when daylight saving time occurs).

]FIG]

** [CODE[as2-date-time]]

[165] [[Activity Streams 2.0]] は [[RFC 3339]] の [CODE[date-time]]
から派生した [DFN[[CODE[as2-date-time]]]] を定義しています [SRC[>>164]]。

[166] [CODE[T]] と [CODE[Z]] は、[[大文字]]としなければ[MUST[なりません]]
[SRC[>>164]]。 (なぜか [[ABNF]] 構文では[[大文字]]でも[[小文字]]でも良いように書かれていますが、
[[英語]]では[[大文字]]のみ認めています [SRC[>>164]]。)

[167] [[秒]]とその直前の [CODE[:]] を、省略できます [SRC[>>164]]。
[[ABNF]] 構文では[[秒の小数部]]が存在するときも [CODE[:]] と[[秒の整数部]]を省略できるとされています
[SRC[>>164]]。これが意図通りなのかは、はっきりしません。

[169] [[データ型]]は [CODE[xsd:dateTime]] が使われています [SRC[>>168]]。
従って [[XML Schemaデータ型]]の制約も適用されるものと思われます。
ただ、 [[XML Schema]] の [CODE[xsd:dateTime]] では[[秒の整数部]]の省略は認められていませんが...

[REFS[
- [164] [CITE@en[Activity Streams 2.0]] ([TIME[2017-05-21 23:50:36 +09:00]]) <https://w3c.github.io/activitystreams/core/#h-dates>
- [168] [CITE@en[Activity Vocabulary]] ([TIME[2017-05-21 23:50:36 +09:00]]) <https://w3c.github.io/activitystreams/vocabulary/#h-termconventions>
]REFS]

** 日付のみの変種

[238] 
[[RFC 3339]] は一般に[[日時形式]]を定義していると理解されていますが、
[[日付形式]]、[[時刻形式]]をも定義しているという解釈もあり得ます
(>>87)。
本項に示すのは[[日付形式]]を用いた事例です。

[5]
[[RFC 4646]] とその改訂版の [[RFC 5646]] は、 [[IANA登録簿]]の[[日付形式]]として [[RFC 3339]]
の [CODE(ABNF)@en[[[full-date]]]] を採用しています [SRC[>>37, >>120]]。

[FIG(quote)[
[FIGCAPTION[
[33] ([TIME[2015-10-04 21:50:44 +09:00]] 版)
<http://www.houjin-bangou.nta.go.jp/documents/k-resource-dl.pdf>
]FIGCAPTION]

>
,*凡例,*凡例の説明
,YYYY-MM-DD,インターネットの技術標準を議論するIETFによる、RFC3339に則った形式。平成27年10月5日(2015年10月5日)の場合は、「2015-10-05」と設定する。

]FIG]

[FIG(quote)[
[FIGCAPTION[
[239] 
[CITE[k-resource-dl.pdf]], [TIME[2022-03-31T04:15:07.000Z]], [TIME[2022-06-16T08:48:40.198Z]] <https://www.invoice-kohyo.nta.go.jp/download/index.files/k-resource-dl.pdf#page=4>
]FIGCAPTION]

>
,*凡例,*凡例の説明
,YYYY-MM-DD,インターネットの技術標準を議論するIETFによる、RFC3339に則った形式。[BR[]]令和3年10月1日(2021年10月1日)の場合は、「2021-10-01」と設定する。

]FIG]

[119] [[RFC 7808]] は [[RFC 3339]] の [CODE(ABNF)@en[full-date]] を参照しています
[SRC[>>118]]。

[REFS[
- [37] [CITE@en[RFC 5646 - Tags for Identifying Languages]] ([TIME[2017-05-14 16:18:06 +09:00]]) <https://tools.ietf.org/html/rfc5646#section-3.1.1>
- [120] [CITE@en[RFC 5646 - Tags for Identifying Languages]] ([TIME[2017-05-14 16:18:06 +09:00]]) <https://tools.ietf.org/html/rfc5646#section-5.1>
]REFS]

** [CODE(URI)@en[tag:]] URL

[112] [CODE(URI)@en[tag:]] [[URL]] を規定する [[RFC 4151]] には、次のような規定があります。

[FIG(quote)[
[FIGCAPTION[
[113] [CITE@en[RFC 4151 - The 'tag' URI Scheme]] ([TIME[2017-05-07 16:48:27 +09:00]]) <https://tools.ietf.org/html/rfc4151>
]FIGCAPTION]

> The date is specified using one of the "YYYY",
"YYYY-MM" and "YYYY-MM-DD" formats allowed by the ISO 8601 standard
[4] (see also RFC 3339 [10]).
]FIG]

[114] この参照をどう解釈するべきなのかは謎過ぎます。なお [[ISO 8601]] は
[[Normative Reference]] で、 [[RFC 3339]] は [[Informative Reference]] です [SRC[>>113]]。

** I-JSON の変種

[FIG(quote)[
[FIGCAPTION[
[30] [CITE@en[RFC 7493 - The I-JSON Message Format]]
([TIME[2015-11-29 21:37:53 +09:00]] 版)
<https://tools.ietf.org/html/rfc7493#section-4.3>
]FIGCAPTION]

> It is RECOMMENDED that all such data
items be expressed as string values in ISO 8601 format, as specified
in '''['''RFC3339''']''', with the additional restrictions that uppercase rather
than lowercase letters be used, that the timezone be included not
defaulted, and that optional trailing seconds be included even when
their value is "00".  It is also RECOMMENDED that all data items
containing time durations conform to the "duration" production in
Appendix A of RFC 3339, with the same additional restrictions.

]FIG]

;; [36] [[RFC 3339]] では[[秒]]はそもそも省略可能ではないのだが。

** TOML の変種

[171] [DFN[TOMLの日時形式]]は [[RFC 3339]] をベースにしたもので、4種類あります。
いずれも
[[TOML]]
で使われます。

[172] 
[DFN[Offset Date-Time]] は、 [[時間]]の特定の[[瞬間]]を表すものです。
[[RFC 3339]] [CODE[date-time]] で、[[時差]]が指定されたものです。 [SRC[>>170]]

[174] 
[DFN[Local Date-Time]] は、[[時差・時間帯を記述せずに特定の日時を表すもの][浮動時]]です。
[[RFC 3339]] [CODE[date-time]] で、[[時差]]を省いたものです。 [SRC[>>170]]

[175] 
追加の情報がないと特定の瞬間に変換することはできず、その必要が生じた場合の方法は[[実装規定]]です。
[SRC[>>170]]

[177] 
[DFN[Local Time]] は、[[日]]、[[時差]]・[[時間帯]]を記述せずに[[日の時刻]]を表すものです。
[[RFC 3339]] [CODE[date-time]] の[[時刻]]部分のみを使ったものです。 [SRC[>>170]]

[173] これら3つの形式において、[[秒の小数部]]の[[精度]]は[[実装規定]]としますが、
最低でも[[ミリ秒]][[精度]]を持つことが期待されます。
実装が扱える[[精度]]よりも細かい値が与えられた時、
[[丸め]]るのではなく、[[切り捨て]]なければなりません。 [SRC[>>170]]

[176] 
[DFN[Local Date]] は、[[時差]]・[[時間帯]]を記述せずに特定の[[日]]の全体を表すものです。
[[RFC 3339]] [CODE[date-time]] の[[日付]]部分のみを使ったものです。 [SRC[>>170]]

[REFS[
- [170] [CITE@en[toml-lang/toml: Tom's Obvious, Minimal Language]] ([TIME[2017-06-17 12:17:03 +09:00]]) <https://github.com/toml-lang/toml#user-content-offset-date-time>
]REFS]

** MongoDB の変種

[255] 
[[MongoDB Extended JSON (v2)]]
の
[CODE[Date]]
は
[[RFC 3339の日時形式]]の[[プロファイル]]を規定しています。
次の制約があります。
[SEE[ [[MongoDB Extended JSONにおける日時]] ]]

- [256] [[年]]が [ [N[1970]], [N[9999]] ] になければならず、
それ以外のときは[[ミリ秒Unix time]]の形式を使わなければなりません。
- [257] [[秒の小数部]]は、 [N[0]] のとき省略するべきです。
- [258] [[秒の小数部]]は、指定する時、ちょうど3桁でなければなりません。

* 関連

** ISO 8601 との関係

[7] RFC 3339 の日付・時刻形式は、 [[ISO 8601の日付形式]]の[[部分集合]]です
(一部怪しいですが)。
基本的に [[RFC 3339]] 形式の[[日時]]は、
[[ISO 8601]] 形式の[[日時]]でもあります。
逆は必ずしも[[真]]ではありません。

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

[88] [[RFC 3339]] には、 (なぜか) [[RFC 3339]] で採用しなかった部分を含む
[[ABNF]] 構文が収録されています。
[SEE[ [[ISO 8601の日時形式]] ]]

[195] 
[[RFC 3339]] 形式の[[日時]]を、 「[[ISO 8601]] 形式の[[日時]]である」
というのは正しいです。
[[RFC 3339]] 形式に対応することを、「[[ISO 8601]] 形式に対応する」
というのは不正確で誤解を招く表現なので、避けるべきです。

[209] 
「[DFN[ISO 8601 (RFC 3339) 形式]]」
という言い方も、少なくないようです。
[[ISO 8601]] のうち [[RFC 3339]] 部分、
というのをこう書くことは、
理論上は間違ってはいません。
しかしこの書き方は
[[ISO 8601]]
の別称が
[[RFC 3339]]
とも解せます。
他にもいろいろ解釈のしようがあります。
敢えて紛らわしい [[ISO 8601]] を併記する意味がわかりません。
誤解を招くだけの表現なので、避けるべきです。

;; [210] 正しく理解していない人が、目についた名前を適当に書いているだけのきらいもあります。
だとすると、このような表現を使った解説は信用できない可能性が高い、
というヒントになるかもしれません。

[REFS[
- [237] [CITE@en[[[RFC 3339]] vs [[ISO 8601]]]], [TIME[2022-02-21T04:57:44.000Z]], [TIME[2022-03-10T05:07:11.730Z]] <https://ijmacd.github.io/rfc3339-iso8601/>
]REFS]

** HTML との関係

[9] [[HTMLの日付形式]] ([[大域日時]]) と似ていますが、 [[HTML]]
では [[T]] や [[Z]] に[[大文字]]を使わなければなりませんし、
[[HTML]] は[[閏秒]]にも対応していません。

[45] [[HTML]] が [[RFC 3339の日時形式]]を採用したことは一度もありません。

[52] [[RFC 3339]] が特別な解釈を与えた値 ([CODE[-00:00]]) を禁止している
[SRC[>>71 ソースコードのコメント参照]] ように、関係性を意識はしていますが、
それは互換性を求める存在というよりは区別されるべき存在としてでしょう。

[72] ところが、一部で [[HTML]] の[[日時]]が [[RFC 3339]] 形式であるとの[[デマ]]が流布されたことがあるようです。
しかもその元をたどると、 (当時まだ [[WHATWG]] と協力関係にあった) [[W3C]]
の [[HTML WG]] の [CITE[HTML: The Markup Language]] という文書でした。
[CODE[/TR/]] で出版された最初の版に既に [[RFC 3339]] 形式を制限したものだとの記載
[SRC[>>73]] があり、 [CODE[/TR/]] で出版された最後の版ではそれが“拡充”されていました
[SRC[>>74, >>75]]。

[76] この文書は、[[著者]]向けを謳って [CITE[HTML 5]] 本体仕様の内容を説明しなおしたものでしたが、
当時から技術的内容が異なる可能性が指摘され、存在意義に疑問を持たれていました。
実際、本来の規定と異なる内容を「[[著者]]向けにわかりやすく」公式に説明することで、
[[デマ]]を拡散してしまったわけです。 (危惧が現実化したことまで当時把握していたかどうかは不明ですが、
この文書は結局未完成のまま破棄されました。落ち着くべきところに落ち着いたのは良かったですが...)

[77] そもそもなぜこの文書が [[RFC 3339]] を参照していたのかは、謎です。
[CITE[HTML 5]] を読まずに書いたわけではないでしょうし。。。

[REFS[
- [71] [CITE@en['''['''ac''']''' (1) disallow -00:00 in a global date and time string]] ([[Hixie]]著, [TIME[2010-09-24 09:55:59 +09:00]]) <https://github.com/whatwg/html/commit/0de3e20f218fb39c9ff649dfb2c33f9dc9f08ba7>
- [73] [CITE[HTML5: Datatypes]] ([TIME[2010-03-05 02:35:56 +09:00]]) <https://www.w3.org/TR/2010/WD-html-markup-20100304/datatypes.html#common.data.datetime>
- [74] [CITE[Data types (common microsyntaxes) - HTML5]] ([TIME[2012-10-25 01:11:22 +09:00]]) <https://www.w3.org/TR/2012/WD-html-markup-20121025/datatypes.html#common.data.datetime>
- [75] [CITE[del – deleted text - HTML5]] ([TIME[2012-10-25 01:11:22 +09:00]]) <https://www.w3.org/TR/2012/WD-html-markup-20121025/del.html#del>
]REFS]

[FIG(amazon)[
[[日付処理]]
]FIG]

* 歴史

[43] [CITE@en[draft-newman-datetime-01 - Date and Time on the Internet]]
([TIME[2017-05-08 04:26:18 +09:00]])
<https://tools.ietf.org/html/draft-newman-datetime-01>

[40] [CITE@en[draft-ietf-impp-datetime-00 - Date and Time on the Internet: Timestamps]]
([TIME[2017-05-02 18:01:36 +09:00]])
<https://tools.ietf.org/html/draft-ietf-impp-datetime-00>

[143] [[W3C-DTF]] には、 [[RFC 3339]] の前の [[I-D]] の影響を受けた旨が記載されています。

** PICS の日時形式

[158] [[PICS]] は [[RFC 3339]] の前の [[I-D]] を参照しつつも、
独自の[[日時形式]]を規定していました。

[161] ものによっては[[日付]]の区切りに [CODE[-]] ではなく [CODE[.]] を使っています
[SRC[>>160]]。

[REFS[
- [213] [CITE[DRAFT-PICS-services-970620]]
([TIME[1998-06-04 03:16:40 +09:00]])
<https://www.w3.org/PICS/Member/NG/DRAFT-PICS-services-970620.html#Syntax>

[FIG(quote)[
[FIGCAPTION[
[214] [CITE[DRAFT-PICS-services-970620]]
([TIME[1998-06-04 03:16:40 +09:00]])
<https://www.w3.org/PICS/Member/NG/DRAFT-PICS-services-970620.html#Semantics>
]FIGCAPTION]

> If not specified, it defaults to "0000-00-00T00:01-0000". If specified, tools that construct profiles may utilize this information in a slider bar or pulldown list. The sign and timezone have no meaning when used with increment, and the MM value may have 00. Typical values are:
> "0001-00-00T00:00-0000" meaning "one year";
> "0000-01-00T00:00-0000" meaning "one month";
> "0000-00-01T00:00-0000" meaning "one day";
> "0000-00-00T01:00-0000" meaning "one hour";
> "0000-00-00T00:01-0000" meaning "one minute"

]FIG]

- [159] [CITE[PICS Labels]] ([TIME[1996-12-09 12:31:01 +09:00]]) <https://www.w3.org/PICS/labels.html>
- [160] [CITE[DSig 1.0 Signature Labels]] ([TIME[2013-05-29 06:37:44 +09:00]]) <https://www.w3.org/TR/PR-DSig-label-971111#Reference_Information>
- [162] [CITE[MD5 Hashing Function - Version 1.0]] ([TIME[1998-04-04 03:23:04 +09:00]]) <https://www.w3.org/TR/1998/PR-DSig-label-19980403/MD5-1_0>
- [163] [CITE[SHA1 version 1.0]] ([TIME[1998-04-04 03:22:38 +09:00]]) <https://www.w3.org/TR/1998/PR-DSig-label-19980403/SHA1-1_0>
]REFS]

[10] [CITE@en[Web Applications 1.0 r5474   disallow -00:00 in a global date and time stringFixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=10370]]
( ([TIME[2010-09-24 09:55:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=5473&to=5474>

[FIG(quote)[
[FIGCAPTION[
[148] [CITE@en[レシートのフィールド]]
([TIME[2017-05-18 00:39:56 +09:00]])
<https://developer.apple.com/jp/documentation/General/ValidateAppStoreReceipt/Chapters/ReceiptFields.html>
]FIGCAPTION]

> IA5STRING(RFC 3339の日付として解釈されます)

]FIG]

[FIG(quote)[
[FIGCAPTION[
[149] [CITE[Amazon CloudSearch での日付と時刻の検索 - Amazon CloudSearch]]
([TIME[2017-05-17 16:00:45 +09:00]])
<http://docs.aws.amazon.com/ja_jp/cloudsearch/latest/developerguide/searching-dates.html>
]FIGCAPTION]

> 日付と時刻は、IETF RFC3339: yyyy-mm-ddTHH:mm:ss.SSSZ に従って、UTC(協定世界時間)で指定されます。たとえば、1970 年 8 月 23 日午後 5 時は、UTC 形式では 1970-08-23T17:00:00Z となります。UTC で時間を指定するときは、小数点以下の秒数も指定できます。例: 1967-01-31T23:20:50.650Z.

]FIG]

[FIG(quote)[
[FIGCAPTION[
[150] [CITE@en[WjInputTime Class - Wijmo 5 Help]]
([TIME[2017-05-18 00:44:01 +09:00]])
<http://wijmo.com/5/docs/topic/wijmo.angular.WjInputTime.Class.html>
]FIGCAPTION]

> If provided, the min and max attributes are strings in the format "hh:mm". Technically, you can use any full date as defined in the W3C '''['''RFC 3339''']''', which is also the format used with regular HTML5 input elements.

]FIG]

[FIG(quote)[
[FIGCAPTION[
[151] [CITE@en[WjInputTime クラス - Wijmo 5 Help]]
([TIME[2017-05-15 02:27:00 +09:00]])
<http://wijmo.c1.grapecity.com/5/docs/topic/wijmo.angular.WjInputTime.Class.html>
]FIGCAPTION]

> min属性とmax属性を指定する場合、それらは書式"hh:mm"の文字列にする必要があります。技術的には、W3Cの'''['''RFC 3339''']'''で定義されている任意の日時を使用できます。これは、標準HTML5入力要素でも使用される書式です。

]FIG]

[152] なぜか [[RFC 3339]] は [[W3C]] が定義したことになっている。
そしてそれは [[HTML5]] [CODE(HTMLe)@en[input]] で使えることになっている
(>>45 にある通り、[[デマ]])。
この説明と例示には「hh:mm」の時刻が示されているのだが、
[[RFC 3339]] で定義された「any full date」が使えるという。
(実装上どちらが正しいのかは知らぬ。)
「any full date」とは何か。そもそも「hh:mm」は「any full date」
に含まれるのか、それともどちらも使えるという意味なのか。
[[RFC 3339]] にある [CODE[full-date]] と関係あるのかどうか。
日本語訳では「任意の日時」となっている。[[日時]]、[[日付]]、[[時刻]]は厳密に使い分けられないことも多々あるが、
この文脈でこういう書き方をされると、何を意図しているのかさっぱりわからなくなる。

[FIG(quote)[
[FIGCAPTION[
[153] [CITE@ja[SVF PDF Archiver Web APIリファレンス]]
([TIME[2017-05-18 00:51:54 +09:00]])
<https://manual.wingarc-support.com/manual/svf/spa93apiref/?pageId=p55980886>
]FIGCAPTION]

> ISO8601 RFC3339 W3CDTF(日付と時刻をTでつなげる)に準拠した文字列(例 "2016-11-22T11:18:43.933+0900")で出力します。

]FIG]

[FIG(quote)[
[FIGCAPTION[
[154] [CITE@ja[Introduction · TRUST DOCK]]
([[Trustdock]]著, [TIME[2017-05-17 10:51:39 +09:00]])
<https://docs.trustdock.io/ja/>
]FIGCAPTION]

> String(RFC3339で定義されているfull-dateに準ずる)

]FIG]

[FIG(quote)[
[FIGCAPTION[
[155] [CITE@ja[Introduction · TRUST DOCK]]
([[Trustdock]]著, [TIME[2017-05-17 10:51:39 +09:00]])
<https://docs.trustdock.io/ja/>
]FIGCAPTION]

> String(RFC3339で定義されているdate-timeに準ずる)

]FIG]

[FIG(quote)[
[FIGCAPTION[
[156] [CITE@ja[イベント(グループ) — サイボウズ Live・API ドキュメント]]
([TIME[2017-04-24 09:42:26 +09:00]])
<https://developer.cybozulive.com/doc/current/pub/gwSchedule.html>
]FIGCAPTION]

> フォーマットは RFC 3339 の日時表現でなければなりません。

]FIG]

[FIG(quote)[
[FIGCAPTION[
[157] [CITE[People Finder Interchange Format 1.4]]
( ([TIME[2017-05-18 02:40:42 +09:00]]))
<https://www.oasis-open.org/committees/download.php/49618/>
]FIGCAPTION]

> All dates and times must be in UTC, never in a local time zone, because data records will be transmitted among many different time zones. This format uses dates in the RFC 3339 format, with only UTC allowed. Front-ends can convert dates and times to the local time zone for display.

]FIG]

[FIG(quote)[
[FIGCAPTION[
[178] [CITE@en[RFC 5323 - Web Distributed Authoring and Versioning (WebDAV) SEARCH]]
([TIME[2017-10-01 13:49:21 +09:00]])
<https://tools.ietf.org/html/rfc5323#section-5.10>
]FIGCAPTION]

> when operand for a comparison with a DAV:creationdate or DAV:
>       getlastmodified property, it SHOULD be treated as a date value in
>       the ISO-8601 subset defined for the DAV:creationdate property (see
>       Section 15.1 of '''['''RFC4918''']'''; the behavior of values not in this
>       format is undefined),

]FIG]

[FIG(quote)[
[FIGCAPTION[
[179] [CITE@en[Concise Binary Object Representation (CBOR)]]
([TIME[2018-02-23 07:30:37 +09:00]])
<https://cbor-wg.github.io/CBORbis/#datetimesect>
]FIGCAPTION]

> Tag value 0 is for date/time strings that follow the standard format described in '''['''RFC3339''']''', as refined by Section 3.3 of '''['''RFC4287''']'''.

]FIG]

[FIG(quote)[
[FIGCAPTION[
[180] [CITE@en[Language Guide (proto3)  |  Protocol Buffers  |  Google Developers]]
([TIME[2018-04-07 03:12:07 +09:00]])
<https://developers.google.com/protocol-buffers/docs/proto3>
]FIGCAPTION]

> Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted.

]FIG]

[189] [CITE@en[dateTime reference when mapping to JSON types '''['''I18N''']''' · Issue #641 · w3c/wot-thing-description]]
([TIME[2019-07-04 10:41:29 +09:00]])
<https://github.com/w3c/wot-thing-description/issues/641>

[FIG(quote)[
[FIGCAPTION[
[193] [CITE@ja[REST リソース: urlNotifications  |  検索  |  Google Developers]]
([TIME[2019-12-18 02:56:05 +09:00]])
<https://developers.google.com/search/apis/indexing-api/v3/reference/indexing/rest/v3/urlNotifications>
]FIGCAPTION]

> RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒。例: "2014-10-02T15:01:23.045123456Z"

]FIG]

[FIG(quote)[
[FIGCAPTION[
[194] [CITE@en[Google: google_data_fusion_instance - Terraform by HashiCorp]]
([TIME[2020-01-08 05:56:54 +09:00]])
<https://www.terraform.io/docs/providers/google/r/data_fusion_instance.html>
]FIGCAPTION]

> create_time - The time the instance was created in RFC3339 UTC "Zulu" format, accurate to nanoseconds.

]FIG]

[217] [CITE[JSON Feed - JSON Feed Version 1.1]]
([TIME[2020-08-11T17:02:07.000Z]], [TIME[2020-10-07T03:08:22.330Z]])
<https://jsonfeed.org/version/1.1#items>

[219] [CITE['''['''tz''']''' make rearguard_tarballs fails on macOS]]
([TIME[2020-10-18T00:48:51.000Z]], [TIME[2020-10-18T01:13:33.081Z]])
<https://mm.icann.org/pipermail/tz/2020-October/029362.html>

[230] [CITE@en[draft-ryzokuken-datetime-extended-02]], [TIME[2021-07-07T01:06:43.000Z]] <https://datatracker.ietf.org/doc/html/draft-ryzokuken-datetime-extended-02>

[231] [CITE@EN-US[CACAO Security Playbooks Version 1.0]]
([TIME[2021-01-12T17:00:00.000Z]], [TIME[2021-08-19T04:20:29.654Z]])
<https://docs.oasis-open.org/cacao/security-playbooks/v1.0/cs01/security-playbooks-v1.0-cs01.html#_xl5n20qrhhr5>

[232] [CITE@en[draft-ietf-sedate-datetime-extended-00]], [TIME[2021-09-21T10:06:04.000Z]] <https://datatracker.ietf.org/doc/html/draft-ietf-sedate-datetime-extended>

[233] [CITE@en[sedate]], [TIME[2021-09-21T10:07:35.000Z]] <https://mailarchive.ietf.org/arch/browse/sedate/>

[234] [CITE@en-US[IAB Minutes 2021-08-25 | Internet Architecture Board]], [TIME[2021-09-21T10:09:31.000Z]] <https://www.iab.org/documents/minutes/minutes-2021/iab-minutes-2021-08-25/>

[236] [CITE@en[Serialising Extended Data About Times and Events (sedate) -]], [TIME[2021-09-21T10:10:32.000Z]] <https://datatracker.ietf.org/wg/sedate/about/>

[235] [CITE@en[Minutes IETF111: sedate]], [TIME[2021-09-21T10:10:04.000Z]] <https://datatracker.ietf.org/doc/minutes-111-sedate/>

Historical Legal Sensitive Parent: [Help / License]

Edit

Page

Errors

Page name(s)