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
commit 5c6961320e60568fd2a46216c8718723ebede41b Merge: 72f609f521 86680bbc4e Author: Stephen Mallette <[email protected]> AuthorDate: Thu Jul 23 13:05:56 2026 -0400 Merge branch '3.8-dev' docs/src/reference/the-traversal.asciidoc | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --cc docs/src/reference/the-traversal.asciidoc index 7524f64d87,7a7b90fd15..94606c60f7 --- a/docs/src/reference/the-traversal.asciidoc +++ b/docs/src/reference/the-traversal.asciidoc @@@ -1685,20 -1518,22 +1685,21 @@@ link:++https://tinkerpop.apache.org/jav [[dateDiff-step]] === DateDiff Step -The dateDiff()-step (*map*) returns the difference between two Dates in epoch time in milliseconds. The result is -computed as the incoming traverser date minus the argument date. A positive result means the incoming date is later than -the argument date, while a negative result means the incoming date is earlier. In the example below, the incoming date -(2023-08-02) is one day earlier than the argument date (2023-08-03), so the result is -86400000 (one day in -milliseconds). If the incoming traverser is not a `Date` or `OffsetDateTime`, then an IllegalArgumentException will be -thrown. +The `dateDiff()`-step (*map*) returns the difference between two Dates in epoch time in milliseconds. The result is +computed as the incoming traverser date minus the argument date. A positive result means the incoming date is later +than the argument date, while a negative result means the incoming date is earlier. In the example below, the incoming +date (`2023-08-02`) is one day earlier than the argument date (`2023-08-03`), so the result is `-86400000` +(one day in milliseconds). - If the incoming traverser is not a Date or OffsetDateTime, then an `IllegalArgumentException` will be thrown. ++ ++If the incoming traverser is not a `Date` or `OffsetDateTime`, then an `IllegalArgumentException` will be thrown. [gremlin-groovy,modern] ---- g.inject("2023-08-02T00:00:00Z").asDate().dateDiff(constant("2023-08-03T00:00:00Z").asDate()) <1> ---- - <1> Find difference between two dates in milliseconds + <1> Find the difference between two dates in milliseconds -NOTE: The `dateDiff(Date)` method is deprecated as of 3.8.0 in favor of `dateDiff(OffsetDateTime)`. - *Additional References* link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#dateDiff(java.util.Date)++[`dateDiff(Date)`],
