Skip to content
Merged
Show file tree
Hide file tree
Changes from 27 commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
2d4b1c3
WiP format function
rsill-neo4j Aug 27, 2025
03a8731
general structure, additions page entry, references
rsill-neo4j Aug 28, 2025
efeca11
examples for instance types
rsill-neo4j Aug 28, 2025
b594c52
added a block title
rsill-neo4j Aug 28, 2025
81a5bf5
examples for duration types
rsill-neo4j Aug 28, 2025
b9ad57a
clarification for duration conversions
rsill-neo4j Aug 29, 2025
2cbca9a
nicer considerations block
rsill-neo4j Sep 2, 2025
f1f9c6c
nicer character table for durations
rsill-neo4j Sep 2, 2025
17cc934
Merge branch 'dev' into document-format-function
rsill-neo4j Sep 2, 2025
b760987
reduced number of examples, reduced 'considerations' list, moved char…
rsill-neo4j Sep 3, 2025
64a517c
Merge branch 'dev' into document-format-function
rsill-neo4j Sep 3, 2025
935e5a7
improved examples
rsill-neo4j Sep 3, 2025
aa5a14c
review suggestions
rsill-neo4j Sep 4, 2025
dff9453
review suggestion
rsill-neo4j Sep 5, 2025
93e85bc
Update modules/ROOT/pages/functions/temporal/format.adoc
rsill-neo4j Sep 8, 2025
7b99147
review suggestions
rsill-neo4j Sep 8, 2025
ef697e4
Apply suggestions from code review
rsill-neo4j Sep 10, 2025
b7d6eb2
review suggestions
rsill-neo4j Sep 10, 2025
a8085ce
Merge branch 'dev' into document-format-function
rsill-neo4j Sep 10, 2025
bb499cd
replaced the additions page example query
rsill-neo4j Sep 10, 2025
34579f2
syntax fix
rsill-neo4j Sep 10, 2025
118abe6
Apply suggestions from code review
rsill-neo4j Sep 11, 2025
e4bc6f8
review suggestions
rsill-neo4j Sep 11, 2025
e9b8b32
removed labels from a test section
rsill-neo4j Sep 11, 2025
66ea4d7
Apply suggestions from code review
rsill-neo4j Sep 11, 2025
2d9bea5
EU <-> US examples
rsill-neo4j Sep 12, 2025
eda89a5
added cheat sheet tags
rsill-neo4j Sep 12, 2025
4abf925
Apply suggestions from code review
rsill-neo4j Sep 12, 2025
8389c85
Merge branch 'dev' into document-format-function
rsill-neo4j Sep 16, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions modules/ROOT/content-nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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[]

Expand Down
14 changes: 14 additions & 0 deletions modules/ROOT/pages/appendix/gql-conformance/additional-cypher.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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[]
Expand All @@ -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]]
Expand Down
17 changes: 17 additions & 0 deletions modules/ROOT/pages/functions/index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
Loading