{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","params":[],"results":{"codes":[]}},"next":{"description":"","pages":[]},"title":"Formato de datas","type":"basic","slug":"formato-de-datas","excerpt":"","body":"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`.\n\nEsses 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.\n\n### Formatos suportados\n\nO parsing das datas é feito utilizando a biblioteca [Joda](http://joda-time.sourceforge.net/old-index.html). O parser utilizado é o [ISODateTimeFormat.dateOptionalTimeParser](http://joda-time.sourceforge.net/api-release/org/joda/time/format/ISODateTimeFormat.html#dateOptionalTimeParser).\n\nOs formatos suportados por esse parser são: \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"date-opt-time     = date-element ['T' [time-element] [offset]]\\ndate-element      = std-date-element | ord-date-element | week-date-element\\nstd-date-element  = yyyy ['-' MM ['-' dd]]\\nord-date-element  = yyyy ['-' DDD]\\nweek-date-element = xxxx '-W' ww ['-' e]\\ntime-element      = HH [minute-element] | [fraction]\\nminute-element    = ':' mm [second-element] | [fraction]\\nsecond-element    = ':' ss [fraction]\\nfraction          = ('.' | ',') digit+\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]\nO significado de cada símbolo pode ser visto na tabela abaixo: \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"Symbol  Meaning                      Presentation  Examples\\n------  -------                      ------------  -------\\nG       era                          text          AD\\nC       century of era (>=0)         number        20\\nY       year of era (>=0)            year          1996\\n\\nx       weekyear                     year          1996\\nw       week of weekyear             number        27\\ne       day of week                  number        2\\nE       day of week                  text          Tuesday; Tue\\n\\ny       year                         year          1996\\nD       day of year                  number        189\\nM       month of year                month         July; Jul; 07\\nd       day of month                 number        10\\n\\na       halfday of day               text          PM\\nK       hour of halfday (0~11)       number        0\\nh       clockhour of halfday (1~12)  number        12\\n\\nH       hour of day (0~23)           number        0\\nk       clockhour of day (1~24)      number        24\\nm       minute of hour               number        30\\ns       second of minute             number        55\\nS       fraction of second           number        978\\n\\nz       time zone                    text          Pacific Standard Time; PST\\nZ       time zone offset/id          zone          -0800; -08:00; America/Los_Angeles\\n\\n'       escape for text              delimiter\\n''      single quote                 literal\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]\n Alguns exemplos de datas suportadas:\n\n* `2015-02-19T17:13:57-02:00` (padrão ISO 8601)\n* `2015-02-19`\n* `2015-189` (ano e dia do ano)\n* `2015-W27-2` (ano, semana do ano e dia da semana)","updates":[],"order":2,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"554a5f2f156a480d00e29230","version":{"version":"1.0","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5538fb25dc5dd00d00e1da95","5538feec27f8540d0024f00e","5547cbd3d3427d0d00cd6e2d","554a574f0b54d30d007fe0f9","55afbdbef202b12100cd9eeb","5c016f198e69b802d4385e25","5c81470b175ad6002457d9fa","5c81472e74fd5a0063420bae","5c81476b2dd69100430ea5a4"],"_id":"5538fb25dc5dd00d00e1da94","createdAt":"2015-04-23T14:01:09.040Z","project":"5538fb24dc5dd00d00e1da91","__v":9,"releaseDate":"2015-04-23T14:01:09.040Z"},"project":"5538fb24dc5dd00d00e1da91","user":"5538fa99545cd90d0011e593","__v":8,"createdAt":"2015-05-06T18:36:31.109Z","category":{"sync":{"isSync":false,"url":""},"pages":["5538fb26dc5dd00d00e1da97","5538fe94fd56310d00b1740f","554a5f2f156a480d00e29230","55b0f279b3c7f62b00e5ca83","566b23cbc7c3cd1700265dc1"],"title":"Começando a usar","slug":"começando-a-usar","order":0,"from_sync":false,"reference":false,"_id":"5538fb25dc5dd00d00e1da95","createdAt":"2015-04-23T14:01:09.535Z","version":"5538fb25dc5dd00d00e1da94","project":"5538fb24dc5dd00d00e1da91","__v":5},"githubsync":"","parentDoc":null}
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](http://joda-time.sourceforge.net/old-index.html). O parser utilizado é o [ISODateTimeFormat.dateOptionalTimeParser](http://joda-time.sourceforge.net/api-release/org/joda/time/format/ISODateTimeFormat.html#dateOptionalTimeParser). Os formatos suportados por esse parser são: [block:code] { "codes": [ { "code": "date-opt-time = date-element ['T' [time-element] [offset]]\ndate-element = std-date-element | ord-date-element | week-date-element\nstd-date-element = yyyy ['-' MM ['-' dd]]\nord-date-element = yyyy ['-' DDD]\nweek-date-element = xxxx '-W' ww ['-' e]\ntime-element = HH [minute-element] | [fraction]\nminute-element = ':' mm [second-element] | [fraction]\nsecond-element = ':' ss [fraction]\nfraction = ('.' | ',') digit+", "language": "text" } ] } [/block] O significado de cada símbolo pode ser visto na tabela abaixo: [block:code] { "codes": [ { "code": "Symbol Meaning Presentation Examples\n------ ------- ------------ -------\nG era text AD\nC century of era (>=0) number 20\nY year of era (>=0) year 1996\n\nx weekyear year 1996\nw week of weekyear number 27\ne day of week number 2\nE day of week text Tuesday; Tue\n\ny year year 1996\nD day of year number 189\nM month of year month July; Jul; 07\nd day of month number 10\n\na halfday of day text PM\nK hour of halfday (0~11) number 0\nh clockhour of halfday (1~12) number 12\n\nH hour of day (0~23) number 0\nk clockhour of day (1~24) number 24\nm minute of hour number 30\ns second of minute number 55\nS fraction of second number 978\n\nz time zone text Pacific Standard Time; PST\nZ time zone offset/id zone -0800; -08:00; America/Los_Angeles\n\n' escape for text delimiter\n'' single quote literal", "language": "text" } ] } [/block] 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)