third-party-mirrors/EDDN
1
0
Fork 0
mirror of https://github.com/EDCD/EDDN.git synced 2025-06-11 04:42:28 +03:00
Code Issues Actions Packages Projects Releases Wiki Activity

docs/README schemas: Be explicit about sub-second timestamp resolution

Browse Source
This commit is contained in:
Athanasius 2022-06-24 14:48:11 +01:00
parent 83a7d451ef
commit 723e966b37
No known key found for this signature in database
GPG Key ID: AE3E527847057C7D
1 changed files with 11 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
schemas/README-EDDN-schemas.md
View File

@ -49,11 +49,17 @@ contents all Schemas specify a top-level JSON Object with the data:
Each `message` object must have, at bare minimum: Each `message` object must have, at bare minimum:
1. `timestamp` - string date and time in ISO8601 format. Whilst this 1. `timestamp` - string date and time in ISO8601 format.
technically allows for any timezone to be cited you SHOULD provide this in 1. Whilst this technically allows for any timezone to be cited you SHOULD
UTC, aka 'Zulu Time' as in the example above. You MUST ensure that you are provide this in UTC, aka 'Zulu Time' as in the example above.
doing this properly. Do not claim 'Z' whilst actually using a local time You MUST ensure that you are doing this properly.
that is offset from UTC. Do not claim 'Z' whilst actually using a local time that is offset from
UTC.
2. Historically we had never been explicit about if Senders should include
sub-second resolution in the timestamps, or if Listeners should be
prepared to accept such. As of 2022-06-24 we are explicitly stating that
Senders **MAY** include sub-second resolution, and Listeners **MUST**
be prepared to accept such.
If you are only utilising Journal-sourced data then simply using the If you are only utilising Journal-sourced data then simply using the
value from there should be sufficient as the PC game client is meant to value from there should be sufficient as the PC game client is meant to