Rules voor Date en DateTime attributen

[BvanRaaij]

Ik zou willen voorstellen een (of meer?) rules op te nemen voor het gebruik van date- en datetime attributen in schemas. In de praktijk zie ik dat hier enorm mee geknoeid wordt waardoor begrijpelijkheid , implementatiegemak (voor clients) en data kwaliteit onder druk komt te staan (bijv. datums die per ongeluk verschuiven agv timezoneconversies). Ik ben zelf erg fan van de de 5 laws of date and time ([https://apiux.com/2013/03/20/5-laws-api-dates-and-times/]) met als belangrijkste rule: gebruik geen datetimes als je date wil uitwisselen. In het kort:

• gebruik ISO 8601 (dus yyyy-mm-dd voor dates en yyyy-mm-ddThh:mi:ss+/-hh:mi of yyyy-mm-ddThh:mi:ssZ voor datetimes
• gebruik dates en geen datetimes als je alleen maar dates wil uitwisselen(!)
• (als je wel datetimes gebruikt) accepteer elke timezone die een client aangeeft
• converteer inkomende datatimes naar UTC en sla dat op (evt met de timezone-identifier die de client meegestuurd heeft)
• geef datetimes altijd in UTC (Z) terug in je respons. De client kan deze naar de door hem gewenste tijdzone converteren

[TimvdLippe]

We agenderen deze op het volgende TO van 2025-05-13 om te bespreken of we data willen standaardiseren. Op basis daarvan besluiten we om het verder uit te werken of niet.

[TimvdLippe]

Actiepunt van TO: @sanderke inlezen op de OAuth standaard wat die zegt over data en tijden. Het liefst willen we over onze standaarden/profielen heen een uniforme aanpak voor data en tijden.