From 31ba236fd30811b4b24ae08d68c5b9ffbb616575 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jens=20Pryce-=C3=85klundh?=
 <112686610+JPryce-Aklundh@users.noreply.github.com>
Date: Wed, 19 Feb 2025 11:35:37 +0100
Subject: [PATCH 1/5] add examples

---
 .../ROOT/pages/values-and-types/temporal.adoc | 581 +++++++++++++++---
 1 file changed, 492 insertions(+), 89 deletions(-)

diff --git a/modules/ROOT/pages/values-and-types/temporal.adoc b/modules/ROOT/pages/values-and-types/temporal.adoc
index 9d7fd4a25..828677775 100644
--- a/modules/ROOT/pages/values-and-types/temporal.adoc
+++ b/modules/ROOT/pages/values-and-types/temporal.adoc
@@ -511,145 +511,399 @@ For more information, see the xref::values-and-types/temporal.adoc#cypher-tempor
 [[cypher-temporal-specify-instant-examples]]
 === Examples
 
-Below are examples of parsing instant values using various temporal functions.
-More information about these temporal functions can be found xref::functions/temporal/index.adoc[here].
+In order to create or parse a temporal instant type, its corresponding xref:functions/temporal/index.adoc[function] must be used.
+For example, in order to create a property value of type `ZONED DATETIME`, the xref:functions/temporal/index.adoc#functions-datetime[`datetime()`] function must be used.
 
-.+datetime+
-======
+This section provides examples of how to create properties with different temporal value types and how to parse temporal instant values.
+For specific examples, see:
 
-Parsing a `ZONED DATETIME` using the _calendar date_ format:
 
-.Query
+* xref:values-and-types/temporal.adoc#examples-date[`DATE`]
+* xref:values-and-types/temporal.adoc#examples-localtime[`LOCAL TIME`]
+* xref:values-and-types/temporal.adoc#examples-zonedtime[`ZONED TIME`]
+* xref:values-and-types/temporal.adoc#examples-local-datetime[`LOCAL DATETIME`]
+* xref:values-and-types/temporal.adoc#examples-zoned-datetime[`ZONED DATETIME`]
+* xref:values-and-types/temporal.adoc#examples-truncate[Truncating temporal values]
+
+[[examples-date]]
+==== `DATE`
+
+To work with `DATE` values, including creating, parsing, and extracting components, use the xref:functions/temporal/index.adoc#functions-date[`date()`] function.
+
+.`DATE`
+======
+
+.Create a `DATE` property value
 [source, cypher]
 ----
-RETURN datetime('2015-06-24T12:50:35.556+0100') AS theDateTime
+CREATE (n:Label)
+SET n.date = date("2025-02-18") 
+RETURN n.date AS date, valueType(n.date) AS temporalValueType
 ----
 
 .Result
-[role="queryresult",options="header,footer",cols="1*<m"]
+[role="queryresult",options="header,footer",cols="2*<m"]
 |===
-| +theDateTime+
-| +2015-06-24T12:50:35.556+01:00+
+| date | temporalValueType
+
+| 2025-02-18 | "DATE NOT NULL"
+
 1+d|Rows: 1
 |===
 
-======
+.Create a `DATE` property value using components
+[source, cypher]
+----
+CREATE (n:Label)
+SET n.date = date({year: 2025, month: 2, day: 18}) 
+RETURN n.date AS date, valueType(n.date) AS temporalValueType
+----
 
+.Result
+[role="queryresult",options="header,footer",cols="2*<m"]
+|===
+| date | temporalValueType
 
-.+localdatetime+
-======
+| 2025-02-18 | "DATE NOT NULL"
 
-Parsing a `LOCAL DATETIME` using the _ordinal date_ format:
+1+d|Rows: 1
+|===
 
-.Query
+.Parse a `DATE` using the week date format:
 [source, cypher]
 ----
-RETURN localdatetime('2015185T19:32:24') AS theLocalDateTime
+RETURN date('+2015-W13-4') AS theDate
 ----
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
 |===
