Context and Problem Statement🔗
The question is whether the REST Api should return an ISO8601 formatted string in UTC timezone, or the unix time (number of milliseconds since 1970-01-01).
There is quite some controversy about it.
- https://stackoverflow.com/questions/47426786/epoch-or-iso8601-date-format
- https://nbsoftsolutions.com/blog/designing-a-rest-api-unix-time-vs-iso-8601
In my opinion, the ISO8601 format (always UTC) is better. The reason is the better readability. But elm folks are on the other side:
- https://package.elm-lang.org/packages/elm/time/1.0.0#iso-8601
- https://package.elm-lang.org/packages/rtfeldman/elm-iso8601-date-strings/latest/
One can convert from an ISO8601 date-time string in UTC time into the epoch millis and vice versa. So it is the same to me. There is no less information in a ISO8601 string than in the epoch millis.
To avoid confusion, all date/time values should use the same encoding.
Decision Outcome🔗
I go with the epoch time. Every timestamp/date-time values is transfered as Unix timestamp.
Reasons:
- the Elm application needs to frequently calculate with these values to render the current waiting time etc. This is better if there are numbers without requiring to parse dates first
- Since the UI is written with Elm, it's probably good to adopt their style