This is an automated email from the ASF dual-hosted git repository.
spmallette pushed a commit to branch 3.8-dev
in repository https://gitbox.apache.org/repos/asf/tinkerpop.git
The following commit(s) were added to refs/heads/3.8-dev by this push:
new fb39ed005a Clarify asDate()-step returns OffsetDateTime in Java as of
3.8.0
fb39ed005a is described below
commit fb39ed005aa507a6c0e00450a84339171b8fcb53
Author: Stephen Mallette <[email protected]>
AuthorDate: Tue Jul 21 19:41:19 2026 +0000
Clarify asDate()-step returns OffsetDateTime in Java as of 3.8.0
Add a NOTE to the asDate()-step reference section noting that, starting
in version 3.8.0, this step returns a java.time.OffsetDateTime in Java.
Assisted-by: Kiro:claude-opus-4.8
---
docs/src/reference/the-traversal.asciidoc | 2 ++
1 file changed, 2 insertions(+)
diff --git a/docs/src/reference/the-traversal.asciidoc
b/docs/src/reference/the-traversal.asciidoc
index dfe9ec82a7..21c727d2bd 100644
--- a/docs/src/reference/the-traversal.asciidoc
+++ b/docs/src/reference/the-traversal.asciidoc
@@ -822,6 +822,8 @@
link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gre
The `asDate()`-step (*map*) converts string or numeric input to Date.
+NOTE: Starting in version 3.8.0, in Java this step returns a
`java.time.OffsetDateTime`.
+
For string input only ISO-8601 format is supported. For numbers, the value is
considered as the number of the
milliseconds since "the epoch" (January 1, 1970, 00:00:00 GMT). Date input is
passed without changes.
