From 9b26a57152d9973cfab75c4f4c73d5a1acc006cd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jens=20Pryce-=C3=85klundh?=
 <112686610+JPryce-Aklundh@users.noreply.github.com>
Date: Tue, 22 Apr 2025 15:03:57 +0200
Subject: [PATCH 1/2] Add epocmillis cheat sheet tags (#1227)

---
 .../ROOT/pages/functions/temporal/index.adoc  | 69 ++++++++++++-------
 1 file changed, 45 insertions(+), 24 deletions(-)

diff --git a/modules/ROOT/pages/functions/temporal/index.adoc b/modules/ROOT/pages/functions/temporal/index.adoc
index 3354a69a4..c3988b289 100644
--- a/modules/ROOT/pages/functions/temporal/index.adoc
+++ b/modules/ROOT/pages/functions/temporal/index.adoc
@@ -482,7 +482,6 @@ RETURN theDate
 ======
 
 .Query
-// tag::functions_temporal_date_transaction[]
 [source, cypher]
 ----
 UNWIND [
@@ -492,7 +491,6 @@ date({year: 1984})
 ] AS theDate
 RETURN theDate
 ----
-// end::functions_temporal_date_transaction[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -569,7 +567,6 @@ The date corresponding to `11 February 1984` is returned.
 ======
 
 .Query
-// tag::functions_temporal_date_statement[]
 [source, cypher]
 ----
 UNWIND [
@@ -579,7 +576,6 @@ datetime({year: 1984, month: 11, day: 11, hour: 12, timezone: '+01:00'})
 ] AS dd
 RETURN date({date: dd}) AS dateOnly, date({date: dd, day: 28}) AS dateDay
 ----
-// end::functions_temporal_date_statement[]
 
 .Result
 [role="queryresult",options="header,footer",cols="2*<m"]
@@ -709,10 +705,12 @@ However, a different value may be produced for different statements within the s
 ======
 
 .Query
+// tag::functions_temporal_date_statement[]
 [source, cypher]
 ----
 RETURN date.statement() AS currentDate
 ----
+// tag::functions_temporal_date_statement[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -745,10 +743,13 @@ However, a different value may be produced for different transactions.
 ======
 
 .Query
+// tag::functions_temporal_date_transaction[]
 [source, cypher]
 ----
 RETURN date.transaction() AS currentDate
 ----
+// end::functions_temporal_date_transaction[]
+
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -800,6 +801,7 @@ For example, `day` -- with some value `x` -- may be provided when the truncation
 ======
 
 .Query
+// tag::functions_temporal_date_truncate[]
 [source, cypher]
 ----
 WITH
@@ -819,6 +821,8 @@ RETURN
   date.truncate('week', d, {dayOfWeek: 2}) AS truncWeek,
   date.truncate('day', d) AS truncDay
 ----
+// tag::functions_temporal_date_truncate[]
+
 
 .Result
 [role="queryresult",options="header,footer",cols="9*<m"]
@@ -917,10 +921,12 @@ RETURN
 ======
 
 .Query
+// tag::functions_temporal_datetime[]
 [source, cypher]
 ----
 RETURN datetime() AS currentDateTime
 ----
+// end::functions_temporal_datetime[]
 
 The current date and time using the local timezone is returned.
 
@@ -1232,7 +1238,6 @@ RETURN
 The following query shows the various usages of `+datetime({datetime [, year, ..., timezone]})+`.
 
 .Query
-// tag::functions_temporal_datetime[]
 [source, cypher]
 ----
 WITH
@@ -1247,7 +1252,6 @@ RETURN
   datetime({datetime: dd, day: 28, second: 42}) AS dateTimeDDSS,
   datetime({datetime: dd, day: 28, second: 42, timezone: 'Pacific/Honolulu'}) AS dateTimeDDSSTimezone
 ----
-// end::functions_temporal_datetime[]
 
 .Result
 [role="queryresult",options="header,footer",cols="4*<m"]
@@ -1326,11 +1330,13 @@ RETURN datetime({epochMillis: 424797300000}) AS theDate
 ======
 
 .Query
+// tag::functions_temporal_datetime_fromepoch
 [source, cypher]
 ----
-WITH datetime.fromepoch(1683000000, 123456789) AS dateTimeFromEpoch
+WITH datetime.fromEpoch(1683000000, 123456789) AS dateTimeFromEpoch
 RETURN dateTimeFromEpoch
 ----
+// end::functions_temporal_datetime_fromepoch
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -1359,11 +1365,13 @@ RETURN dateTimeFromEpoch
 ======
 
 .Query
+// tag::functions_temporal_datetime_fromepochmillis
 [source, cypher]
 ----
-WITH datetime.fromepochmillis(1724198400000) AS dateTimeFromMillis
+WITH datetime.fromEpochMillis(1724198400000) AS dateTimeFromMillis
 RETURN dateTimeFromMillis
 ----
+// end::functions_temporal_datetime_fromepochmillis
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -1554,6 +1562,7 @@ For example, `day` -- with some value `x` -- may be provided when the truncation
 ======
 
 .Query
+// tag::functions_temporal_datetime_truncate[]
 [source, cypher]
 ----
 WITH
@@ -1570,6 +1579,7 @@ RETURN
   datetime.truncate('hour', d) AS truncHour,
   datetime.truncate('second', d) AS truncSecond
 ----
+// end::functions_temporal_datetime_truncate[]
 
 .Result
 [role="queryresult",options="header,footer",cols="6*<m"]
@@ -1659,12 +1669,10 @@ RETURN
 ======
 
 .Query
-// tag::functions_temporal_localtime[]
 [source, cypher]
 ----
 RETURN localdatetime() AS now
 ----
-// end::functions_temporal_localtime[]
 
 The current local date and time (i.e. in the local timezone) is returned.
 
@@ -1711,7 +1719,6 @@ The current local date and time in California is returned.
 ======
 
 .Query
-// tag::functions_temporal_localtime_transaction[]
 [source, cypher]
 ----
 RETURN
@@ -1720,7 +1727,6 @@ RETURN
     hour: 12, minute: 31, second: 14, millisecond: 123, microsecond: 456, nanosecond: 789
   }) AS theDate
 ----
