openstack/api-sig
Code Issues Proposed changes

Guidelines on using date and time format

Browse Source 
Change-Id: Ia5ac88f6488b470f652d740ff191259a9ceac493
This commit is contained in:
Yuriy Nesenenko 2015-02-27 17:34:49 +02:00
parent 93d6697b5c
commit 065f939fd4
1 changed files with 19 additions and 0 deletions

19
guidelines/time.rst Normal file

@ -0,0 +1,19 @@
Date and Time Conventions
=========================
This topic document serves to provide guidance on how to format dates and times
in the OpenStack public REST APIs.
REST API
--------
* APIs should use ISO 8601 format to return dates and times in resource
representations. For more information see [1]_.
* It is recommended that the Coordinated Universal Time (UTC) is used to avoid
differences in time. For more information see [2]_.
* Clients should also use the ISO 8601 format when providing dates to the
server. The API server should be able to parse and interpret any valid
ISO 8601 timestamp in any timezone.
.. [1] http://en.wikipedia.org/wiki/ISO_8601
.. [2] http://en.wikipedia.org/wiki/Coordinated_Universal_Time