Data Formats - gaodp/gga-api GitHub Wiki
Throughout the API documentation I've listed a few data types that have a particular format. This page outlines the details of the expected format for each of those.
Date
In places where the format expected/provided is Date, you're going to see a string representation of a particular calendar date in ISO 8601 format. For those who don't have the entire ISO memorized, the format of YYYY-MM-DD
. So, for January 1st, 2011, you'd see 2011-01-01
.
DateTime
In places where the format expected/provided is DateTime, you're going to see a string representation of a particular time to the nearest second. For most API resources, data on seconds isn't provided by the Georgia General Assembly website, but we'll provide it in our timestamps all the same. The format for these strings is YYYY-MM-DDTHH:MM:SS
. So, for 11 AM on January 1st, 2011, you'd see: 2011-01-01T11:00:00
.
Because this API could be accessed from around the world, all time stamps understood and returned from the API will be in UTC. The API consumer is responsible for converting times in queries / results to and from the time zone they wish to present to the user.