-// end::functions_temporal_localtime_transaction[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -1764,7 +1770,6 @@ RETURN
 ======
 
 .Query
-// tag::functions_temporal_localtime_statement[]
 [source, cypher]
 ----
 RETURN
@@ -1773,7 +1778,6 @@ RETURN
     hour: 12, minute: 31, second: 14, nanosecond: 645876123
   }) AS theDate
 ----
-// end::functions_temporal_localtime_statement[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -1792,6 +1796,7 @@ RETURN
 ======
 
 .Query
+// tag::functions_temporal_localdatetime[]
 [source, cypher]
 ----
 RETURN
@@ -1800,6 +1805,7 @@ RETURN
     hour: 12, minute: 31, second: 14, microsecond: 645876
   }) AS theDate
 ----
+// end::functions_temporal_localdatetime[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -1850,7 +1856,6 @@ RETURN theDate
 The following query shows the various usages of `+localdatetime({date [, year, ..., nanosecond]})+`.
 
 .Query
-// tag::functions_temporal_localtime_realtime[]
 [source, cypher]
 ----
 WITH date({year: 1984, month: 10, day: 11}) AS dd
@@ -1858,7 +1863,6 @@ RETURN
   localdatetime({date: dd, hour: 10, minute: 10, second: 10}) AS dateHHMMSS,
   localdatetime({date: dd, day: 28, hour: 10, minute: 10, second: 10}) AS dateDDHHMMSS
 ----
-// end::functions_temporal_localtime_realtime[]
 
 .Result
 [role="queryresult",options="header,footer",cols="2*<m"]
