Formato de datas

Ao criar um evento utilizando o dito.track() ou a Rest API, é possível enviar dados adicionais e específicos para cada evento usando o nó data.

Esses dados poderão ser utilizados posteriormente para filtrar seus usuários baseados em seu comportamento. Para que os filtros funcionem corretamente, é necessário que as informações sobre data e hora sejam enviadas em um formato suportado pela plataforma Dito.

Formatos suportados

O parsing das datas é feito utilizando a biblioteca Joda. O parser utilizado é o ISODateTimeFormat.dateOptionalTimeParser.

Os formatos suportados por esse parser são:

date-opt-time     = date-element ['T' [time-element] [offset]]
date-element      = std-date-element | ord-date-element | week-date-element
std-date-element  = yyyy ['-' MM ['-' dd]]
ord-date-element  = yyyy ['-' DDD]
week-date-element = xxxx '-W' ww ['-' e]
time-element      = HH [minute-element] | [fraction]
minute-element    = ':' mm [second-element] | [fraction]
second-element    = ':' ss [fraction]
fraction          = ('.' | ',') digit+

O significado de cada símbolo pode ser visto na tabela abaixo:

Symbol  Meaning                      Presentation  Examples
------  -------                      ------------  -------
G       era                          text          AD
C       century of era (>=0)         number        20
Y       year of era (>=0)            year          1996

x       weekyear                     year          1996
w       week of weekyear             number        27
e       day of week                  number        2
E       day of week                  text          Tuesday; Tue

y       year                         year          1996
D       day of year                  number        189
M       month of year                month         July; Jul; 07
d       day of month                 number        10

a       halfday of day               text          PM
K       hour of halfday (0~11)       number        0
h       clockhour of halfday (1~12)  number        12

H       hour of day (0~23)           number        0
k       clockhour of day (1~24)      number        24
m       minute of hour               number        30
s       second of minute             number        55
S       fraction of second           number        978

z       time zone                    text          Pacific Standard Time; PST
Z       time zone offset/id          zone          -0800; -08:00; America/Los_Angeles

'       escape for text              delimiter
''      single quote                 literal

Alguns exemplos de datas suportadas:

2015-02-19T17:13:57-02:00 (padrão ISO 8601)
2015-02-19
2015-189 (ano e dia do ano)
2015-W27-2 (ano, semana do ano e dia da semana)