Document format function (#1374)

Co-authored-by: Gem Lamont <[email protected]>
Co-authored-by: Jens Pryce-Åklundh <[email protected]>

Author: 3 people

modules/ROOT/content-nav.adoc

@@ -100,6 +100,7 @@
 ** xref:functions/string.adoc[]
 ** xref:functions/temporal/duration.adoc[]
 ** xref:functions/temporal/index.adoc[]
+** xref:functions/temporal/format.adoc[]
 ** xref:functions/user-defined.adoc[]
 ** xref:functions/vector.adoc[]
 

modules/ROOT/pages/appendix/gql-conformance/additional-cypher.adoc

@@ -542,6 +542,20 @@ If the points are in a Cartesian CRS, the function returns the Euclidean distanc
 |===
 
 
+[[temporal-format-functions]]
+=== Temporal format functions
+
+[options="header", cols="2a,5a"]
+|===
+| Cypher feature
+| Description
+
+| xref:functions/temporal/format.adoc[`format()`]
+| Returns the temporal value as an ISO-formatted `STRING` or as a `STRING` formatted by the provided pattern.
+
+|===
+
+
 [[vector-functions]]
 === Vector functions
 

modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc

@@ -32,6 +32,17 @@ For more information, see xref:queries/select-version.adoc[].
 | Feature
 | Details
 
+a|
+label:functionality[]
+label:new[]
+[source, cypher, role="noheader"]
+----
+WITH datetime('1986-11-18T6:04:45.123456789+01:00[Europe/Berlin]') AS dt
+RETURN format(dt, "MM/dd/yyyy") AS US, format(dt, "dd/MM/yyyy") AS EU
+----
+
+| Cypher's new xref:functions/temporal/format.adoc[`format()`] function can create dynamically formatted string representations of temporal instance and duration types.
+
 a| 
 label:functionality[]
 label:new[]
@@ -40,6 +51,7 @@ New operator: `LockNodes`
 
 
 a| Introduced xref::planning-and-tuning/operators/operators-detail.adoc#query-plan-lock-nodes[`LockNodes`] operator, sometimes used in conjunction with the `LockingMerge` operator to lock nodes.
+
 |===
 
 [[cypher-deprecations-additions-removals-2025.08]]

modules/ROOT/pages/functions/index.adoc

@@ -764,6 +764,23 @@ Values of the xref::values-and-types/temporal.adoc[temporal types] -- `DATE`, `Z
 |===
 
 
+[role=label--cypher-25-only label--new-Neo4j-2025.09]
+[[header-query-functions-temporal-format]]
+== Temporal format functions
+
+These functions format temporal instance and duration values:
+
+[options="header"]
+|===
+| Function | Signature | Description
+
+1.1+| xref::functions/temporal/format.adoc#query-functions-temporal-format-function[`format()`]
+| `format(value :: DATE \| LOCAL TIME \| ZONED TIME \| LOCAL DATETIME \| ZONED DATETIME \| DURATION[, pattern :: STRING]) :: STRING`
+| Returns the temporal value as an ISO-formatted `STRING` or as a `STRING` formatted by the provided pattern.
+
+|===
+
+
 [[header-query-functions-user-defined]]
 == User-defined functions