-| +theLocalDateTime+
-| +2015-07-04T19:32:24+
+| theDate
+
+| 2015-03-26
+
 1+d|Rows: 1
 |===
 
+
+.Get the components of a `DATE` value
+[source, cypher]
+----
+WITH date({year: 1984, month: 10, day: 11}) AS d
+RETURN d.year, d.quarter, d.month, d.week, d.weekYear, d.day, d.ordinalDay, d.dayOfWeek, d.dayOfQuarter
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="9*<m"]
+|===
+| d.year | d.quarter | d.month | d.week | d.weekYear | d.day | d.ordinalDay | d.dayOfWeek | d.dayOfQuarter
+
+| 1984 | 4 | 10 | 41 | 1984 | 11 | 285 | 4 | 11
+
+9+d|Rows: 1
+|===
+
 ======
 
 
-.+date+
+[[examples-localtime]]
+==== `LOCAL TIME`
+
+To work with `LOCAL TIME` values, including creating, parsing, and extracting components, use the xref:functions/temporal/index.adoc#functions-localtime[`localtime()`] function.
+
+.`LOCAL TIME`
 ======
 
-Parsing a `DATE` using the _week date_ format:
+.Create a `LOCAL TIME` property value
+[source, cypher]
+----
+CREATE (n:Label)
+SET n.localTime = localtime("12:34:56.789")
+RETURN n.localTime AS localTime, valueType(n.localTime) AS temporalValueType
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="2*<m"]
+|===
+| localTime       | temporalValueType
 
-.Query
+| 12:34:56.789 | "LOCAL TIME NOT NULL"
+
+2+d|Rows: 1
+|===
+
+
+.Create a `LOCAL TIME` property value using components
 [source, cypher]
 ----
-RETURN date('+2015-W13-4') AS theDate
+CREATE (n:Label)
+SET n.localTime = localtime({hour: 12, minute: 34, second: 56, millisecond: 789})
+RETURN n.localTime AS localTime, valueType(n.localtime) AS temporalValueType
 ----
 
 .Result
-[role="queryresult",options="header,footer",cols="1*<m"]
+[role="queryresult",options="header,footer",cols="2*<m"]
 |===
-| +theDate+
-| +2015-03-26+
-1+d|Rows: 1
+| localTime       | temporalValueType
+
+| 12:34:56.789 | "LOCAL TIME NOT NULL"
+
+2+d|Rows: 1
 |===
 
+
+.Get the components of a `LOCAL TIME` value
+[source, cypher]
+----
+WITH localtime({hour: 12, minute: 34, second: 56, millisecond: 789}) AS t
+RETURN t.hour, t.minute, t.second, t.millisecond
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="4*<m"]
+|===
+| t.hour | t.minute | t.second | t.millisecond
+
+| 12 | 34 | 56 | 789
+
+4+d|Rows: 1
+|===
+
+
 ======
 
+[[examples-zonedtime]]
+==== `ZONED TIME`
 
-.+time+
+To work with `ZONED TIME` values, including creating, parsing, and extracting components, use the xref:functions/temporal/index.adoc#functions-time[`time()`] function.
+
+.`ZONED TIME`
 ======
-Parsing a `ZONED TIME`:
 
-.Query
+.Create a `ZONED TIME` property value with an offset
 [source, cypher]
 ----
-RETURN time('125035.556+0100') AS theTime
+CREATE (n:Label)
+SET n.zonedTime = time("12:34:56.789+02:00")
+RETURN n.zonedTime AS zonedTime, valueType(n.time) AS temporalValueType
 ----
 
 .Result
-[role="queryresult",options="header,footer",cols="1*<m"]
+[role="queryresult",options="header,footer",cols="2*<m"]
 |===
