feat: Document datetime and date formats (#1565)

Add a new document that precisely describes the string representation of
datetime and date types.

The previous description of them as "ISO 8601 Datetime" was very
imprecise, as ISO 8601 describes many different ways of representing a
datetime and date.

Specify the datetime format precisely as the ISO 8601 profile described
in RFC 3339, and the date format precisely as the "Complete date" format
from the W3C note on date and time formats.

Adjust all the references to ISO 8601 datetimes or dates to link back
to the definition.

Fixes #1420
This commit is contained in:
Nik Clayton 2024-11-27 16:08:51 +01:00 committed by GitHub
parent 09dc6a85cd
commit 49868155b9
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
35 changed files with 117 additions and 54 deletions

View file

@ -79,7 +79,7 @@ language
: String. ISO 639 language code for this status.
scheduled_at
: String. ISO 8601 Datetime at which to schedule a status. Providing this parameter will cause ScheduledStatus to be returned instead of Status. Must be at least 5 minutes in the future.
: String. [Datetime](/api/datetime-format#datetime) at which to schedule a status. Providing this parameter will cause ScheduledStatus to be returned instead of Status. Must be at least 5 minutes in the future.
#### Response
##### 200: OK
@ -696,7 +696,7 @@ Translating a status with poll into English
"id": 34858,
"options": [
{
"title": "Stay"
"title": "Stay"
},
{
"title": "Go"
@ -758,7 +758,7 @@ Authorization
##### Query parameters
max_id
max_id
: **Internal parameter.** Use HTTP `Link` header for pagination.
since_id
@ -829,7 +829,7 @@ Authorization
##### Query parameters
max_id
max_id
: **Internal parameter.** Use HTTP `Link` header for pagination.
since_id