@@ -2139,6 +2143,7 @@ For example, `day` -- with some value `x` -- may be provided when the truncation
 ======
 
 .Query
+// tag::functions_temporal_localdatetime_truncate[]
 [source, cypher]
 ----
 WITH
@@ -2154,6 +2159,7 @@ RETURN
   localdatetime.truncate('hour', d, {nanosecond: 2}) AS truncHour,
   localdatetime.truncate('second', d) AS truncSecond
 ----
+// end::functions_temporal_localdatetime_truncate[]
 
 .Result
 [role="queryresult",options="header,footer",cols="6*<m"]
@@ -2228,10 +2234,12 @@ RETURN
 ======
 
 .Query
+// tag::functions_temporal_localtime[]
 [source, cypher]
 ----
 RETURN localtime() AS now
 ----
+// end::functions_temporal_localtime[]
 
 The current local time (i.e. in the local timezone) is returned.
 
@@ -2252,12 +2260,10 @@ The current local time (i.e. in the local timezone) is returned.
 ======
 
 .Query
-// tag::functions_temporal_time[]
 [source, cypher]
 ----
 RETURN localtime({timezone: 'America/Los Angeles'}) AS nowInLA
 ----
-// end::functions_temporal_time[]
 
 The current local time in California is returned.
 
@@ -2339,7 +2345,6 @@ RETURN theTime
 ======
 
 .Query
-// tag::functions_temporal_time_transaction[]
 [source, cypher]
 ----
 WITH time({hour: 12, minute: 31, second: 14, microsecond: 645876, timezone: '+01:00'}) AS tt
@@ -2347,7 +2352,6 @@ RETURN
   localtime({time: tt}) AS timeOnly,
   localtime({time: tt, second: 42}) AS timeSS
 ----
-// end::functions_temporal_time_transaction[]
 
 .Result
 [role="queryresult",options="header,footer",cols="2*<m"]
@@ -2380,10 +2384,12 @@ The returned `LOCAL TIME`  will be the live clock of the system.
 ======
 
 .Query
+// tag::functions_temporal_localtime_realtime[]
 [source, cypher]
 ----
 RETURN localtime.realtime() AS now
 ----
+// end::functions_temporal_localtime_realtime[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -2416,12 +2422,12 @@ However, a different value may be produced for different statements within the s
 ======
 
 .Query
-// tag::functions_temporal_time_statement[]
+// tag::functions_temporal_localtime_statement[]
 [source, cypher]
 ----
 RETURN localtime.statement() AS now
 ----
-// end::functions_temporal_time_statement[]
+// end::functions_temporal_localtime_statement[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -2477,10 +2483,12 @@ However, a different value may be produced for different transactions.
 ======
 
 .Query
+// tag::functions_temporal_localtime_transaction[]
 [source, cypher]
 ----
 RETURN localtime.transaction() AS now
 ----
+// end::functions_temporal_localtime_transaction[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -2534,7 +2542,7 @@ However, the timezone of `input` is retained.
 ======
 
 .Query
-// tag::functions_temporal_time_realtime[]
+// tag::functions_temporal_localtime_truncate[]
 [source, cypher]
 ----
 WITH time({hour: 12, minute: 31, second: 14, nanosecond: 645876123, timezone: '-01:00'}) AS t
@@ -2546,7 +2554,7 @@ RETURN
   localtime.truncate('millisecond', t) AS truncMillisecond,
   localtime.truncate('microsecond', t) AS truncMicrosecond
 ----
-// end::functions_temporal_time_realtime[]
+// end::functions_temporal_localtime_truncate[]
 
 .Result
 [role="queryresult",options="header,footer",cols="6*<m"]
@@ -2629,10 +2637,13 @@ RETURN
 ======
 
 .Query
+// tag::functions_temporal_time[]
 [source, cypher]
 ----
 RETURN time() AS currentTime
 ----
+// end::functions_temporal_time[]
+
 
 The current time of day using the local timezone is returned.
 
