Timestamp format

Here you will find information on how Vizion formats date, time, and UTC offset.

Vizion provides timestamps in the ISO8601 format so that most languages' standard date libraries should be able to parse them directly without any extra work. The value for timestamps can come in three potential forms, depending on the level of enrichment Vizion was able to provide:

Timestamp is null

If you receive a null value for a timestamp Vizion was not able to locate date and time information for this event or the information found could not be parsed.

Timestamp is formatted as yyyy-MM-dd'T'HH:mm:ss.SSSZ (e.g. "2021-01-17T23:58:00.000Z")

If date and time information is available but no further location information could be determined to identify the timezone in which the event occured the timezone will be set to UTC.

Timestamp is formatted as yyyy-MM-dd'T'HH:mm:ss.SSS+/-ZZ:ZZ (e.g. "2021-01-17T23:58:00.000+08:00")
All information for date, time, and location have been found and are reported in the timezone in which the event occurred. The offset provided quickly allows for conversion to UTC.