From 3050a460aa9e58b159c4600cbc2ef37efe90bb69 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jens=20Pryce-=C3=85klundh?=
 <112686610+JPryce-Aklundh@users.noreply.github.com>
Date: Mon, 24 Mar 2025 09:36:12 +0100
Subject: [PATCH 1/6] initial

---
 modules/ROOT/content-nav.adoc                 |   1 +
 modules/ROOT/pages/expressions/index.adoc     |   1 +
 .../pages/expressions/temporal-operators.adoc | 128 ++++++++++++++++++
 3 files changed, 130 insertions(+)
 create mode 100644 modules/ROOT/pages/expressions/temporal-operators.adoc

diff --git a/modules/ROOT/content-nav.adoc b/modules/ROOT/content-nav.adoc
index 033767527..5bc92b6e8 100644
--- a/modules/ROOT/content-nav.adoc
+++ b/modules/ROOT/content-nav.adoc
@@ -75,6 +75,7 @@
 *** xref:expressions/predicates/type-predicate-expressions.adoc[]
 ** xref:expressions/mathematical-operators.adoc[]
 ** xref:expressions/string-operators.adoc[]
+** xref:expressions/temporal-operators.adoc[]
 ** xref:expressions/conditional-expressions.adoc[]
 
 * xref:functions/index.adoc[]
diff --git a/modules/ROOT/pages/expressions/index.adoc b/modules/ROOT/pages/expressions/index.adoc
index 97415b831..3dbcd364e 100644
--- a/modules/ROOT/pages/expressions/index.adoc
+++ b/modules/ROOT/pages/expressions/index.adoc
@@ -13,5 +13,6 @@ For details and examples of specific expressions, see the following sections:
 ** xref:expressions/predicates/type-predicate-expressions.adoc[]: information about how to verify the value type of a Cypher expression.
 * xref:expressions/mathematical-operators.adoc[]: `+`, `-`, `*`, `/`, `%`, `^`.
 * xref:expressions/string-operators.adoc[]: `+`, `||`
+* xref:expressions/temporal-operators.adoc[]: `+`, `-`, `*`, `/`
 * xref:expressions/conditional-expressions.adoc[]
 
diff --git a/modules/ROOT/pages/expressions/temporal-operators.adoc b/modules/ROOT/pages/expressions/temporal-operators.adoc
new file mode 100644
index 000000000..0eb27ebe5
--- /dev/null
+++ b/modules/ROOT/pages/expressions/temporal-operators.adoc
@@ -0,0 +1,128 @@
+= Temporal operators
+:description: Information about Cypher's temporal operators.
+:table-caption!:
+
+Cypher contains the following temporal operators:
+
+* Adding a xref::values-and-types/temporal.adoc#cypher-temporal-durations[`DURATION`] to either a xref::values-and-types/temporal.adoc#cypher-temporal-instants[temporal instant value] or another `DURATION`: `+`
+* Subtracting a `DURATION` from either a temporal instant value or another `DURATION`: `-`
+* Multiplying a `DURATION` with a number: `*`
+* Dividing a `DURATION` by a number: `/`
+
+For additional expressions that evaluate to a xref:values-and-types/temporal.adoc[temporal value type], see:
+
+* xref:functions/temporal/index.adoc[Temporal functions -- instant types]
+* xref:functions/temporal/duration.adoc[Temporal functions -- duration types]
+
+
+.Value returned from temporal operators
+[options="header"]
+|===
+| Operator | Left-hand operand | Right-hand operand | Result value type
+
+| `+`
+| Temporal instant
+| `DURATION`
+| The type of the temporal instant
+
+| `+`
+| `DURATION`
+| Temporal instant
+| The type of the temporal instant
+
+| `-`
+| Temporal instant
+| `DURATION`
+| The type of the temporal instant
+
+| `+`
+| `DURATION`
+| `DURATION`
+| `DURATION`
+
+| `-`
+| `DURATION`
+| `DURATION`
+| `DURATION`
+
+| `*`
+| `DURATION`
+| xref::values-and-types/property-structural-constructed.adoc#property-types[Number]
+| `DURATION`
+
+| `*`
+| xref::values-and-types/property-structural-constructed.adoc#property-types[Number]
+| `DURATION`
+| `DURATION`
+
+| `/`
+| `DURATION`
+| xref::values-and-types/property-structural-constructed.adoc#property-types[Number]
+| `DURATION`
+
+|===
+
+== Examples
+
+
+.Adding and subtracting a `DURATION` to or from a temporal instant
+[source, cypher]
+----
+WITH localdatetime({year:1984, month:10, day:11, hour:12, minute:31, second:14}) AS aDateTime,
+  duration({years: 12, nanoseconds: 2}) AS aDuration
+RETURN aDateTime + aDuration AS addition, aDateTime - aDuration AS subtraction
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="2*<m"]
+|===
+| addition | subtraction
+
+| 1996-10-11T12:31:14.000000002 | 1972-10-11T12:31:13.999999998
+
+2+d|Rows: 1
+|===
+
+xref::values-and-types/temporal.adoc#cypher-temporal-duration-component[Components of a `DURATION`] that do not apply to the temporal instant are ignored.
+For example, when adding a `DURATION` to a `DATE`, the _hours_, _minutes_, _seconds_ and _nanoseconds_ of the `DURATION` are ignored (`ZONED TIME` and `LOCAL TIME` behaves in an analogous manner):
+
+.Query
+[source, cypher]
+----
+WITH
+  date({year:1984, month:10, day:11}) AS aDate,
+  duration({years: 12, nanoseconds: 2}) AS aDuration
+RETURN aDate + aDuration, aDate - aDuration
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="2*<m"]
+|===
+| +aDate + aDuration+ | +aDate - aDuration+
+| +1996-10-11+ | +1972-10-11+
+2+d|Rows: 1
+|===
+
+Adding two durations to a temporal instant is not an associative operation.
+This is because non-existing dates are truncated to the nearest existing date:
+
+.Query
+[source, cypher]
+----
+RETURN
+  (date("2011-01-31") + duration("P1M")) + duration("P12M") AS date1,
+  date("2011-01-31") + (duration("P1M") + duration("P12M")) AS date2
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="2*<m"]
+|===
+| +date1+ | +date2+
+| +2012-02-28+ | +2012-02-29+
+
+2+d|Rows: 1
+|===
+
+
+Adding/substracting a duration: x+d, x-d
+Multiply/divide a duration: d*x, d/x

