From 2459d24e7e32e917bbb73a90feb0daafb30f0518 Mon Sep 17 00:00:00 2001 From: Gemma Lamont Date: Thu, 20 Feb 2025 14:19:34 +0100 Subject: [PATCH 1/3] New hyperbolic trig functions --- ...ions-additions-removals-compatibility.adoc | 10 + modules/ROOT/pages/functions/index.adoc | 16 ++ .../functions/mathematical-trigonometric.adoc | 188 ++++++++++++++++++ 3 files changed, 214 insertions(+) diff --git a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc index 643780166..7763685f4 100644 --- a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc +++ b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc @@ -203,6 +203,16 @@ CREATE DATABASE db OPTIONS { seedRestoreUntil: ... } | The option `seedRestoreUntil` can now be specified in the `CREATE DATABASE` `OPTIONS` map. This allows a database to be seeded up to a specific date or transaction ID. For more information, see link:{neo4j-docs-base-uri}/operations-manual/current/clustering/databases/#cluster-seed-uri[Operations Manual -> Clustering -> Seed from URI]. + +a| +label:functionality[] +label:new[] +[source, cypher, role="noheader"] +---- +RETURN cosh(0.5), coth(0.5), sinh(0.5), tanh(0.5) +---- +| Introduction of 4 new hyperbolic trigonometric Cypher functions. +For more information, see xref:functions/mathematical-trigonometric.adoc[Mathematical functions - trigonometric]. |=== [[cypher-deprecations-additions-removals-2025.01]] diff --git a/modules/ROOT/pages/functions/index.adoc b/modules/ROOT/pages/functions/index.adoc index b445ec420..63a41a7c5 100644 --- a/modules/ROOT/pages/functions/index.adoc +++ b/modules/ROOT/pages/functions/index.adoc @@ -310,10 +310,18 @@ All trigonometric functions operate on radians, unless otherwise specified. | `cos(input :: FLOAT) :: FLOAT` | Returns the cosine of a `FLOAT`. +1.1+| xref::functions/mathematical-trigonometric.adoc#functions-cosh[`cosh()`] label:new[Introduced in 2025.03] + +| `cosh(input :: FLOAT) :: FLOAT` +| Returns the hyperbolic cosine of a `FLOAT`. + 1.1+| xref::functions/mathematical-trigonometric.adoc#functions-cot[`cot()`] | `cot(input :: FLOAT) :: FLOAT` | Returns the cotangent of a `FLOAT`. +1.1+| xref::functions/mathematical-trigonometric.adoc#functions-coth[`coth()`] label:new[Introduced in 2025.03] + +| `coth(input :: FLOAT) :: FLOAT` +| Returns the hyperbolic cotangent of a `FLOAT`. + 1.1+| xref::functions/mathematical-trigonometric.adoc#functions-degrees[`degrees()`] | `degrees(input :: FLOAT) :: FLOAT` | Converts radians to degrees. @@ -334,10 +342,18 @@ All trigonometric functions operate on radians, unless otherwise specified. | `sin(input :: FLOAT) :: FLOAT` | Returns the sine of a `FLOAT`. +1.1+| xref::functions/mathematical-trigonometric.adoc#functions-sinh[`sinh()`] label:new[Introduced in 2025.03] + +| `sinh(input :: FLOAT) :: FLOAT` +| Returns the hyperbolic sine of a `FLOAT`. + 1.1+| xref::functions/mathematical-trigonometric.adoc#functions-tan[`tan()`] | `tan(input :: FLOAT) :: FLOAT` | Returns the tangent of a `FLOAT`. +1.1+| xref::functions/mathematical-trigonometric.adoc#functions-tanh[`tanh()`] label:new[Introduced in 2025.03] + +| `tanh(input :: FLOAT) :: FLOAT` +| Returns the hyperbolic tangent of a `FLOAT`. + |=== diff --git a/modules/ROOT/pages/functions/mathematical-trigonometric.adoc b/modules/ROOT/pages/functions/mathematical-trigonometric.adoc index d98ab2db5..a4c3aaf86 100644 --- a/modules/ROOT/pages/functions/mathematical-trigonometric.adoc +++ b/modules/ROOT/pages/functions/mathematical-trigonometric.adoc @@ -234,6 +234,52 @@ The cosine of `0.5` is returned. ====== +[role=label--new-2025.03] +[[functions-cosh]] +== cosh() + +.Details +|=== +| *Syntax* 3+| `cosh(input)` +| *Description* 3+| Returns the hyperbolic cosine of a `FLOAT`. +.2+| *Arguments* | *Name* | *Type* | *Description* +| `input` | `FLOAT` | A value. +| *Returns* 3+| `FLOAT` +|=== + +.Considerations +|=== + +| `cosh(null)` returns `null`. + +|=== + + +.+cosh()+ +====== + +.Query +// tag::functions_mathematical_trigonometric_cos[] +[source, cypher, indent=0] +---- +RETURN cosh(0.7) +---- +// end::functions_mathematical_trigonometric_cos[] + +The hyperbolic cosine of `0.7` is returned. + +.Result +[role="queryresult",options="header,footer",cols="1* Date: Tue, 4 Mar 2025 09:30:13 +0100 Subject: [PATCH 2/3] editorial and gql addition --- .../ROOT/pages/appendix/gql-conformance/index.adoc | 4 ++-- .../appendix/gql-conformance/supported-optional.adoc | 2 +- ...eprecations-additions-removals-compatibility.adoc | 2 +- modules/ROOT/pages/functions/index.adoc | 12 ++++++++---- 4 files changed, 12 insertions(+), 8 deletions(-) diff --git a/modules/ROOT/pages/appendix/gql-conformance/index.adoc b/modules/ROOT/pages/appendix/gql-conformance/index.adoc index 438f89042..315c6ee40 100644 --- a/modules/ROOT/pages/appendix/gql-conformance/index.adoc +++ b/modules/ROOT/pages/appendix/gql-conformance/index.adoc @@ -1,8 +1,8 @@ :description: Overview of Cypher's conformance to GQL. = GQL conformance -*Last updated*: 24 October 2024 + -*Neo4j version*: 5.25 +*Last updated*: 4 March 2025 + +*Neo4j version*: 2025.03 GQL is the new link:https://www.iso.org/home.html[ISO] International Standard query language for graph databases. diff --git a/modules/ROOT/pages/appendix/gql-conformance/supported-optional.adoc b/modules/ROOT/pages/appendix/gql-conformance/supported-optional.adoc index 2e8c0778d..6464298e5 100644 --- a/modules/ROOT/pages/appendix/gql-conformance/supported-optional.adoc +++ b/modules/ROOT/pages/appendix/gql-conformance/supported-optional.adoc @@ -119,7 +119,7 @@ Cypher only supports xref:functions/mathematical-numeric.adoc#functions-ceil[`ce | GF02 | Trigonometric functions -| xref:functions/mathematical-trigonometric.adoc#functions-acos[`acos()`], xref:functions/mathematical-trigonometric.adoc#functions-asin[`asin()`], xref:functions/mathematical-trigonometric.adoc#functions-atan[`atan()`], xref:functions/mathematical-trigonometric.adoc#functions-cos[`cos()`], xref:functions/mathematical-trigonometric.adoc#functions-cot[`cot()`], xref:functions/mathematical-trigonometric.adoc#functions-degrees[`degrees()`], xref:functions/mathematical-trigonometric.adoc#functions-radians[`radians()`], xref:functions/mathematical-trigonometric.adoc#functions-tan[`tan()`] +| xref:functions/mathematical-trigonometric.adoc#functions-acos[`acos()`], xref:functions/mathematical-trigonometric.adoc#functions-asin[`asin()`], xref:functions/mathematical-trigonometric.adoc#functions-atan[`atan()`], xref:functions/mathematical-trigonometric.adoc#functions-cos[`cos()`], xref::functions/mathematical-trigonometric.adoc#functions-cosh[`cosh()`], xref:functions/mathematical-trigonometric.adoc#functions-cot[`cot()`], xref::functions/mathematical-trigonometric.adoc#functions-coth[`coth()`], xref:functions/mathematical-trigonometric.adoc#functions-degrees[`degrees()`], xref:functions/mathematical-trigonometric.adoc#functions-radians[`radians()`], xref::functions/mathematical-trigonometric.adoc#functions-sin[`sin()`], xref::functions/mathematical-trigonometric.adoc#functions-sinh[`sinh()`], xref:functions/mathematical-trigonometric.adoc#functions-tan[`tan()`], xref::functions/mathematical-trigonometric.adoc#functions-tanh[`tanh()`] | | GF03 diff --git a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc index 7763685f4..be9a73367 100644 --- a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc +++ b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc @@ -211,7 +211,7 @@ label:new[] ---- RETURN cosh(0.5), coth(0.5), sinh(0.5), tanh(0.5) ---- -| Introduction of 4 new hyperbolic trigonometric Cypher functions. +| Introduction of four new hyperbolic trigonometric Cypher functions. For more information, see xref:functions/mathematical-trigonometric.adoc[Mathematical functions - trigonometric]. |=== diff --git a/modules/ROOT/pages/functions/index.adoc b/modules/ROOT/pages/functions/index.adoc index 63a41a7c5..fd4b6e41d 100644 --- a/modules/ROOT/pages/functions/index.adoc +++ b/modules/ROOT/pages/functions/index.adoc @@ -310,17 +310,19 @@ All trigonometric functions operate on radians, unless otherwise specified. | `cos(input :: FLOAT) :: FLOAT` | Returns the cosine of a `FLOAT`. -1.1+| xref::functions/mathematical-trigonometric.adoc#functions-cosh[`cosh()`] label:new[Introduced in 2025.03] + +1.1+| xref::functions/mathematical-trigonometric.adoc#functions-cosh[`cosh()`] | `cosh(input :: FLOAT) :: FLOAT` | Returns the hyperbolic cosine of a `FLOAT`. +label:new[Introduced in 2025.03] 1.1+| xref::functions/mathematical-trigonometric.adoc#functions-cot[`cot()`] | `cot(input :: FLOAT) :: FLOAT` | Returns the cotangent of a `FLOAT`. -1.1+| xref::functions/mathematical-trigonometric.adoc#functions-coth[`coth()`] label:new[Introduced in 2025.03] + +1.1+| xref::functions/mathematical-trigonometric.adoc#functions-coth[`coth()`] | `coth(input :: FLOAT) :: FLOAT` | Returns the hyperbolic cotangent of a `FLOAT`. +label:new[Introduced in 2025.03] 1.1+| xref::functions/mathematical-trigonometric.adoc#functions-degrees[`degrees()`] | `degrees(input :: FLOAT) :: FLOAT` @@ -342,17 +344,19 @@ All trigonometric functions operate on radians, unless otherwise specified. | `sin(input :: FLOAT) :: FLOAT` | Returns the sine of a `FLOAT`. -1.1+| xref::functions/mathematical-trigonometric.adoc#functions-sinh[`sinh()`] label:new[Introduced in 2025.03] + +1.1+| xref::functions/mathematical-trigonometric.adoc#functions-sinh[`sinh()`] | `sinh(input :: FLOAT) :: FLOAT` | Returns the hyperbolic sine of a `FLOAT`. + label:new[Introduced in 2025.03] 1.1+| xref::functions/mathematical-trigonometric.adoc#functions-tan[`tan()`] | `tan(input :: FLOAT) :: FLOAT` | Returns the tangent of a `FLOAT`. -1.1+| xref::functions/mathematical-trigonometric.adoc#functions-tanh[`tanh()`] label:new[Introduced in 2025.03] + +1.1+| xref::functions/mathematical-trigonometric.adoc#functions-tanh[`tanh()`] | `tanh(input :: FLOAT) :: FLOAT` | Returns the hyperbolic tangent of a `FLOAT`. +label:new[Introduced in 2025.03] |=== From d6f1dbbacd7f7b2afca26b65b448f0ba55c17b0f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jens=20Pryce-=C3=85klundh?= <112686610+JPryce-Aklundh@users.noreply.github.com> Date: Tue, 4 Mar 2025 09:32:34 +0100 Subject: [PATCH 3/3] remove coth from gql conformance --- .../ROOT/pages/appendix/gql-conformance/supported-optional.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/appendix/gql-conformance/supported-optional.adoc b/modules/ROOT/pages/appendix/gql-conformance/supported-optional.adoc index bea9da9b5..164229a74 100644 --- a/modules/ROOT/pages/appendix/gql-conformance/supported-optional.adoc +++ b/modules/ROOT/pages/appendix/gql-conformance/supported-optional.adoc @@ -119,7 +119,7 @@ Cypher only supports xref:functions/mathematical-numeric.adoc#functions-ceil[`ce | GF02 | Trigonometric functions -| xref:functions/mathematical-trigonometric.adoc#functions-acos[`acos()`], xref:functions/mathematical-trigonometric.adoc#functions-asin[`asin()`], xref:functions/mathematical-trigonometric.adoc#functions-atan[`atan()`], xref:functions/mathematical-trigonometric.adoc#functions-cos[`cos()`], xref::functions/mathematical-trigonometric.adoc#functions-cosh[`cosh()`], xref:functions/mathematical-trigonometric.adoc#functions-cot[`cot()`], xref::functions/mathematical-trigonometric.adoc#functions-coth[`coth()`], xref:functions/mathematical-trigonometric.adoc#functions-degrees[`degrees()`], xref:functions/mathematical-trigonometric.adoc#functions-radians[`radians()`], xref::functions/mathematical-trigonometric.adoc#functions-sin[`sin()`], xref::functions/mathematical-trigonometric.adoc#functions-sinh[`sinh()`], xref:functions/mathematical-trigonometric.adoc#functions-tan[`tan()`], xref::functions/mathematical-trigonometric.adoc#functions-tanh[`tanh()`] +| xref:functions/mathematical-trigonometric.adoc#functions-acos[`acos()`], xref:functions/mathematical-trigonometric.adoc#functions-asin[`asin()`], xref:functions/mathematical-trigonometric.adoc#functions-atan[`atan()`], xref:functions/mathematical-trigonometric.adoc#functions-cos[`cos()`], xref::functions/mathematical-trigonometric.adoc#functions-cosh[`cosh()`], xref:functions/mathematical-trigonometric.adoc#functions-cot[`cot()`], xref:functions/mathematical-trigonometric.adoc#functions-degrees[`degrees()`], xref:functions/mathematical-trigonometric.adoc#functions-radians[`radians()`], xref::functions/mathematical-trigonometric.adoc#functions-sin[`sin()`], xref::functions/mathematical-trigonometric.adoc#functions-sinh[`sinh()`], xref:functions/mathematical-trigonometric.adoc#functions-tan[`tan()`], xref::functions/mathematical-trigonometric.adoc#functions-tanh[`tanh()`] | | GF03