I'm new to swagger and writing my first spec. I've found following swagger "date" types*:

------------------------------------------------
| Common name        |  Swagger spec 1.2       |
------------------------------------------------
| string             |  string                 |
------------------------------------------------
| date               | string, date            |
------------------------------------------------
| dateTime           | string, date-time       |
------------------------------------------------

Now my timestamp looks like 2014-12-09T13:06:08.260+0000 is this even a Date? It doens't look like the date javascript new Date(); returns. I also haven't found a date type in the json specification.

Which type and format should i take, will it be better to take string instead of a date??

*: note this table is the short version from the swager wiki

I'm new to swagger and writing my first spec. I've found following swagger "date" types*:

------------------------------------------------
| Common name        |  Swagger spec 1.2       |
------------------------------------------------
| string             |  string                 |
------------------------------------------------
| date               | string, date            |
------------------------------------------------
| dateTime           | string, date-time       |
------------------------------------------------

Now my timestamp looks like 2014-12-09T13:06:08.260+0000 is this even a Date? It doens't look like the date javascript new Date(); returns. I also haven't found a date type in the json specification.

Which type and format should i take, will it be better to take string instead of a date??

*: note this table is the short version from the swager wiki

• javascript
• json
• rest
• date
• swagger

1 Answer 1

2014-12-09T13:06:08.260+0000 is a variation of ISO8601 date and time standard. JavaScript Date function can easily parse this format and Date has toISOString() method to produce strings in this format. The only thing is that letter "Z" is usually used to denote GMT/UTC time zone instead of "+0000". But Date can parse it like that too.