@@ -227,35 +227,35 @@ Instead, include the expected format in the description and provide examples.
227
227
To help users distinguish between dates (strings) and timestamps (integers),
228
228
use the following terms consistently :
229
229
230
- - Use **Date and time** for dates in [RFC3339 ](https://datatracker.ietf.org/doc/html/rfc3339) (ISO 8601) format.
230
+ - Use **Date and time** for dates in [RFC 3339 ](https://datatracker.ietf.org/doc/html/rfc3339) (ISO 8601) format.
231
231
- Use **Timestamp** for timestamps in seconds or milliseconds since the [Unix epoch](https://en.wikipedia.org/wiki/Unix_time).
232
232
233
233
# ### Example: date and time
234
234
235
- Use _Date and time ..., in RFC3339 format_.
235
+ Use _Date and time ..., in RFC 3339 format_.
236
236
Don't link to the RFC, and don't use ISO 8601.
237
237
Don't use _timestamp_ for dates and times.
238
238
239
239
```
240
240
createdAt:
241
241
type: string
242
- description: Date and time when the object was created, in RFC3339 format.
242
+ description: Date and time when the object was created, in RFC 3339 format.
243
243
example: 2024-04-06T08:08:08Z
244
244
```
245
245
246
246
<details>
247
- <summary>RFC3339 vs ISO 8601</summary>
247
+ <summary>RFC 3339 vs ISO 8601</summary>
248
248
249
- RFC3339 is slightly less ambiguous than ISO 8601 and leads to more readable dates.
250
- Since RFC3339 is a _profile_ of ISO 8601,
251
- every RFC3339 date also complies with ISO 8601,
252
- but not every ISO 8601 date complies with RFC3339 .
249
+ RFC 3339 is slightly less ambiguous than ISO 8601 and leads to more readable dates.
250
+ Since RFC 3339 is a _profile_ of ISO 8601,
251
+ every RFC 3339 date also complies with ISO 8601,
252
+ but not every ISO 8601 date complies with RFC 3339 .
253
253
254
- For example, `2024-04-06T00:00:00` conforms to both RFC3339 and ISO 8601.
254
+ For example, `2024-04-06T00:00:00` conforms to both RFC 3339 and ISO 8601.
255
255
But `20240406T000000` only conforms to ISO 8601, which allows omitting the `-` and `:` separators.
256
256
257
257
**Exception:** ISO 8601 requires date and time to be separated by `T`,
258
- whereas RFC3339 permits a space character for the sake of readability.
258
+ whereas RFC 3339 permits a space character for the sake of readability.
259
259
It's best to avoid this ambiguity.
260
260
261
261
</details>
0 commit comments