How does Vizion format timestamps?

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


TIP: Vizion timestamps are provided as valid ISO8601 so that most languages' standard date libraries should be able to parse them directly without any extra work.

Vizion provides timestamps in the ISO8601 format. The value for timestamps can come in 3 potential forms, depending on the level of enrichment Vizion was able to provide.

The definitions are as follows:

  • 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.