@@ -2792,10 +2803,13 @@ The returned `ZONED TIME` will be the live clock of the system.
 ======
 
 .Query
+// tag::functions_temporal_time_realtime[]
 [source, cypher]
 ----
 RETURN time.realtime() AS currentTime
 ----
+// end::functions_temporal_time_realtime[]
+
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -2828,10 +2842,12 @@ However, a different value may be produced for different statements within the s
 ======
 
 .Query
+// tag::functions_temporal_time_statement[]
 [source, cypher]
 ----
 RETURN time.statement() AS currentTime
 ----
+// end::functions_temporal_time_statement[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -2887,10 +2903,13 @@ However, a different value may be produced for different transactions.
 ======
 
 .Query
+// tag::functions_temporal_time_transaction[]
 [source, cypher]
 ----
 RETURN time.transaction() AS currentTime
 ----
+// end::functions_temporal_time_transaction[]
+
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -2942,6 +2961,7 @@ For example, `minute` -- with some value `x` -- may be provided when the truncat
 ======
 
 .Query
+// tag::functions_temporal_time_truncate[]
 [source, cypher]
 ----
 WITH time({hour: 12, minute: 31, second: 14, nanosecond: 645876123, timezone: '-01:00'}) AS t
@@ -2953,6 +2973,7 @@ RETURN
   time.truncate('millisecond', t, {nanosecond: 2}) AS truncMillisecond,
   time.truncate('microsecond', t) AS truncMicrosecond
 ----
+// end::functions_temporal_time_truncate[]
 
 .Result
 [role="queryresult",options="header,footer",cols="6*<m"]

From 2858c29c2369a397579ed0ee6053235d298ec985 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jens=20Pryce-=C3=85klundh?=
 <112686610+JPryce-Aklundh@users.noreply.github.com>
Date: Wed, 23 Apr 2025 09:02:38 +0200
Subject: [PATCH 2/2] fixes

---
 modules/ROOT/pages/functions/temporal/index.adoc | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/modules/ROOT/pages/functions/temporal/index.adoc b/modules/ROOT/pages/functions/temporal/index.adoc
index c3988b289..0be8324f2 100644
--- a/modules/ROOT/pages/functions/temporal/index.adoc
+++ b/modules/ROOT/pages/functions/temporal/index.adoc
@@ -710,7 +710,7 @@ However, a different value may be produced for different statements within the s
 ----
 RETURN date.statement() AS currentDate
 ----
-// tag::functions_temporal_date_statement[]
+// end::functions_temporal_date_statement[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -821,7 +821,7 @@ RETURN
   date.truncate('week', d, {dayOfWeek: 2}) AS truncWeek,
   date.truncate('day', d) AS truncDay
 ----
-// tag::functions_temporal_date_truncate[]
+// end::functions_temporal_date_truncate[]
 
 
 .Result
@@ -1330,13 +1330,13 @@ RETURN datetime({epochMillis: 424797300000}) AS theDate
 ======
 
 .Query
-// tag::functions_temporal_datetime_fromepoch
+// tag::functions_temporal_datetime_fromepoch[]
 [source, cypher]
 ----
 WITH datetime.fromEpoch(1683000000, 123456789) AS dateTimeFromEpoch
 RETURN dateTimeFromEpoch
 ----
-// end::functions_temporal_datetime_fromepoch
+// end::functions_temporal_datetime_fromepoch[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -1365,13 +1365,13 @@ RETURN dateTimeFromEpoch
 ======
 
 .Query
-// tag::functions_temporal_datetime_fromepochmillis
+// tag::functions_temporal_datetime_fromepochmillis[]
 [source, cypher]
 ----
 WITH datetime.fromEpochMillis(1724198400000) AS dateTimeFromMillis
 RETURN dateTimeFromMillis
 ----
-// end::functions_temporal_datetime_fromepochmillis
+// end::functions_temporal_datetime_fromepochmillis[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]