Skip to content

Commit 1b6432a

Browse files
committed
Reference RFC 1123 for header date format
1 parent 2b8b716 commit 1b6432a

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

azure/Guidelines.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -159,7 +159,7 @@ Integer | -2<sup>53</sup>+1 to +2<sup>53</sup>-1 (for consistency with JSON li
159159
Float | [IEEE-754 binary64](https://en.wikipedia.org/wiki/Double-precision_floating-point_format)
160160
String | (Un)quoted?, max length, legal characters, case-sensitive, multiple delimiter
161161
UUID | 123e4567-e89b-12d3-a456-426614174000 (no {}s, hyphens, case-insensitive) [RFC4122](https://datatracker.ietf.org/doc/html/rfc4122)
162-
Date/Time (Header) | Sun, 06 Nov 1994 08:49:37 GMT [RFC7231](https://datatracker.ietf.org/doc/html/rfc7231#section-7.1.1.1)
162+
Date/Time (Header) | Sun, 06 Nov 1994 08:49:37 GMT [RFC 1123, Section 5.2.14](https://datatracker.ietf.org/doc/html/rfc1123#page-55)
163163
Date/Time (Query parameter) | YYYY-MM-DDTHH:mm:ss.sssZ (with at most 3 digits of fractional seconds) [RFC3339](https://datatracker.ietf.org/doc/html/rfc3339)
164164
Byte array | Base-64 encoded, max length
165165
Array | One of a) a comma-separated list of values (preferred), or b) separate `name=value` parameter instances for each value of the array
@@ -195,7 +195,9 @@ retry-after | Response | 180 (see [RFC 7231, Section 7.1.3](https://da
195195

196196
:white_check_mark: **DO** compare request header values using case-sensitivity if the header name requires it
197197

198-
:white_check_mark: **DO** accept and return date values in headers using the HTTP Date format as defined in [RFC 7231, Section 7.1.1.1](https://datatracker.ietf.org/doc/html/rfc7231#section-7.1.1.1), e.g. "Sun, 06 Nov 1994 08:49:37 GMT"
198+
:white_check_mark: **DO** accept and return date values in headers using the HTTP Date format as defined in [RFC 1123, Section 5.2.14](https://datatracker.ietf.org/doc/html/rfc1123#page-55), e.g. "Sun, 06 Nov 1994 08:49:37 GMT".
199+
200+
Note: RFC 1123 defines the date format as a modification of the date format in [RFC 822, Section 5](https://datatracker.ietf.org/doc/html/rfc822#section-5) to support either a 2 or 4 digit year, and further recommends that a 4 digit year always be used.
199201

200202
:no_entry: **DO NOT** fail a request that contains an unrecognized header. Headers may be added by API gateways or middleware and this must be tolerated
201203

0 commit comments

Comments
 (0)