From fccae589bb157aaf7c731ea0c0d5e5a9ad9b61d1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jens=20Pryce-=C3=85klundh?=
 <112686610+JPryce-Aklundh@users.noreply.github.com>
Date: Mon, 24 Mar 2025 13:00:59 +0100
Subject: [PATCH 2/6] second

---
 .../pages/expressions/temporal-operators.adoc | 40 ++++++++++++++-----
 1 file changed, 31 insertions(+), 9 deletions(-)

diff --git a/modules/ROOT/pages/expressions/temporal-operators.adoc b/modules/ROOT/pages/expressions/temporal-operators.adoc
index 0eb27ebe5..c0ba497e7 100644
--- a/modules/ROOT/pages/expressions/temporal-operators.adoc
+++ b/modules/ROOT/pages/expressions/temporal-operators.adoc
@@ -2,6 +2,7 @@
 :description: Information about Cypher's temporal operators.
 :table-caption!:
 
+
 Cypher contains the following temporal operators:
 
 * Adding a xref::values-and-types/temporal.adoc#cypher-temporal-durations[`DURATION`] to either a xref::values-and-types/temporal.adoc#cypher-temporal-instants[temporal instant value] or another `DURATION`: `+`
@@ -14,7 +15,6 @@ For additional expressions that evaluate to a xref:values-and-types/temporal.ado
 * xref:functions/temporal/index.adoc[Temporal functions -- instant types]
 * xref:functions/temporal/duration.adoc[Temporal functions -- duration types]
 
-
 .Value returned from temporal operators
 [options="header"]
 |===
@@ -62,14 +62,12 @@ For additional expressions that evaluate to a xref:values-and-types/temporal.ado
 
 |===
 
-== Examples
-
+== Adding and subtracting a `DURATION` to or from a temporal instant
 
-.Adding and subtracting a `DURATION` to or from a temporal instant
 [source, cypher]
 ----
 WITH localdatetime({year:1984, month:10, day:11, hour:12, minute:31, second:14}) AS aDateTime,
-  duration({years: 12, nanoseconds: 2}) AS aDuration
+ duration({years: 12, nanoseconds: 2}) AS aDuration
 RETURN aDateTime + aDuration AS addition, aDateTime - aDuration AS subtraction
 ----
 
@@ -83,18 +81,33 @@ RETURN aDateTime + aDuration AS addition, aDateTime - aDuration AS subtraction
 2+d|Rows: 1
 |===
 
+=== Ignored components of `DURATION` values
+
+When adding a `DURATION` to a temporal instant value, any xref::values-and-types/temporal.adoc#cypher-temporal-duration-component[components] that do not apply to that specific type are ignored.
+For example, when adding a `DURATION` to a `DATE`, only the `years`, `months`, and `days` components of a `DURATION` value are considered, while `hours`, `minutes`, `seconds`, and `nanoseconds` are ignored.
+
+This behavior also applies to `LOCAL TIME` and `ZONED TIME`: since they only represent time (without a date), any years, months, or days in the DURATION are ignored.
+
+
+
+
+
+
+
 xref::values-and-types/temporal.adoc#cypher-temporal-duration-component[Components of a `DURATION`] that do not apply to the temporal instant are ignored.
 For example, when adding a `DURATION` to a `DATE`, the _hours_, _minutes_, _seconds_ and _nanoseconds_ of the `DURATION` are ignored (`ZONED TIME` and `LOCAL TIME` behaves in an analogous manner):
 
