Change time argument list from var-args to explicit args

This makes the usage of time clearer and more self documenting, and less
error prone. It also updates the docstring with guidance on arg types.

Fixes apa512#87

CHANGELOG.md

@@ -16,6 +16,7 @@ All notable changes to this project will be documented in this file. This change
 - Update docstring for `rethinkdb.query/without`.
 - Update arity and docstring for `rethinkdb.query/merge` to support merging any number of objects.
 - Add new arity to `rethinkdb.query/index-create` to allow creating simple indexes from field names. [#86](https://github.com/apa512/clj-rethinkdb/pull/86)
+- Update `rethinkdb.query/time` arity to only allow 3, 4, 6, and 7 arguments. Also update docstring to make usage clearer. This was already enforced on the server, but will now be enforced by the client library too. [#87](https://github.com/apa512/clj-rethinkdb/issues/87)
 
 ## [0.10.1] - 2015-07-08
 ### Added

src/rethinkdb/query.cljc

@@ -650,13 +650,25 @@
   (term :NOW []))
 
 (defn time
-  "Create a time object for a specific time."
-  [& date-time-parts]
-  (let [args (concat date-time-parts
-                     (if (string? (last date-time-parts))
-                       []
-                       ["+00:00"]))]
-    (term :TIME args)))
+  "Create a time object for a specific time.
+
+  - year is an integer between 1400 and 9999.
+  - month is an integer between 1 and 12.
+  - day is an integer between 1 and 31.
+  - hour is an integer.
+  - minutes is an integer.
+  - seconds is a double. Its value will be rounded to three decimal places (millisecond-precision).
+  timezone can be 'Z' (for UTC) or a string with the format ±[hh]:[mm].
+
+  If tz is not supplied then UTC is used."
+  ([year month day]
+    (time year month day "Z"))
+  ([year month day tz]
+    (term :TIME [year month day tz]))
+  ([year month day hour minute second]
+    (time year month day hour minute second "Z"))
+  ([year month day hour minute second tz]
+    (term :TIME [year month day hour minute second tz])))
 
 (defn epoch-time
   "Create a time object based on seconds since epoch. The first argument is a

test/rethinkdb/core_test.clj

@@ -218,6 +218,9 @@
       (r/minutes (r/time 2014 12 31 10 4 5)) 4
       (r/seconds (r/time 2014 12 31 10 4 5)) 5
       (r/to-iso8601 (r/time 2014 12 31)) "2014-12-31T00:00:00+00:00"
+      (r/to-iso8601 (r/time 2014 12 31 "+02:00")) "2014-12-31T00:00:00+02:00"
+      (r/to-iso8601 (r/time 2014 12 31 14 12 33)) "2014-12-31T14:12:33+00:00"
+      (r/to-iso8601 (r/time 2014 12 31 14 12 33 "-04:00")) "2014-12-31T14:12:33-04:00"
       (r/to-epoch-time (r/time 1970 1 1)) 0)))
 
 (deftest control-structure