Formato de datas#

Esta API retorna e recebe dados codificados em JSON para todas as chamadas. JSON não tem um tipo nativo para representar datas e horas. Dessa forma, convencionamos duas formas para representar data e hora:

  • Formato ISO 8601:

    • YYYY-MM-DDTHH:MM:SS.mmmmmm; onde mmmmmm é opcional e representa microsegundos. Por exemplo: 2015-01-30T19:21:30.340361

    • YYYY-MM-DDTHH:MM:SS, se microsegundos é 0. Por exemplo: 2015-01-30T19:21:30

    • Todas as horas são expressas no fuso-horário (timezone) UTC.

  • Como um inteiro:

    • Que representa a quantidade de milisegundos desde Jan 1, 1970 00:00:00 UTC.

    Nestes casos o campo no JSON possui um sub-objeto de chave $date, por exemplo: {"$date": 1462922744000}

O timestamp pode ser convertido em alguma dessas formas:

from datetime import datetime

datetime_x = datetime.utcfromtimestamp(timestamp / 1000)

java.util.Date time = new java.util.Date((long)timeStamp);

DateTime x = new DateTime(1970, 1, 1).AddSeconds(timeStamp/1000);