+
 .Query
 [source, cypher]
 ----
 WITH
-  date({year:1984, month:10, day:11}) AS aDate,
-  duration({years: 12, nanoseconds: 2}) AS aDuration
+ date({year:1984, month:10, day:11}) AS aDate,
+ duration({years: 12, nanoseconds: 2}) AS aDuration
 RETURN aDate + aDuration, aDate - aDuration
 ----
 
+
 .Result
 [role="queryresult",options="header,footer",cols="2*<m"]
 |===
@@ -103,26 +116,35 @@ RETURN aDate + aDuration, aDate - aDuration
 2+d|Rows: 1
 |===
 
+
 Adding two durations to a temporal instant is not an associative operation.
 This is because non-existing dates are truncated to the nearest existing date:
 
+
 .Query
 [source, cypher]
 ----
 RETURN
-  (date("2011-01-31") + duration("P1M")) + duration("P12M") AS date1,
-  date("2011-01-31") + (duration("P1M") + duration("P12M")) AS date2
+ (date("2011-01-31") + duration("P1M")) + duration("P12M") AS date1,
+ date("2011-01-31") + (duration("P1M") + duration("P12M")) AS date2
 ----
 
+
 .Result
 [role="queryresult",options="header,footer",cols="2*<m"]
 |===
 | +date1+ | +date2+
 | +2012-02-28+ | +2012-02-29+
 
+
 2+d|Rows: 1
 |===
 
 
+
+
 Adding/substracting a duration: x+d, x-d
 Multiply/divide a duration: d*x, d/x
+
+
+

From 53ba289f1fdb6921d89a2c3b2865d97cd91ed2a5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jens=20Pryce-=C3=85klundh?=
 <112686610+JPryce-Aklundh@users.noreply.github.com>
Date: Mon, 24 Mar 2025 15:24:35 +0100
Subject: [PATCH 3/6] third

---
 .../pages/expressions/temporal-operators.adoc |  99 +++++++----
 .../pages/functions/temporal/duration.adoc    |   2 +-
 .../ROOT/pages/functions/temporal/index.adoc  |   2 +-
 modules/ROOT/pages/syntax/operators.adoc      | 166 ------------------
 .../ROOT/pages/values-and-types/temporal.adoc |   4 +-
 5 files changed, 69 insertions(+), 204 deletions(-)

diff --git a/modules/ROOT/pages/expressions/temporal-operators.adoc b/modules/ROOT/pages/expressions/temporal-operators.adoc
index c0ba497e7..2c5fcf72d 100644
--- a/modules/ROOT/pages/expressions/temporal-operators.adoc
+++ b/modules/ROOT/pages/expressions/temporal-operators.adoc
@@ -2,7 +2,6 @@
 :description: Information about Cypher's temporal operators.
 :table-caption!:
 
-
 Cypher contains the following temporal operators:
 
 * Adding a xref::values-and-types/temporal.adoc#cypher-temporal-durations[`DURATION`] to either a xref::values-and-types/temporal.adoc#cypher-temporal-instants[temporal instant value] or another `DURATION`: `+`
@@ -62,13 +61,19 @@ For additional expressions that evaluate to a xref:values-and-types/temporal.ado
 
 |===
 
-== Adding and subtracting a `DURATION` to or from a temporal instant
+[[adding-subtracting-durations]]
+== Adding and subtracting `DURATION` values
+
+`DURATION` values can be added and subtracted from temporal instant values, such as `LOCAL DATETIME`.
+In the below example, the xref:functions/temporal/index.adoc#functions-localdatetime[`localdatetime()`] function is used to create a `LOCAL DATETIME` value, and the xref:functions/temporal/duration.adoc#functions-durations[`duration()`] function is used to create a `DURATION` value.
 
+.Add and subtract a `DURATION` value
 [source, cypher]
 ----
 WITH localdatetime({year:1984, month:10, day:11, hour:12, minute:31, second:14}) AS aDateTime,
- duration({years: 12, nanoseconds: 2}) AS aDuration
-RETURN aDateTime + aDuration AS addition, aDateTime - aDuration AS subtraction
+     duration({years: 12, nanoseconds: 2}) AS aDuration
+RETURN aDateTime + aDuration AS addition,
+      aDateTime - aDuration AS subtraction
 ----
 
 .Result