-| +theTime+
-| +12:50:35.556000000+01:00+
-1+d|Rows: 1
+| zonedTime | temporalValueType
+             
+| 12:34:56.789+02:00 | "ZONED TIME NOT NULL"
+
+2+d|Rows: 1
+|===
+
+
+.Create a `ZONED TIME` property value with components and a time zone
+[source, cypher]
+----
+CREATE (n:Label)
+SET n.time = time({hour: 12, minute: 34, second: 56, millisecond: 789, timezone: 'Europe/Stockholm'})
+RETURN n.time AS time, valueType(n.time) AS temporalValueType
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="2*<m"]
+|===
+| time | temporalValueType
+             
+| 12:34:56.789+01:00 | "ZONED TIME NOT NULL"
+
+2+d|Rows: 1
+|===
+
+
+.Get the components of a `ZONED TIME` value
+[source, cypher]
+----
+WITH time("12:34:56.789+02:00") AS t
+RETURN t.hour, t.minute, t.second, t.millisecond, t.offset
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="5*<m"]
+|===
+| t.hour | t.minute | t.second | t.millisecond | t.offset
+
+| 12 | 34 | 56 | 789 | "+02:00"
+
+5+d|Rows: 1
 |===
 
 ======
 
 
-.+localtime+
+
+[[examples-local-datetime]]
+==== `LOCAL DATETIME`
+
+To work with `LOCAL DATETIME` values, including creating, parsing, and extracting components, use the xref:functions/temporal/index.adoc#functions-localdatetime[`localdatetime()`] function.
+
+.`LOCAL DATETIME`
 ======
 
-Parsing a `LOCAL TIME`:
+.Create a `LOCAL DATETIME` property value using the ordinal date format:
+[source, cygher]
+----
+CREATE (n:Label)
+SET n.localDateTime = localdatetime("2025-02-18T12:34:56")
+RETURN n.localDateTime AS localDateTime, valueType(n.localDateTime) AS temporalValueType
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="2*<m"]
+|===
+| localDateTime       | temporalValueType 
 
-.Query
+| 2025-02-18T12:34:56 | "LOCAL DATETIME NOT NULL" 
+
+2+d|Rows: 1
+
+|===
+
+.Create a `LOCAL DATETIME` property value using temporal components
 [source, cypher]
 ----
-RETURN localtime('12:50:35.556') AS theLocalTime
+CREATE (n:Label)
+SET n.localDateTime = localdatetime({year: 2025, month: 2, day: 18, hour: 12, minute: 34, second: 56, millisecond: 789})
+RETURN n.localDateTime AS localDateTime, valueType(n.localDateTime) AS temporalValueType
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="2*<m"]
+|===
+| localDatetime       | temporalValueType
+
+| 2025-02-18T12:34:56.789 | "LOCAL DATETIME NOT NULL" 
+
+2+d|Rows: 1
+
+|===
+
+
+.Parse a `LOCAL DATETIME` using the ordinal date format:
+[source, cypher]
+----
+RETURN localdatetime('2015185T19:32:24') AS theLocalDateTime
 ----
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
 |===
-| +theLocalTime+
-| +12:50:35.556000000+
+| theLocalDateTime
+
+| 2015-07-04T19:32:24
+
 1+d|Rows: 1
 |===
 
+
+.Get the components of a `LOCAL DATETIME` value
+[source, cypher]
+----
+WITH localdatetime({year: 2025, month: 2, day: 19, hour: 12, minute: 34, second: 56, millisecond: 789}) AS t
+RETURN t.year, t.month, t.day, t.hour, t.minute, t.second, t.millisecond
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="7*<m"]
+|===
+| t.year | t.month | t.day | t.hour | t.minute | t.second | t.millisecond
+
+| 2025 | 2 | 19 | 12 | 34 | 56 | 789
+
+7+d|Rows: 1
+|===
+
 ======
-.+date+
+
+
+[[examples-zoned-datetime]]
+==== `ZONED DATETIME`
+
+To work with `ZONED DATETIME` values, including creating, parsing, and extracting components, use the xref:functions/temporal/index.adoc#functions-datetime[`datetime()`] function.
+
+.`ZONED DATETIME`
 ======
 
