From 065f939fd49e8710913590865b9eb025870af387 Mon Sep 17 00:00:00 2001
From: Yuriy Nesenenko <ynesenenko@mirantis.com>
Date: Fri, 27 Feb 2015 17:34:49 +0200
Subject: [PATCH] Guidelines on using date and time format

Change-Id: Ia5ac88f6488b470f652d740ff191259a9ceac493
---
 guidelines/time.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
 create mode 100644 guidelines/time.rst

diff --git a/guidelines/time.rst b/guidelines/time.rst
new file mode 100644
index 0000000..8feeb9b
--- /dev/null
+++ b/guidelines/time.rst
@@ -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