Timestamps

Timestamps

Voor het gebruik van datums en tijdstippen volgt het afsprakenstelsel het iSHARE framework. iSHARE specificeert dat ISO8601 UTC (zulu) inclusief milliseconden (bijvoorbeeld "2026-02-12T00:00:00.000Z") gebruikt moet worden in API endpoints zoals gedefinieerd door iSHARE. Voor het DSGO vertaalt zich dat naar alle DSGO gedefineerde API JSON objecten.

Varianten zonder milliseconden kunnen ook gebruikt worden, maar dienen intern aangevuld tot aan milliseconden, bijvoorbeeld van "2026-02-12T00:00:00Z" naar "2026-02-12T00:00:00.000Z".

ISO8601 UTC is onafhankelijk van een tijdzone. Dit heeft voordelen voor computersystemen voor het bijhouden en sorteren van gedateerde informatie in dynamische en gedistribueerde toepassingen, zowel online als client-side. Daarnaast is ISO8601 UTC in JSON human readable, en best practice in RESTful API's.

DSGO.Basis: Partijen MOETEN datums en tijdstippen in DSGO gedefinieerde API JSON objecten formatteren volgens ISO8601 UTC (zulu). DSGO gebruikt een specifiek Timestamp format voor iat en exp claims in JWT payloads, zie de pagina over JWT.

Let op: Het DSGO is data-agnostisch en maakt geen generieke afspraken over de inhoud van de datadiensten. Voor semantiek bepaalt de datadienstaanbieder de gebruikte standaarden (zoals DICO) in data service endpoints zoals gedefinieerd door de desbetreffende datadienstaanbieder. Als deze gebruikte standaard bijvoorbeeld een andere definitie voor tijdnotatie of organisatie identifier gebruikt, dan is dat toegestaan.