@@ -81,70 +86,96 @@ RETURN aDateTime + aDuration AS addition, aDateTime - aDuration AS subtraction
 2+d|Rows: 1
 |===
 
-=== Ignored components of `DURATION` values
-
-When adding a `DURATION` to a temporal instant value, any xref::values-and-types/temporal.adoc#cypher-temporal-duration-component[components] that do not apply to that specific type are ignored.
-For example, when adding a `DURATION` to a `DATE`, only the `years`, `months`, and `days` components of a `DURATION` value are considered, while `hours`, `minutes`, `seconds`, and `nanoseconds` are ignored.
-
-This behavior also applies to `LOCAL TIME` and `ZONED TIME`: since they only represent time (without a date), any years, months, or days in the DURATION are ignored.
-
-
-
+When adding or subtracting a `DURATION` that results in a non-existing date, Cypher truncates the date to the nearest valid date.
+For example, if adding 1 month to January 31st, the result will not be February 31st (an invalid date) but February 28th (or 29th in a leap year).
 
+.Add 1 month to January 31st
+[source, cypher]
+----
+RETURN date("2011-01-31") + duration("P1M") AS truncatedDate
+----
 
+.Result
+[role="queryresult",options="header,footer",cols="1*<m"]
+|===
+| truncatedDate
 
+| 2011-02-28
 
-xref::values-and-types/temporal.adoc#cypher-temporal-duration-component[Components of a `DURATION`] that do not apply to the temporal instant are ignored.
-For example, when adding a `DURATION` to a `DATE`, the _hours_, _minutes_, _seconds_ and _nanoseconds_ of the `DURATION` are ignored (`ZONED TIME` and `LOCAL TIME` behaves in an analogous manner):
+1+d|Rows: 1
+|===
 
+When adding two `DURATION` values to a temporal instant value, the order in which the durations are applied affects the result.
 
 .Query
 [source, cypher]
 ----
-WITH
- date({year:1984, month:10, day:11}) AS aDate,
- duration({years: 12, nanoseconds: 2}) AS aDuration
-RETURN aDate + aDuration, aDate - aDuration
+RETURN (date("2011-01-31") + duration("P1M")) + duration("P12M") AS date1,
+       date("2011-01-31") + (duration("P1M") + duration("P12M")) AS date2
 ----
 
+In `date1`, durations are added one after the other, so the date is truncated after adding the first month, resulting in `2012-02-28`.
+In `date2`, the durations are combined first, and truncation only happens once, resulting in `2012-02-29`. 
 
 .Result
 [role="queryresult",options="header,footer",cols="2*<m"]
 |===
-| +aDate + aDuration+ | +aDate - aDuration+
-| +1996-10-11+ | +1972-10-11+
+| date1 | date2
+
+| 2012-02-28 | 2012-02-29
+
 2+d|Rows: 1
 |===
 
+[[ignored-components]]
+=== Ignored components
 