-The following query shows how to get the components of a `DATE` value:
+.Create a `ZONED DATETIME` property value using calendar date format
+[source, cypher, role=test-result-skip]
+----
+CREATE (n:Label)
+SET n.zonedDatetime = datetime("2025-02-18T12:34:56.789+02:00")
+RETURN n.zonedDateTime AS zonedDatetTime, valueType(n.zonedDateTime) AS temporalValueType
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="2*<m"]
+|===
+| zonedDateTime | temporalValueType
 
-.Query
+| 2025-02-18T12:34:56.789+02:00 | "ZONED DATETIME NOT NULL"
+
+2+d|Rows: 1
+|===
+
+
+.Create a `ZONED DATETIME` property value using temporal components
 [source, cypher]
 ----
-WITH date({year: 1984, month: 10, day: 11}) AS d
-RETURN d.year, d.quarter, d.month, d.week, d.weekYear, d.day, d.ordinalDay, d.dayOfWeek, d.dayOfQuarter
+CREATE (n:Label)
+SET n.zonedDateTime = datetime({year: 2025, month: 2, day: 18, hour: 12, minute: 34, second: 56, millisecond: 789, timezone: 'Europe/Stockholm'})
+RETURN n.zonedDateTime, valueType(n.zonedDateTime) AS temporalValueType
 ----
 
 .Result
-[role="queryresult",options="header,footer",cols="9*<m"]
+[role="queryresult",options="header,footer",cols="2*<m"]
 |===
-| +d.year+ | +d.quarter+ | +d.month+ | +d.week+ | +d.weekYear+ | +d.day+ | +d.ordinalDay+ | +d.dayOfWeek+ | +d.dayOfQuarter+
-| +1984+ | +4+ | +10+ | +41+ | +1984+ | +11+ | +285+ | +4+ | +11+
-9+d|Rows: 1
+| zonedDateTime | temporalValueType
+
+|  2025-02-18T12:34:56.789+01:00[Europe/Stockholm] | "ZONED DATETIME NOT NULL"
+
+2+d|Rows: 1
 |===
 
-======
+.Create a `ZONED DATETIME` property value using a timezone
+[source, cypher, role=test-result-skip]
+----
+CREATE (n:Label)
+SET n.zonedDateTime = datetime({timezone: 'Europe/Stockholm'})
+RETURN n.zonedDateTime AS zonedDateTime, valueType(n.zonedDatetime) AS temporalValueType
+----
 
+.Result
+[role="queryresult",options="header,footer",cols="2*<m"]
+|===
+| zonedDateTime | temporalValueType
 
-.+datetime+
-======
+| 2025-02-18T15:22:48.227+01:00[Europe/Stockholm] | "ZONED DATETIME NOT NULL"
 
-The following query shows how to get the date-related components of a `ZONED DATETIME` value:
+2+d|Rows: 1
 
