WiP

Author: rsill-neo4j

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

@@ -25,6 +25,26 @@ For more information, see xref:queries/select-version.adoc[].
 [[cypher-deprecations-additions-removals-2025.09]]
 == Neo4j 2025.09
 
+=== Updated in Cypher 25
+
+[cols="2", options="header"]
+|===
+| Feature
+| Details
+
+a|
+label:functionality[]
+label:updated[]
+[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
+----
+
+| Text.
+|===
+
+
 === New in Cypher 25
 
 [cols="2", options="header"]

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

@@ -16,10 +16,11 @@ See also xref::values-and-types/temporal.adoc[Temporal values] and xref::express
 
 .Details
 |===
-| *Syntax* 3+| `duration(input)`
+| *Syntax* 3+| `duration(input[, pattern])`
 | *Description* 3+| Creates a `DURATION` value.
-.2+| *Arguments* | *Name* | *Type* | *Description*
+.3+| *Arguments* | *Name* | *Type* | *Description*
 | `input` | `ANY` | A map optionally containing the following keys: 'years', 'months', 'weeks', 'days', 'hours', 'minutes', 'seconds', 'milliseconds', 'microseconds', or 'nanoseconds'.
+| `pattern` | `STRING` | A pattern used to parse the input. If a pattern is provided, `input` must be `STRING`.
 | *Returns* 3+| `DURATION`
 |===
 
@@ -128,6 +129,7 @@ RETURN aDuration
 | If `from` has a time component and `to` does not, the time component of `to` is assumed to be midnight, and vice versa.
 | If `from` has a time zone component and `to` does not, the time zone component of `to` is assumed to be the same as that of `from`, and vice versa.
 | If `to` has a date component and `from` does not, the date component of `from` is assumed to be the same as that of `to`, and vice versa.
+| The `pattern` parameter follows the link:https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/time/format/DateTimeFormatter.html[Java DateTimeFormatter].
 
 |===
 

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

@@ -332,26 +332,15 @@ The following table lists the supported truncation units and the corresponding s
 
 .Details
 |===
-| *Syntax* 3+| `date( [input] )`
+| *Syntax* 3+| `date([ input, pattern] )`
 | *Description* 3+| Creates a `DATE` instant.
-.2+| *Arguments* | *Name* | *Type* | *Description*
-| `input` | `ANY` | Either a string representation of a temporal value, a map containing the single key 'timezone', or a map containing temporal values ('date', 'year', 'month', 'day', 'week', 'dayOfWeek', 'quarter', 'dayOfQuarter', 'ordinalDay') as components.
-| *Returns* 3+| `DATE`
-|===
-
-
-
-.Details
-|===
-| *Syntax* 3+| `date( [input] )`
-| *Description* 3+| Creates a `DATE` instant.
-.2+| *Arguments* | *Name* | *Type* | *Description*
+.3+| *Arguments* | *Name* | *Type* | *Description*
 | `input` | `ANY` | Either a string representation of a temporal value, a map containing the single key 'timezone', or a map containing temporal values ('date', 'year', 'month', 'day', 'week', 'dayOfWeek', 'quarter', 'dayOfQuarter', 'ordinalDay') as components.
+| `pattern` | `STRING` | A pattern used to parse the input. If a pattern is provided, `input` must be `STRING`.
 | *Returns* 3+| `DATE`
 |===
 
 
-
 .Temporal components
 [options="header"]
 |===
@@ -406,6 +395,7 @@ The following table lists the supported truncation units and the corresponding s
 | `date(null)` returns `null`.
 | If any of the optional parameters are provided, these will override the corresponding components of `date`.
 | `date(dd)` may be written instead of `+date({date: dd})+`.
+| The `pattern` parameter follows the link:https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/time/format/DateTimeFormatter.html[Java DateTimeFormatter].
 
 |===
 
@@ -854,10 +844,11 @@ RETURN
 
 .Details
 |===
-| *Syntax* 3+| `datetime([ input ])`
+| *Syntax* 3+| `datetime([ input, pattern ])`
 | *Description* 3+| Creates a `ZONED DATETIME` instant.
-.2+| *Arguments* | *Name* | *Type* | *Description*
+.3+| *Arguments* | *Name* | *Type* | *Description*
 | `input` | `ANY` | Either a string representation of a temporal value, a map containing the single key 'timezone', or a map containing temporal values ('year', 'month', 'day', 'hour', 'minute', 'second', 'millisecond', 'microsecond', 'nanosecond', 'timezone') as components.
+| `pattern` | `STRING` | A pattern used to parse the input. If a pattern is provided, `input` must be `STRING`.
 | *Returns* 3+| `ZONED DATETIME`
 |===
 
@@ -927,6 +918,7 @@ RETURN
 | Selecting a `ZONED DATETIME` or `ZONED TIME` as the `time` component and overwriting the timezone will adjust the local time to keep the same point in time.
 | `epochSeconds`/`epochMillis` may be used in conjunction with `nanosecond`.
 | `datetime(null)` returns null.
+| The `pattern` parameter follows the link:https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/time/format/DateTimeFormatter.html[Java DateTimeFormatter].
 
 |===
 
@@ -1612,10 +1604,11 @@ RETURN
 
 .Details
 |===
-| *Syntax* 3+| `localdatetime([ input ])`
+| *Syntax* 3+| `localdatetime([ input, pattern ])`
 | *Description* 3+| Creates a `LOCAL DATETIME` instant.
-.2+| *Arguments* | *Name* | *Type* | *Description*
+.3+| *Arguments* | *Name* | *Type* | *Description*
 | `input` | `ANY` | Either a string representation of a temporal value, a map containing the single key 'timezone', or a map containing temporal values ('year', 'month', 'day', 'hour', 'minute', 'second', 'millisecond', 'microsecond', 'nanosecond') as components.
+| `pattern` | `STRING` | A pattern used to parse the input. If a pattern is provided, `input` must be `STRING`.
 | *Returns* 3+| `LOCAL DATETIME`
 |===
 
@@ -1674,6 +1667,7 @@ RETURN
 | `localdatetime(null)` returns null.
 | If any of the optional parameters are provided, these will override the corresponding components of `datetime`, `date` and/or `time`.
 | `localdatetime(dd)` may be written instead of `+localdatetime({datetime: dd})+`.
+| The `pattern` parameter follows the link:https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/time/format/DateTimeFormatter.html[Java DateTimeFormatter].
 
 |===
 
@@ -2192,10 +2186,11 @@ RETURN
 
 .Details
 |===
-| *Syntax* 3+| `localtime([ input ])`
+| *Syntax* 3+| `localtime([ input, pattern ])`
 | *Description* 3+| Creates a `LOCAL TIME` instant.
-.2+| *Arguments* | *Name* | *Type* | *Description*
+.3+| *Arguments* | *Name* | *Type* | *Description*
 | `input` | `ANY` | Either a string representation of a temporal value, a map containing the single key 'timezone', or a map containing temporal values ('hour, 'minute', 'second', 'millisecond', 'microsecond', 'nanosecond' as components.
+| `pattern` | `STRING` | A pattern used to parse the input. If a pattern is provided, `input` must be `STRING`.
 | *Returns* 3+| `LOCAL TIME`
 |===
 
@@ -2240,6 +2235,7 @@ RETURN
 | `localtime(null)` returns null.
 | If any of the optional parameters are provided, these will override the corresponding components of `time`.
 | `localtime(tt)` may be written instead of `localtime({time: tt})`.
+| The `pattern` parameter follows the link:https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/time/format/DateTimeFormatter.html[Java DateTimeFormatter].
 
 |===
 
@@ -2587,10 +2583,11 @@ RETURN
 
 .Details
 |===
-| *Syntax* 3+| `time([ input ])`
+| *Syntax* 3+| `time([ input, pattern ])`
 | *Description* 3+| Creates a `ZONED TIME` instant.
-.2+| *Arguments* | *Name* | *Type* | *Description*
+.3+| *Arguments* | *Name* | *Type* | *Description*
 | `input` | `ANY` | Either a string representation of a temporal value, a map containing the single key 'timezone', or a map containing temporal values ('hour', 'minute', 'second', 'millisecond', 'microsecond', 'nanosecond', 'timezone') as components.
+| `pattern` | `STRING` | A pattern used to parse the input. If a pattern is provided, `input` must be `STRING`.
 | *Returns* 3+| `ZONED TIME`
 |===
 
@@ -2642,6 +2639,7 @@ RETURN
 | `time(tt)` may be written instead of `+time({time: tt})+`.
 | Selecting a `ZONED TIME` or `ZONED DATETIME` value as the `time` component also selects its timezone. If a `LOCAL TIME` or `LOCAL DATETIME` is selected instead, the default timezone is used. In any case, the timezone can be overridden explicitly.
 | Selecting a `ZONED DATETIME` or `ZONED TIME` as the `time` component and overwriting the timezone will adjust the local time to keep the same point in time.
+| The `pattern` parameter follows the link:https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/time/format/DateTimeFormatter.html[Java DateTimeFormatter].
 
 |===