This is an automated email from the ASF dual-hosted git repository.
spmallette pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/tinkerpop.git
The following commit(s) were added to refs/heads/master by this push:
new 956e345a43 Clarify asDate() semantics in the Gremlin semantics
specification
956e345a43 is described below
commit 956e345a43cc20cb5dba59acb22bf778e5e65995
Author: Stephen Mallette <[email protected]>
AuthorDate: Fri Sep 11 16:00:17 2026 +0000
Clarify asDate() semantics in the Gremlin semantics specification
State that asDate() yields a DATETIME value rather than a bare date,
document
that numeric input is interpreted as milliseconds since the Unix epoch, and
reconcile the Domain column with the accepted input types and the Exceptions
list (STRING, NUMBER, and DATETIME).
Assisted-by: Kiro:claude-opus-4.8
---
docs/src/dev/provider/gremlin-semantics.asciidoc | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/docs/src/dev/provider/gremlin-semantics.asciidoc
b/docs/src/dev/provider/gremlin-semantics.asciidoc
index ae2231692e..1ff86fd38f 100644
--- a/docs/src/dev/provider/gremlin-semantics.asciidoc
+++ b/docs/src/dev/provider/gremlin-semantics.asciidoc
@@ -894,14 +894,14 @@
link:https://tinkerpop.apache.org/docs/x.y.z/reference/#asBool-step[reference]
[[asDate-step]]
=== asDate()
-*Description:* Parse the value of incoming traverser as date. Supported
ISO-8601 strings and Unix time numbers.
+*Description:* Parse the value of the incoming traverser as a `DATETIME`.
ISO-8601 strings and numeric Unix-time values are supported.
*Syntax:* `asDate()`
[width="100%",options="header"]
|=========================================================
|Start Step |Mid Step |Modulated |Domain |Range
-|N |Y |N |`any` |`any`
+|N |Y |N |`STRING`/`NUMBER`/`DATETIME` |`DATETIME`
|=========================================================
*Arguments:*
@@ -914,7 +914,7 @@ None
*Considerations:*
-Incoming date remains unchanged.
+A `DATETIME` input passes through unchanged. A `STRING` input is parsed as an
ISO-8601 datetime, and a numeric input is interpreted as the count of
milliseconds since the Unix epoch.
*Exceptions:*