-.Query
+|===
+
+.Parse a `ZONED DATETIME` using the calendar date format
+[source, cypher]
+----
+RETURN datetime('2015-06-24T12:50:35.556+0100') AS theDateTime
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="1*<m"]
+|===
+| theDateTime
+
+| 2015-06-24T12:50:35.556+01:00
+
+1+d|Rows: 1
+|===
+
+.Get the date-related components of a `ZONED DATETIME` value:
 [source, cypher]
 ----
 WITH datetime({
@@ -663,19 +917,15 @@ RETURN d.year, d.quarter, d.month, d.week, d.weekYear, d.day, d.ordinalDay, d.da
 .Result
 [role="queryresult",options="header,footer",cols="9*<m"]
 |===
-| +d.year+ | +d.quarter+ | +d.month+ | +d.week+ | +d.weekYear+ | +d.day+ | +d.ordinalDay+ | +d.dayOfWeek+ | +d.dayOfQuarter+
-| +1984+ | +4+ | +11+ | +45+ | +1984+ | +11+ | +316+ | +7+ | +42+
-9+d|Rows: 1
-|===
+| d.year | d.quarter | d.month | d.week | d.weekYear | d.day | d.ordinalDay | d.dayOfWeek | d.dayOfQuarter
 
-======
+| 1984 | 4 | 11 | 45 | 1984 | 11 | 316 | 7 | 42
 
-.+datetime+
-======
+9+d|Rows: 1
+|===
 
-The following query shows how to get the time-related components of a `ZONED DATETIME` value:
 
-.Query
+.Get the time-related components of a `ZONED DATETIME` value:
 [source, cypher]
 ----
 WITH datetime({
@@ -689,20 +939,14 @@ RETURN d.hour, d.minute, d.second, d.millisecond, d.microsecond, d.nanosecond
 .Result
 [role="queryresult",options="header,footer",cols="6*<m"]
 |===
-| +d.hour+ | +d.minute+ | +d.second+ | +d.millisecond+ | +d.microsecond+ | +d.nanosecond+
-| +12+ | +31+ | +14+ | +645+ | +645876+ | +645876123+
-6+d|Rows: 1
-|===
-
-======
+| d.hour | d.minute | d.second | d.millisecond | d.microsecond | d.nanosecond
 
+| 12 | 31 | 14 | 645 | 645876 | 645876123
 
-.+datetime+
-======
-
-The following query shows how to get the epoch time and timezone-related components of a `ZONED DATETIME` value:
+6+d|Rows: 1
+|===
 
-.Query
+.Get the epoch time and timezone-related components of a `ZONED DATETIME` value:
 [source, cypher]
 ----
 WITH datetime({
@@ -716,21 +960,26 @@ RETURN d.timezone, d.offset, d.offsetMinutes, d.epochSeconds, d.epochMillis
 .Result
 [role="queryresult",options="header,footer",cols="5*<m"]
 |===
-| +d.timezone+ | +d.offset+ | +d.offsetMinutes+ | +d.epochSeconds+ | +d.epochMillis+
-| +"Europe/Stockholm"+ | +"+01:00"+ | +60+ | +469020674+ | +469020674645+
+| d.timezone | d.offset | d.offsetMinutes | d.epochSeconds | d.epochMillis
+
+| "Europe/Stockholm" | "+01:00" | 60 | 469020674 | 469020674645
+
 5+d|Rows: 1
 |===
 
 
 ======
 
+[[examples-truncate]]
+==== Truncating temporal values
 
-.+date.truncate+
+.Truncate `DATE` values
 ======
 
-Get the first day of the current year:
+To truncate `DATE` values, use the xref:functions/temporal/index.adoc#functions-date-truncate[`date.truncate()`] function.
 
-.Query
+
+.Get the first day of the current year:
 [source, cypher, role=test-result-skip]
 ----
 RETURN date.truncate('year') AS day
@@ -739,34 +988,188 @@ RETURN date.truncate('year') AS day
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
 |===
-| +day+
-| +2022-01-01+
+| day
+
+| 2022-01-01
+
 1+d|Rows: 1
 |===
 
-======
+.Get the date of the Thursday in the week of a specific date:
+[source, cypher]
+----
+RETURN date.truncate('week', date('2019-10-01'), {dayOfWeek: 4}) AS thursday
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="1*<m"]
+|===
+| thursday
 
+| 2019-10-03
+
+1+d|Rows: 1
+|===
 
-.+date.truncate+
 ======
 
-Get the date of the Thursday in the week of a specific date:
+.Truncate `LOCAL TIME` values
+=====
 
-.Query
+To truncate `LOCAL TIME` values, use the xref:functions/temporal/index.adoc#functions-localtime-truncate[`localtime.truncate()`] function.
+
+.Get the start of the current minute for a specific `LOCAL TIME` value
+[source,cypher]
+----
+RETURN localtime.truncate('minute', localtime("12:34:56.789")) AS truncatedMinute
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="1*<m"]
+|===
+| truncatedMinute
+
+| 12:34
+
+1+d|Rows: 1
+|===
+
+.Get the start of the current second using the system's `LOCAL TIME`
+[source, cypher, role=test-result-skip]
+----
+RETURN localtime.truncate('second') AS currentSecond
+----
+
+
+.Result
+[role="queryresult",options="header,footer",cols="1*<m"]
+|===
+| currentSecond
+
+| 10:12:28
+
+1+d|Rows: 1
+|===
+
+=====
+
+.Truncate `ZONED TIME` values
+=====
+
+To truncate `ZONED TIME` values, use the xref:functions/temporal/index.adoc#functions-time-truncate[`time.truncate()`] function.
+
+.Get the start of the current minute for a specific `ZONED TIME` value
+[source,cypher]
+----
+RETURN time.truncate('minute', time("12:34:56.789+02:00")) AS truncatedMinute
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="1*<m"]
+|===
+| truncatedMinute
+
+| 12:34+02:00 
+
+1+d|Rows: 1
+|===
+
+.Get the current `ZONED TIME` truncated to the nearest minute
 [source, cypher]
 ----
-RETURN date.truncate('week', date('2019-10-01'), {dayOfWeek: 4}) AS thursday
+RETURN time.truncate('minute', time()) AS currentTime
 ----
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
 |===
-| +thursday+
-| +2019-10-03+
+| truncatedTime
+
+| 10:20Z
+
 1+d|Rows: 1
 |===
 
-======
+=====
+
+.Truncate `LOCAL DATETIME` values
+=====
+
+To truncate `LOCAL DATETIME` values, use the xref:functions/temporal/index.adoc#functions-localdatetime-truncate[`localdatetime.truncate()`] function.
+
+.Get the start of the hour for a specific `LOCAL DATETIME`
+[source, cypher]
+----
+RETURN localdatetime.truncate('hour', localdatetime("2025-02-18T12:34:56.789")) AS truncatedHour
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="1*<m"]
+|===
+| truncatedHour
+
+| 2025-02-18T12:00
+
+1+d|Rows: 1
+|===
+
+.Get the start of the current month in `LOCAL DATETIME`
+[source, cypher, role=test-result-skip]
+----
+RETURN localdatetime.truncate('month') AS truncatedMonth
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="1*<m"]
+|===
+| truncatedMonth
+
+| 2025-02-01T00:00
+
+1+d|Rows: 1
+|===
+
+=====
+
+.Truncate `ZONED DATETIME` values
+=====
+
+To truncate `ZONED DATETIME` values, use the xref:functions/temporal/index.adoc#functions-datetime-truncate[`datetime.truncate()`] function.
+
+.Get the start of the minute for a specific `ZONED DATETIME`
+[source, cypher]
+----
+RETURN datetime.truncate('minute', datetime("2025-02-18T12:34:56.789+02:00")) AS truncatedZonedDateTime
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="1*<m"]
+|===
+| truncatedZonedDateTime
+
+| 2025-02-18T12:34+02:00
+
+1+d|Rows: 1
+|===
+
+.Get the start of Wednesday for the current week in `ZONED DATETIME`
+[source, cypher]
+----
+RETURN datetime.truncate('week', datetime(), {dayOfWeek: 3}) AS startOfWednesday
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="1*<m"]
+|===
+| startOfWednesday
+
+|  2025-02-19T00:00Z
+
+1+d|Rows: 1
+|===
+
+=====
+
 
 
 [[cypher-temporal-durations]]

