review suggestions

Author: rsill-neo4j

modules/ROOT/pages/functions/temporal/format.adoc

@@ -33,28 +33,6 @@ Use the characters in xref:#query-functions-temporal-format-instance-types-chara
 [[query-functions-temporal-format-instance-types-examples]]
 === Examples
 
-.Instance formatting with year, month, day, hour, minute, second, fraction-of-second and zone-offset
-======
-
-.Query
-[source, cypher, indent=0]
-----
-WITH datetime('1986-11-18T6:04:45.123456789+01:00[Europe/Berlin]') AS dt
-RETURN format(dt, "yyyy-MM-dd'T'HH:mm:ss.SSSZ") AS x
-----
-
-.Result
-[role="queryresult",options="header,footer",cols="1*<m"]
-|===
-
-| x
-| "1986-11-18T06:04:45.123+0100"
-1+d|Rows: 1
-
-|===
-
-======
-
 .Instance formatting, European and US American dates
 ======
 
@@ -84,14 +62,14 @@ RETURN format(dt, "MM/dd/yyyy") AS EU, format(dt, "dd/MM/yyyy") AS US
 [source, cypher, indent=0]
 ----
 WITH datetime('1986-11-18T6:04:45.123456789+01:00[Europe/Berlin]') AS dt
-RETURN format(dt, "EEEE, MMMM d, G uuuu") AS x
+RETURN format(dt, "EEEE, MMMM d, G uuuu") AS instanceString
 ----
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
 |===
 
-| x
+| instanceString
 | "Tuesday, November 18, AD 1986"
 1+d|Rows: 1
 
@@ -108,14 +86,14 @@ Four occurrences of `E` and `M` (text presentations) output the full form of the
 [source, cypher, indent=0]
 ----
 WITH datetime('1986-11-18T6:04:45.123456789+01:00[Europe/Berlin]') AS dt
-RETURN format(dt, "DDD'th day of the year,' c'rd day of the week'") AS x
+RETURN format(dt, "DDD'th day of the year,' c'rd day of the week'") AS instanceString
 ----
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
 |===
 
-| x
+| instanceString
 | "322th day of the year, 3rd day of the week"
 1+d|Rows: 1
 
@@ -152,14 +130,14 @@ RETURN format(dt, "k:mm z") AS CET, format(dt, "K:mm O") AS GMT
 [source, cypher, indent=0]
 ----
 WITH datetime('1986-11-18T6:04:45.123456789+01:00[Europe/Berlin]') AS dt
-RETURN format(dt, "LLL d,' minute 'm', second 's', millisecond of the day 'A") AS x
+RETURN format(dt, "LLL d,' minute 'm', second 's', millisecond of the day 'A") AS instanceString
 ----
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
 |===
 
-| x
+| instanceString
 | "Nov 18, minute 4, second 45, millisecond of the day 21885123"
 1+d|Rows: 1
 
@@ -176,14 +154,14 @@ Three occurrences of `L` (number/text presentation) output the short form ("Nov"
 [source, cypher, indent=0]
 ----
 WITH datetime('1986-11-18T6:04:45.123456789+01:00[Europe/Berlin]') AS dt
-RETURN format(dt, "pppYY") AS x
+RETURN format(dt, "pppYY") AS instanceString
 ----
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
 |===
 
-| x
+| instanceString
 | " 86"
 1+d|Rows: 1
 
@@ -270,8 +248,9 @@ For example, not all months have the same number of days, and switches to or fro
 .Query
 [source, cypher, indent=0]
 ----
-WITH duration({years: 1, months: 4, weeks: 3, days: 4, hours: 5, minutes: 6, seconds: 7, milliseconds: 8,  microseconds: 9, nanoseconds: 10}) AS d
+WITH duration({years: 1, months: 4}) AS d
 RETURN format(d, "y 'years' q 'quarters' M 'months'") AS withYears, format(d, "q 'quarters' M 'months'") AS withoutYears
+
 ----
 
 .Result
@@ -291,7 +270,7 @@ RETURN format(d, "y 'years' q 'quarters' M 'months'") AS withYears, format(d, "q
 .Query
 [source, cypher, indent=0]
 ----
-WITH duration({years: 1, months: 4, weeks: 3, days: 4, hours: 5, minutes: 6, seconds: 7, milliseconds: 8,  microseconds: 9, nanoseconds: 10}) AS d
+WITH duration({weeks: 3, days: 4}) AS d
 RETURN format(d, "w 'weeks' d 'days'") AS withWeeks, format(d, "d 'days'") AS withoutWeeks
 ----
 
@@ -313,20 +292,22 @@ RETURN format(d, "w 'weeks' d 'days'") AS withWeeks, format(d, "d 'days'") AS wi
 .Query
 [source, cypher, indent=0]
 ----
-WITH duration({years: 1, months: 4, weeks: 3, days: 4, hours: 5, minutes: 6, seconds: 7, milliseconds: 8,  microseconds: 9, nanoseconds: 10}) AS d
-RETURN format(d, "m 'minutes' s 'seconds' N 'nanos'") AS withMinutes, format(d, "s 'seconds' N 'nanos'") AS withoutMinutes 
+WITH duration({days: 4, hours: 5, minutes: 6, seconds: 7}) AS d
+RETURN format(d, "m 'minutes' s 'seconds'") AS withMinutes, format(d, "s 'seconds'") AS withoutMinutes 
 ----
 
 .Result
 [role="queryresult",options="header,footer",cols="2*<m"]
 |===
 
-| withMinutes                           | withoutMinutes
-| "306 minutes 7 seconds 8009010 nanos" | "18367 seconds 8009010 nanos"
+| withMinutes             | withoutMinutes
+| "306 minutes 7 seconds" | "18367 seconds"
 2+d|Rows: 1
 
 |===
 
+Not how the days cannot be converted to hours and do not affect the query result.
+
 ======
 
 

modules/ROOT/pages/values-and-types/temporal.adoc

@@ -1761,16 +1761,16 @@ Using Cypher's xref:/functions/temporal/format.adoc#_instance_types[`format()` f
 [source, cypher, indent=0]
 ----
 WITH datetime('1986-11-18T6:04:45.123456789+01:00[Europe/Berlin]') AS dt
-RETURN format(dt, "yyyy-MM-dd'T'HH:mm:ss.SSSZ") AS x
+RETURN format(dt, "MM/dd/yyyy") AS EU, format(dt, "dd/MM/yyyy") AS US
 ----
 
 .Result
-[role="queryresult",options="header,footer",cols="1*<m"]
+[role="queryresult",options="header,footer",cols="2*<m"]
 |===
 
-| x
-| "1986-11-18T06:04:45.123+0100"
-1+d|Rows: 1
+| EU            | US
+| "11/18/1986" | "18/11/1986"
+2+d|Rows: 1
 
 |===