-Adding two durations to a temporal instant is not an associative operation.
-This is because non-existing dates are truncated to the nearest existing date:
+When adding or subtracting a `DURATION` value to a temporal instant value, any xref::values-and-types/temporal.adoc#cypher-temporal-duration-component[`DURATION` components] that do not apply to that specific type are ignored.
+(For information about what components are supported by temporal instant values, see xref::values-and-types/temporal.adoc#cypher-temporal-accessing-components-temporal-instants[Components of temporal instants]).
+For example, when adding a `DURATION` to a `DATE`, only the `year`, `month`, and `day` components of a `DURATION` value are considered, while `hour`, `minute`, `second`, and `nanosecond` are ignored.
+This behavior also applies to `LOCAL TIME` and `ZONED TIME`.
 
-
-.Query
+.Adding and subtracting a `DURATION` to/from a `DATE`
 [source, cypher]
 ----
-RETURN
- (date("2011-01-31") + duration("P1M")) + duration("P12M") AS date1,
- date("2011-01-31") + (duration("P1M") + duration("P12M")) AS date2
+WITH date({year:1984, month:10, day:11}) AS aDate,
+     duration({years: 12, nanoseconds: 2}) AS aDuration
+RETURN aDate + aDuration AS addition,
+       aDate - aDuration AS subtraction
 ----
 
-
 .Result
 [role="queryresult",options="header,footer",cols="2*<m"]
 |===
-| +date1+ | +date2+
-| +2012-02-28+ | +2012-02-29+
+| addition | subtraction
 
+| 1996-10-11 | 1972-10-11
 
 2+d|Rows: 1
 |===
 
+== Multiplying and dividing `DURATION` values
 
+When multiplying or dividing a `DURATION`, each component is handled separately.
+In multiplication, the value of each component is multiplied by the given factor, while in division, each component is divided by the given number.
+If the result of the division does not fit into the original components, it overflows into smaller components (e.g. converting days into hours).
+This overflow also occurs when multiplying with fractions.
 
+.Multiplying and dividing a `DURATION` value
+[source, cypher]
+----
+WITH duration({days: 14, minutes: 12, seconds: 70, nanoseconds: 1}) AS aDuration
+RETURN aDuration,
+       aDuration * 2 AS multipliedDuration,
+       aDuration / 3 AS dividedDuration
+----
 
-Adding/substracting a duration: x+d, x-d
-Multiply/divide a duration: d*x, d/x
-
+.Result
+[role="queryresult",options="header,footer",cols="3*<m"]
+|===
+| aDuration | multipliedDuration | dividedDuration
+| P14DT13M10.000000001S | P28DT26M20.000000002S | P4DT16H4M23.333333333S
 
+3+d|Rows: 1
+|===
 
diff --git a/modules/ROOT/pages/functions/temporal/duration.adoc b/modules/ROOT/pages/functions/temporal/duration.adoc
index 74503b98f..0612c789e 100644
--- a/modules/ROOT/pages/functions/temporal/duration.adoc
+++ b/modules/ROOT/pages/functions/temporal/duration.adoc
@@ -8,7 +8,7 @@ Duration functions allow for the creation and manipulation of temporal `DURATION
 
 [NOTE]
 ====
-See also xref::values-and-types/temporal.adoc[Temporal values] and xref::syntax/operators.adoc#query-operators-temporal[Temporal operators].
+See also xref::values-and-types/temporal.adoc[Temporal values] and xref::expressions/temporal-operators.adoc[Temporal operators].
 ====
 
 [[functions-durations]]
diff --git a/modules/ROOT/pages/functions/temporal/index.adoc b/modules/ROOT/pages/functions/temporal/index.adoc
index 3354a69a4..3da0ab037 100644
--- a/modules/ROOT/pages/functions/temporal/index.adoc
+++ b/modules/ROOT/pages/functions/temporal/index.adoc
@@ -54,7 +54,7 @@ The following functions are included on this page:
 
 [NOTE]
 ====
-See also xref::values-and-types/temporal.adoc[Temporal (Date/Time) values] and xref::syntax/operators.adoc#query-operators-temporal[Temporal operators].
+See also xref::values-and-types/temporal.adoc[Temporal (Date/Time) values] and xref::expressions/temporal-operators.adoc[Temporal operators].
 ====
 
 
diff --git a/modules/ROOT/pages/syntax/operators.adoc b/modules/ROOT/pages/syntax/operators.adoc
index 5581e7f7e..0766800d8 100644
--- a/modules/ROOT/pages/syntax/operators.adoc
+++ b/modules/ROOT/pages/syntax/operators.adoc
@@ -7,12 +7,10 @@ This page contains an overview of the available Cypher operators.
 [[query-operators-summary]]
 == Operators at a glance
 
-
 [subs=none]
 |===
 | xref::syntax/operators.adoc#query-operators-aggregation[Aggregation operators] | `DISTINCT`
 | xref::syntax/operators.adoc#query-operators-property[Property operators] | `.` for static property access, `[]` for dynamic property access, `=` for replacing all properties, `+=` for mutating specific properties
-| xref::syntax/operators.adoc#query-operators-temporal[Temporal operators]   | `+` and `-` for operations between durations and temporal instants/durations, `*` and `/` for operations between durations and numbers
 | xref::syntax/operators.adoc#query-operators-map[Map operators]       |  `.` for static value access by key, `[]` for dynamic value access by key
 | xref::syntax/operators.adoc#query-operators-list[List operators]       | `+` and `\|\|` (list concatenation), `IN` to check existence of an element in a list, `[]` for accessing element(s) dynamically
 |===
@@ -187,170 +185,6 @@ The properties on the node are updated as follows by those provided in the map:
 
 See xref::clauses/set.adoc#set-setting-properties-using-map[Mutate specific properties using a map and `+=`] for more details on using the property mutation operator `+=`.
 
-[[query-operators-temporal]]
-== Temporal operators
-
-Temporal operators comprise:
-
-* adding a xref::values-and-types/temporal.adoc#cypher-temporal-durations[`DURATION`] to either a xref::values-and-types/temporal.adoc#cypher-temporal-instants[temporal instant] or another `DURATION`: `+`
-* subtracting a `DURATION` from either a temporal instant or another `DURATION`: `-`
-* multiplying a `DURATION` with a number: `*`
-* dividing a `DURATION` by a number: `/`
-
-The following table shows -- for each combination of operation and operand type -- the type of the value returned from the application of each temporal operator:
-
-[options="header"]
-|===
-| Operator | Left-hand operand | Right-hand operand | Type of result
-
-| xref::syntax/operators.adoc#syntax-add-subtract-duration-to-temporal-instant[`+`]
-| Temporal instant
-| `DURATION`
-| The type of the temporal instant
-
-| xref::syntax/operators.adoc#syntax-add-subtract-duration-to-temporal-instant[`+`]
-| `DURATION`
-| Temporal instant
-| The type of the temporal instant
-
-| xref::syntax/operators.adoc#syntax-add-subtract-duration-to-temporal-instant[`-`]
-| Temporal instant
-| `DURATION`
-| The type of the temporal instant
-
-| xref::syntax/operators.adoc#syntax-add-subtract-duration-to-duration[`+`]
-| `DURATION`
-| `DURATION`
-| `DURATION`
-
-| xref::syntax/operators.adoc#syntax-add-subtract-duration-to-duration[`-`]
-| `DURATION`
-| `DURATION`
-| `DURATION`
-
-| xref::syntax/operators.adoc#syntax-multiply-divide-duration-number[`*`]
-| `DURATION`
-| xref::values-and-types/property-structural-constructed.adoc#property-types[Number]
-| `DURATION`
-
-| xref::syntax/operators.adoc#syntax-multiply-divide-duration-number[`*`]
-| xref::values-and-types/property-structural-constructed.adoc#property-types[Number]
-| `DURATION`
-| `DURATION`
-
-| xref::syntax/operators.adoc#syntax-multiply-divide-duration-number[`/`]
-| `DURATION`
-| xref::values-and-types/property-structural-constructed.adoc#property-types[Number]
-| `DURATION`
-
-|===
-
-
-[[syntax-add-subtract-duration-to-temporal-instant]]
-=== Adding and subtracting a `DURATION` to or from a temporal instant
-
-.Query
-[source, cypher]
-----
-WITH
-  localdatetime({year:1984, month:10, day:11, hour:12, minute:31, second:14}) AS aDateTime,
-  duration({years: 12, nanoseconds: 2}) AS aDuration
-RETURN aDateTime + aDuration, aDateTime - aDuration
-----
-
-.Result
-[role="queryresult",options="header,footer",cols="2*<m"]
-|===
-| +aDateTime + aDuration+ | +aDateTime - aDuration+
-| +1996-10-11T12:31:14.000000002+ | +1972-10-11T12:31:13.999999998+
-
-2+d|Rows: 1
-|===
-
-xref::values-and-types/temporal.adoc#cypher-temporal-duration-component[Components of a `DURATION`] that do not apply to the temporal instant are ignored.
-For example, when adding a `DURATION` to a `DATE`, the _hours_, _minutes_, _seconds_ and _nanoseconds_ of the `DURATION` are ignored (`ZONED TIME` and `LOCAL TIME` behaves in an analogous manner):
-
-.Query
-[source, cypher]
-----
-WITH
-  date({year:1984, month:10, day:11}) AS aDate,
-  duration({years: 12, nanoseconds: 2}) AS aDuration
-RETURN aDate + aDuration, aDate - aDuration
-----
-
-.Result
-[role="queryresult",options="header,footer",cols="2*<m"]
-|===
-| +aDate + aDuration+ | +aDate - aDuration+
-| +1996-10-11+ | +1972-10-11+
-2+d|Rows: 1
-|===
-
-Adding two durations to a temporal instant is not an associative operation.
-This is because non-existing dates are truncated to the nearest existing date:
-
-.Query
-[source, cypher]
-----
-RETURN
-  (date("2011-01-31") + duration("P1M")) + duration("P12M") AS date1,
-  date("2011-01-31") + (duration("P1M") + duration("P12M")) AS date2
-----
-
-.Result
-[role="queryresult",options="header,footer",cols="2*<m"]
-|===
-| +date1+ | +date2+
-| +2012-02-28+ | +2012-02-29+
-
-2+d|Rows: 1
-|===
-
-
-[[syntax-add-subtract-duration-to-duration]]
-=== Adding and subtracting a `DURATION` to or from another `DURATION`
-
-.Query
-[source, cypher]
-----
-WITH
-  duration({years: 12, months: 5, days: 14, hours: 16, minutes: 12, seconds: 70, nanoseconds: 1}) as duration1,
-  duration({months:1, days: -14, hours: 16, minutes: -12, seconds: 70}) AS duration2
-RETURN duration1, duration2, duration1 + duration2, duration1 - duration2
-----
-
-.Result
-[role="queryresult",options="header,footer",cols="4*<m"]
-|===
-| +duration1+ | +duration2+ | +duration1 + duration2+ | +duration1 - duration2+
-| +P12Y5M14DT16H13M10.000000001S+ | +P1M-14DT15H49M10S+ | +P12Y6MT32H2M20.000000001S+ | +P12Y4M28DT24M0.000000001S+
-
-4+d|Rows: 1
-|===
-
-
-[[syntax-multiply-divide-duration-number]]
-=== Multiplying and dividing a `DURATION` with or by a number
-
-These operations are interpreted simply as component-wise operations with overflow to smaller units based on an average length of units in the case of division (and multiplication with fractions).
-
-.Query
-[source, cypher]
-----
-WITH duration({days: 14, minutes: 12, seconds: 70, nanoseconds: 1}) AS aDuration
-RETURN aDuration, aDuration * 2, aDuration / 3
-----
-
-.Result
-[role="queryresult",options="header,footer",cols="3*<m"]
-|===
-| +aDuration+ | +aDuration * 2+ | +aDuration / 3+
-| +P14DT13M10.000000001S+ | +P28DT26M20.000000002S+ | +P4DT16H4M23.333333333S+
-
-3+d|Rows: 1
-|===
-
 
 [[query-operators-map]]
 == Map operators
diff --git a/modules/ROOT/pages/values-and-types/temporal.adoc b/modules/ROOT/pages/values-and-types/temporal.adoc
index 24c9a30e7..8d92d1fbd 100644
--- a/modules/ROOT/pages/values-and-types/temporal.adoc
+++ b/modules/ROOT/pages/values-and-types/temporal.adoc
@@ -10,8 +10,8 @@ This section will discuss how Cypher handles time zones, before exploring tempor
 [NOTE]
 ====
 * Refer to xref::functions/temporal/index.adoc[Temporal functions - instant types] for information regarding temporal _functions_ allowing for the creation and manipulation of temporal values.
-* Refer to xref::syntax/operators.adoc#query-operators-temporal[Temporal operators] for information regarding temporal _operators_.
-* Refer to xref::syntax/operators.adoc#cypher-ordering[Ordering and comparison of values] for information regarding the comparison and ordering of temporal values.
+* Refer to xref::expressions/temporal-operators.adoc[Temporal operators] for information regarding temporal _operators_.
+* Refer to xref::values-and-types/ordering-equality-comparison.adoc[Equality, ordering, and comparison of value types] for information regarding the comparison and ordering of temporal values.
 ====
 
 == Temporal value types

From 37b8209c519bc95055728be16c3726afefbbcbde Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jens=20Pryce-=C3=85klundh?=
 <112686610+JPryce-Aklundh@users.noreply.github.com>
Date: Mon, 24 Mar 2025 15:47:29 +0100
Subject: [PATCH 4/6] fourth

---
 .../deprecations-additions-removals-compatibility.adoc    | 2 +-
 modules/ROOT/pages/expressions/temporal-operators.adoc    | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc
index b7df09fdb..9210f2858 100644
--- a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc
+++ b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc
@@ -5732,7 +5732,7 @@ Replaced by xref:values-and-types/lists.adoc#cypher-list-comprehension[list comp
 | xref:functions/scalar.adoc#functions-randomuuid[randomUUID()] | Function | Added |
 | xref:values-and-types/temporal.adoc[Temporal types]  | Functionality | Added | Supports storing, indexing and working with the following temporal types: Date, Time, LocalTime, DateTime, LocalDateTime and Duration.
 | xref:functions/temporal/index.adoc[Temporal functions]  | Functionality | Added | Functions allowing for the creation and manipulation of values for each temporal type -- _Date_, _Time_, _LocalTime_, _DateTime_, _LocalDateTime_ and _Duration_.
-| xref:syntax/operators.adoc#query-operators-temporal[Temporal operators]  | Functionality | Added | Operators allowing for the manipulation of values for each temporal type -- _Date_, _Time_, _LocalTime_, _DateTime_, _LocalDateTime_ and _Duration_.
+| xref:expressions/temporal-operators.adoc[Temporal operators]  | Functionality | Added | Operators allowing for the manipulation of values for each temporal type -- _Date_, _Time_, _LocalTime_, _DateTime_, _LocalDateTime_ and _Duration_.
 |  xref:functions/string.adoc#functions-tostring[toString()]   | Function  | Extended | Now also allows temporal values as input (i.e. values of type _Date_, _Time_, _LocalTime_, _DateTime_, _LocalDateTime_ or _Duration_).
 |===
 
diff --git a/modules/ROOT/pages/expressions/temporal-operators.adoc b/modules/ROOT/pages/expressions/temporal-operators.adoc
index 2c5fcf72d..c8188fa47 100644
--- a/modules/ROOT/pages/expressions/temporal-operators.adoc
+++ b/modules/ROOT/pages/expressions/temporal-operators.adoc
@@ -6,7 +6,7 @@ Cypher contains the following temporal operators:
 
 * Adding a xref::values-and-types/temporal.adoc#cypher-temporal-durations[`DURATION`] to either a xref::values-and-types/temporal.adoc#cypher-temporal-instants[temporal instant value] or another `DURATION`: `+`
 * Subtracting a `DURATION` from either a temporal instant value or another `DURATION`: `-`
-* Multiplying a `DURATION` with a number: `*`
+* Multiplying a `DURATION` with a xref::values-and-types/property-structural-constructed.adoc#property-types[number (`INTEGER` or `FLOAT`)]: `*`
 * Dividing a `DURATION` by a number: `/`
 
 For additional expressions that evaluate to a xref:values-and-types/temporal.adoc[temporal value type], see:
@@ -46,17 +46,17 @@ For additional expressions that evaluate to a xref:values-and-types/temporal.ado
 
 | `*`
 | `DURATION`
-| xref::values-and-types/property-structural-constructed.adoc#property-types[Number]
+| Number
 | `DURATION`
 
 | `*`
-| xref::values-and-types/property-structural-constructed.adoc#property-types[Number]
+| Number
 | `DURATION`
 | `DURATION`
 
 | `/`
 | `DURATION`
-| xref::values-and-types/property-structural-constructed.adoc#property-types[Number]
+| Number
 | `DURATION`
 
 |===

From ed83eb4e5a46174e35b99ee5485c931dafb0644e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jens=20Pryce-=C3=85klundh?=
 <112686610+JPryce-Aklundh@users.noreply.github.com>
Date: Tue, 25 Mar 2025 15:01:27 +0100
Subject: [PATCH 5/6] small fix

---
 modules/ROOT/pages/expressions/temporal-operators.adoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/modules/ROOT/pages/expressions/temporal-operators.adoc b/modules/ROOT/pages/expressions/temporal-operators.adoc
index c8188fa47..6018e87c7 100644
--- a/modules/ROOT/pages/expressions/temporal-operators.adoc
+++ b/modules/ROOT/pages/expressions/temporal-operators.adoc
@@ -107,7 +107,7 @@ RETURN date("2011-01-31") + duration("P1M") AS truncatedDate
 
 When adding two `DURATION` values to a temporal instant value, the order in which the durations are applied affects the result.
 
-.Query
+.Add two `DURATION` values to a `DATE`
 [source, cypher]
 ----
 RETURN (date("2011-01-31") + duration("P1M")) + duration("P12M") AS date1,

From da5e1a3680e58c2f8ea151cd470031c752d6b7f8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jens=20Pryce-=C3=85klundh?=
 <112686610+JPryce-Aklundh@users.noreply.github.com>
Date: Tue, 25 Mar 2025 15:07:15 +0100
Subject: [PATCH 6/6] standardise

---
 modules/ROOT/pages/expressions/temporal-operators.adoc | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/modules/ROOT/pages/expressions/temporal-operators.adoc b/modules/ROOT/pages/expressions/temporal-operators.adoc
index 6018e87c7..dd1b09e29 100644
--- a/modules/ROOT/pages/expressions/temporal-operators.adoc
+++ b/modules/ROOT/pages/expressions/temporal-operators.adoc
@@ -67,7 +67,7 @@ For additional expressions that evaluate to a xref:values-and-types/temporal.ado
 `DURATION` values can be added and subtracted from temporal instant values, such as `LOCAL DATETIME`.
 In the below example, the xref:functions/temporal/index.adoc#functions-localdatetime[`localdatetime()`] function is used to create a `LOCAL DATETIME` value, and the xref:functions/temporal/duration.adoc#functions-durations[`duration()`] function is used to create a `DURATION` value.
 
-.Add and subtract a `DURATION` value
+.Add and subtract a `DURATION` value to/from a `LOCAL DATETIME`
 [source, cypher]
 ----
 WITH localdatetime({year:1984, month:10, day:11, hour:12, minute:31, second:14}) AS aDateTime,
@@ -135,7 +135,7 @@ When adding or subtracting a `DURATION` value to a temporal instant value, any x
 For example, when adding a `DURATION` to a `DATE`, only the `year`, `month`, and `day` components of a `DURATION` value are considered, while `hour`, `minute`, `second`, and `nanosecond` are ignored.
 This behavior also applies to `LOCAL TIME` and `ZONED TIME`.
 
-.Adding and subtracting a `DURATION` to/from a `DATE`
+.Add and subtract a `DURATION` to/from a `DATE`
 [source, cypher]
 ----
 WITH date({year:1984, month:10, day:11}) AS aDate,
@@ -161,7 +161,7 @@ In multiplication, the value of each component is multiplied by the given factor
 If the result of the division does not fit into the original components, it overflows into smaller components (e.g. converting days into hours).
 This overflow also occurs when multiplying with fractions.
 
-.Multiplying and dividing a `DURATION` value
+.Multiply and divide a `DURATION` value
 [source, cypher]
 ----
 WITH duration({days: 14, minutes: 12, seconds: 70, nanoseconds: 1}) AS aDuration