From 743bbf02959dfb04f452e4f8847fe470d5a408dd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jens=20Pryce-=C3=85klundh?=
 <112686610+JPryce-Aklundh@users.noreply.github.com>
Date: Wed, 19 Feb 2025 11:45:06 +0100
Subject: [PATCH 2/5] reword

---
 modules/ROOT/pages/values-and-types/temporal.adoc | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/modules/ROOT/pages/values-and-types/temporal.adoc b/modules/ROOT/pages/values-and-types/temporal.adoc
index 828677775..ca345e6cc 100644
--- a/modules/ROOT/pages/values-and-types/temporal.adoc
+++ b/modules/ROOT/pages/values-and-types/temporal.adoc
@@ -511,13 +511,11 @@ For more information, see the xref::values-and-types/temporal.adoc#cypher-tempor
 [[cypher-temporal-specify-instant-examples]]
 === Examples
 
-In order to create or parse a temporal instant type, its corresponding xref:functions/temporal/index.adoc[function] must be used.
+To work with a particular temporal instant type, its corresponding xref:functions/temporal/index.adoc[function] must be used.
 For example, in order to create a property value of type `ZONED DATETIME`, the xref:functions/temporal/index.adoc#functions-datetime[`datetime()`] function must be used.
 
-This section provides examples of how to create properties with different temporal value types and how to parse temporal instant values.
 For specific examples, see:
 
