diff --git a/jsonschema-validation.xml b/jsonschema-validation.xml index 8c90bdb2..79c30f9b 100644 --- a/jsonschema-validation.xml +++ b/jsonschema-validation.xml @@ -799,14 +799,48 @@
-
- - This attribute applies to string instances. +
+ + These attributes apply to string instances. + + + Date and time format names are derived from + RFC 3339, section 5.6. + + + Implementations supporting formats SHOULD implement support for + the following attributes: + + + A string instance is valid against this attribute if it is + a valid representation according to the "date-time" production. + + + A string instance is valid against this attribute if it is + a valid representation according to the "full-date" production. + + + A string instance is valid against this attribute if it is + a valid representation according to the "full-time" production. + + - A string instance is valid against this attribute if it is a valid date - representation as defined by RFC 3339, section - 5.6. + Implementations MAY support additional attributes using the other + production names defined in that section. If "full-date" or "full-time" + are implemented, the corresponding short form ("date" or "time" + respectively) MUST be implemented, and MUST behave identically. + Implementations SHOULD NOT define extension attributes + with any name matching an RFC 3339 production unless it validates + according to the rules of that production. + + There is not currently consensus on the need for supporting + all RFC 3339 formats, so this approach of reserving the + namespace will encourage experimentation without committing + to the entire set. Either the format implementation requirements + will become more flexible in general, or these will likely + either be promoted to fully specified attributes or dropped. +