From 94999864c68d4bccc49320e75aaa79ec93a5a0ee Mon Sep 17 00:00:00 2001 From: Richard Sill Date: Tue, 16 Dec 2025 11:00:30 +0100 Subject: [PATCH] added info about cypher being more lenient than iso 8601 in some cases --- modules/ROOT/pages/functions/temporal/format.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/functions/temporal/format.adoc b/modules/ROOT/pages/functions/temporal/format.adoc index fe501ef6f..dcae86b3d 100644 --- a/modules/ROOT/pages/functions/temporal/format.adoc +++ b/modules/ROOT/pages/functions/temporal/format.adoc @@ -16,7 +16,7 @@ The `format()` function creates dynamically formatted string representations of | *Description* 3+| Returns the temporal value as an ISO-formatted `STRING` or as a `STRING` formatted by the provided pattern. .3+| *Arguments* | *Name* | *Type* | *Description* | `value` | `DATE \| LOCAL TIME \| ZONED TIME \| LOCAL DATETIME \| ZONED DATETIME \| DURATION` | A temporal value to be formatted. - | `pattern` | `STRING` | A pattern used to format the temporal value. If the pattern is not provided the value will be formatted according to ISO 8601. + | `pattern` | `STRING` | A pattern used to format the temporal value. If the pattern is not provided the value is in most cases formatted according to ISO 8601. | *Returns* 3+| `STRING` |=== @@ -24,7 +24,7 @@ The `format()` function creates dynamically formatted string representations of |=== | The output format can be customized via the `pattern` parameter. | 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]. -| If no pattern is specified, the function returns an ISO-formatted string. +| If no pattern is specified, the function returns an ISO-formatted string with some exceptions where the Cypher implementation is more lenient than ISO 8601, for instance when using seconds in a timezone. | Most characters yield a different output when they are repeated. | Some characters cannot be applied to certain types, for instance, `u` cannot be used to construct a string for a `LOCAL TIME` because it represents a year which is not part of the temporal value. | Any character that is not reserved, other than `[`, `]`, `{`, `}`, `#`, and `'`, are output directly. To ensure future compatibility it is recommended to wrap all characters that you want to output directly with single quotes.