-
 * xref:values-and-types/temporal.adoc#examples-date[`DATE`]
 * xref:values-and-types/temporal.adoc#examples-localtime[`LOCAL TIME`]
 * xref:values-and-types/temporal.adoc#examples-zonedtime[`ZONED TIME`]
@@ -548,7 +546,7 @@ RETURN n.date AS date, valueType(n.date) AS temporalValueType
 
 | 2025-02-18 | "DATE NOT NULL"
 
-1+d|Rows: 1
+2+d|Rows: 1
 |===
 
 .Create a `DATE` property value using components
@@ -566,7 +564,7 @@ RETURN n.date AS date, valueType(n.date) AS temporalValueType
 
 | 2025-02-18 | "DATE NOT NULL"
 
-1+d|Rows: 1
+2+d|Rows: 1
 |===
 
 .Parse a `DATE` using the week date format:
@@ -973,6 +971,8 @@ RETURN d.timezone, d.offset, d.offsetMinutes, d.epochSeconds, d.epochMillis
 [[examples-truncate]]
 ==== Truncating temporal values
 
+The truncate functions in Neo4j allow you to reduce the precision of temporal values  by truncating them to a specified component such as `year`, `month`, or `second`.
+
 .Truncate `DATE` values
 ======
 
@@ -982,13 +982,13 @@ To truncate `DATE` values, use the xref:functions/temporal/index.adoc#functions-
 .Get the first day of the current year:
 [source, cypher, role=test-result-skip]
 ----
-RETURN date.truncate('year') AS day
+RETURN date.truncate('year') AS firstDay
 ----
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
 |===
-| day
+| firstDay
 
 | 2022-01-01
 
@@ -1171,7 +1171,6 @@ RETURN datetime.truncate('week', datetime(), {dayOfWeek: 3}) AS startOfWednesday
 =====
 
 
-
 [[cypher-temporal-durations]]
 == Durations
 

From 421f3b54a2f01f457e446220efb73c953ae2fe63 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jens=20Pryce-=C3=85klundh?=
 <112686610+JPryce-Aklundh@users.noreply.github.com>
Date: Wed, 19 Feb 2025 13:02:57 +0100
Subject: [PATCH 3/5] fix query

---
 modules/ROOT/pages/values-and-types/temporal.adoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/modules/ROOT/pages/values-and-types/temporal.adoc b/modules/ROOT/pages/values-and-types/temporal.adoc
index ca345e6cc..262789524 100644
--- a/modules/ROOT/pages/values-and-types/temporal.adoc
+++ b/modules/ROOT/pages/values-and-types/temporal.adoc
@@ -636,7 +636,7 @@ RETURN n.localTime AS localTime, valueType(n.localTime) AS temporalValueType
 ----
 CREATE (n:Label)
 SET n.localTime = localtime({hour: 12, minute: 34, second: 56, millisecond: 789})
-RETURN n.localTime AS localTime, valueType(n.localtime) AS temporalValueType
+RETURN n.localTime AS localTime, valueType(n.localTime) AS temporalValueType
 ----
 
 .Result

From 6fc055837f14e6d5626dfff11accb9d2f58275d1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jens=20Pryce-=C3=85klundh?=
 <112686610+JPryce-Aklundh@users.noreply.github.com>
Date: Wed, 19 Feb 2025 13:11:29 +0100
Subject: [PATCH 4/5] more query fixed

---
 modules/ROOT/pages/values-and-types/temporal.adoc | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/modules/ROOT/pages/values-and-types/temporal.adoc b/modules/ROOT/pages/values-and-types/temporal.adoc
index 262789524..26113bf3a 100644
--- a/modules/ROOT/pages/values-and-types/temporal.adoc
+++ b/modules/ROOT/pages/values-and-types/temporal.adoc
@@ -683,7 +683,7 @@ To work with `ZONED TIME` values, including creating, parsing, and extracting co
 ----
 CREATE (n:Label)
 SET n.zonedTime = time("12:34:56.789+02:00")
-RETURN n.zonedTime AS zonedTime, valueType(n.time) AS temporalValueType
+RETURN n.zonedTime AS zonedTime, valueType(n.zonedTime) AS temporalValueType
 ----
 
 .Result
@@ -701,8 +701,8 @@ RETURN n.zonedTime AS zonedTime, valueType(n.time) AS temporalValueType
 [source, cypher]
 ----
 CREATE (n:Label)
-SET n.time = time({hour: 12, minute: 34, second: 56, millisecond: 789, timezone: 'Europe/Stockholm'})
-RETURN n.time AS time, valueType(n.time) AS temporalValueType
+SET n.zonedTime = time({hour: 12, minute: 34, second: 56, millisecond: 789, timezone: 'Europe/Stockholm'})
+RETURN n.zonedTime AS zonedTime, valueType(zonedTime) AS temporalValueType
 ----
 
 .Result
@@ -834,7 +834,7 @@ To work with `ZONED DATETIME` values, including creating, parsing, and extractin
 ----
 CREATE (n:Label)
 SET n.zonedDatetime = datetime("2025-02-18T12:34:56.789+02:00")
-RETURN n.zonedDateTime AS zonedDatetTime, valueType(n.zonedDateTime) AS temporalValueType
+RETURN n.zonedDateTime AS zonedDateTime, valueType(n.zonedDateTime) AS temporalValueType
 ----
 
 .Result

From 680f231ff7a1815ea62143eedaa8db3a9fd6882d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jens=20Pryce-=C3=85klundh?=
 <112686610+JPryce-Aklundh@users.noreply.github.com>
Date: Wed, 19 Feb 2025 13:23:02 +0100
Subject: [PATCH 5/5] more fixes

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

diff --git a/modules/ROOT/pages/values-and-types/temporal.adoc b/modules/ROOT/pages/values-and-types/temporal.adoc
index 26113bf3a..106107711 100644
--- a/modules/ROOT/pages/values-and-types/temporal.adoc
+++ b/modules/ROOT/pages/values-and-types/temporal.adoc
@@ -702,7 +702,7 @@ RETURN n.zonedTime AS zonedTime, valueType(n.zonedTime) AS temporalValueType
 ----
 CREATE (n:Label)
 SET n.zonedTime = time({hour: 12, minute: 34, second: 56, millisecond: 789, timezone: 'Europe/Stockholm'})
-RETURN n.zonedTime AS zonedTime, valueType(zonedTime) AS temporalValueType
+RETURN n.zonedTime AS zonedTime, valueType(n.zonedTime) AS temporalValueType
 ----
 
 .Result
@@ -833,7 +833,7 @@ To work with `ZONED DATETIME` values, including creating, parsing, and extractin
 [source, cypher, role=test-result-skip]
 ----
 CREATE (n:Label)
-SET n.zonedDatetime = datetime("2025-02-18T12:34:56.789+02:00")
+SET n.zonedDateTime = datetime("2025-02-18T12:34:56.789+02:00")
 RETURN n.zonedDateTime AS zonedDateTime, valueType(n.zonedDateTime) AS temporalValueType
 ----
 
@@ -871,7 +871,7 @@ RETURN n.zonedDateTime, valueType(n.zonedDateTime) AS temporalValueType
 ----
 CREATE (n:Label)
 SET n.zonedDateTime = datetime({timezone: 'Europe/Stockholm'})
-RETURN n.zonedDateTime AS zonedDateTime, valueType(n.zonedDatetime) AS temporalValueType
+RETURN n.zonedDateTime AS zonedDateTime, valueType(n.zonedDateTime) AS temporalValueType
 ----
 
 .Result