三角函数

三角数学函数仅对数字表达式有效，如果用于任何其他类型的值，将返回错误。另请参阅 数学运算符。

acos()

详细信息

语法

acos(input)

描述

返回 FLOAT（浮点数）的弧度反余弦值。

参数

名称

类型

描述

input

FLOAT

以弧度为单位的角度。

返回

FLOAT
注意事项

acos(null) 返回 null。

如果 (input < -1) 或 (input > 1)，则 (acos(input)) 返回 NaN。
示例 1. acos()
查询
RETURN acos(0.5)

返回 0.5 的反余弦值。

结果
acos(0.5)

1.0471975511965979

行：1

asin()

详细信息

语法

asin(input)

描述

返回 FLOAT（浮点数）的弧度反正弦值。

参数

名称

类型

描述

input

FLOAT

以弧度为单位的角度。

返回

FLOAT
注意事项

asin(null) 返回 null。

如果 (input < -1) 或 (input > 1)，则 (asin(input)) 返回 NaN。
示例 2. asin()
查询
RETURN asin(0.5)

返回 0.5 的反正弦值。

结果
asin(0.5)

0.5235987755982989

行：1

atan()

详细信息

语法

atan(input)

描述

返回 FLOAT（浮点数）的弧度反正切值。

参数

名称

类型

描述

input

FLOAT

以弧度为单位的角度。

返回

FLOAT
注意事项

atan(null) 返回 null。
示例 3. atan()
查询
RETURN atan(0.5)

返回 0.5 的反正切值。

结果
atan(0.5)

0.4636476090008061

行：1

atan2()

详细信息

语法

atan2(y, x)

描述

返回以弧度表示的一组坐标的反正切值 (atan2)。

参数

名称

类型

描述

y

FLOAT

y 的弧度角。

x

FLOAT

x 的弧度角。

返回

FLOAT
注意事项

atan2(null, null)、atan2(null, x) 和 atan(y, null) 均返回 null。
示例 4. atan2()
查询
RETURN atan2(0.5, 0.6)

返回 0.5 和 0.6 的反正切值 2。

结果
atan2(0.5, 0.6)

0.6947382761967033

行：1

cos()

详细信息

语法

cos(input)

描述

返回 FLOAT（浮点数）的弧度余弦值。

参数

名称

类型

描述

input

FLOAT

以弧度为单位的角度。

返回

FLOAT
注意事项

cos(null) 返回 null。
示例 5. cos()
查询
RETURN cos(0.5)

返回 0.5 的余弦值。

结果
cos(0.5)

0.8775825618903728

行：1

cosh()
仅限 Cypher 25Neo4j 2025.06 引入

详细信息

语法

cosh(input)

描述

返回 FLOAT（浮点数）的双曲余弦值。

参数

名称

类型

描述

input

FLOAT

一个数值。

返回

FLOAT
注意事项

cosh(null) 返回 null。
示例 6. cosh()
查询
RETURN cosh(0.7)

返回 0.7 的双曲余弦值。

结果
cosh(0.7)

1.255169005630943

行：1

cot()

详细信息

语法

cot(input)

描述

返回 FLOAT（浮点数）的余切值。

参数

名称

类型

描述

input

FLOAT

以弧度为单位的角度。

返回

FLOAT
注意事项

cot(null) 返回 null。

cot(0) 返回 Infinity（无穷大）。
示例 7. cot()
查询
RETURN cot(0.5)

返回 0.5 的余切值。

结果
cot(0.5)

1.830487721712452

行：1

coth()
仅限 Cypher 25Neo4j 2025.06 引入

详细信息

语法

coth(input)

描述

返回 FLOAT（浮点数）的双曲余切值。

参数

名称

类型

描述

input

FLOAT

一个数值。

返回

FLOAT
注意事项

coth(null) 返回 null。

coth(0) 返回 NaN。

双曲余切 coth(x) 的计算通过 cosh(x) / sinh(x) 方法完成。
示例 8. coth()
查询
RETURN coth(0.7)

返回 0.7 的双曲余切值。

结果
coth(0.7)

1.6546216358026298

行：1

degrees()

详细信息

语法

degrees(input)

描述

将弧度转换为角度。

参数

名称

类型

描述

input

FLOAT

以弧度为单位的角度。

返回

FLOAT
注意事项

degrees(null) 返回 null。
示例 9. degrees
查询
RETURN degrees(3.14159)

返回接近 pi 的角度值。

结果
degrees(3.14159)

179.9998479605043

行：1

haversin()

详细信息

语法

haversin(input)

描述

返回一个数字的一半正矢值。

参数

名称

类型

描述

input

FLOAT

以弧度为单位的角度。

返回

FLOAT
注意事项

haversin(null) 返回 null。
示例 10. haversin()
查询
RETURN haversin(0.5)

返回 0.5 的半正矢值。

结果
haversin(0.5)

0.06120871905481362

行：1

使用 haversin() 函数计算球面距离

haversin() 函数可用于计算球面上两点（由各自的纬度和经度给出）之间的距离。

示例 11. haversin()

在此示例中，使用 6371 公里的地球平均半径，计算德国柏林（纬度 52.5，经度 13.4）与加利福尼亚州圣马特奥（纬度 37.5，经度 -122.3）之间的球面距离（单位：公里）。

查询
CREATE (ber:City {lat: 52.5, lon: 13.4}), (sm:City {lat: 37.5, lon: -122.3})
RETURN 2 * 6371 * asin(sqrt(haversin(radians( sm.lat - ber.lat ))
  + cos(radians( sm.lat )) * cos(radians( ber.lat )) *
  haversin(radians( sm.lon - ber.lon )))) AS dist

返回 'Berlin' 和 'San Mateo' 之间的估计距离。

结果
dist

9129.969740051658

行：1

pi()

详细信息

语法

pi()

描述

返回数学常数 pi。

返回

FLOAT
示例 12. pi()
查询
RETURN pi()

返回常量 pi。

结果
pi()

3.141592653589793

行：1

radians()

详细信息

语法

radians(input)

描述

将角度转换为弧度。

参数

名称

类型

描述

input

FLOAT

以角度为单位的角度值。

返回

FLOAT
注意事项

radians(null) 返回 null。
示例 13. radians()
查询
RETURN radians(180)

返回 180 度的弧度值（pi）。

结果
radians(180)

3.141592653589793

行：1

sin()

详细信息

语法

sin(input)

描述

返回 FLOAT（浮点数）的正弦值。

参数

名称

类型

描述

input

FLOAT

以弧度为单位的角度。

返回

FLOAT
注意事项

sin(null) 返回 null。
示例 14. sin()
查询
RETURN sin(0.5)

返回 0.5 的正弦值。

结果
sin(0.5)

0.479425538604203

行：1

sinh()
仅限 Cypher 25Neo4j 2025.06 引入

详细信息

语法

sinh(input)

描述

返回 FLOAT（浮点数）的双曲正弦值。

参数

名称

类型

描述

input

FLOAT

一个数值。

返回

FLOAT
注意事项

sinh(null) 返回 null。
示例 15. sinh()
查询
RETURN sinh(0.7)

返回 0.7 的双曲正弦值。

结果
sinh(0.7)

0.7585837018395334

行：1

tan()

详细信息

语法

tan(input)

描述

返回 FLOAT（浮点数）的正切值。

参数

名称

类型

描述

input

FLOAT

以弧度为单位的角度。

返回

FLOAT
注意事项

tan(null) 返回 null。
示例 16. tan()
查询
RETURN tan(0.5)

返回 0.5 的正切值。

结果
tan(0.5)

0.5463024898437905

行：1

tanh()
仅限 Cypher 25Neo4j 2025.06 引入

详细信息

语法

tanh(input)

描述

返回 FLOAT（浮点数）的双曲正切值。

参数

名称

类型

描述

input

FLOAT

一个数值。

返回

FLOAT
注意事项

tanh(null) 返回 null。
示例 17. tanh()
查询
RETURN tanh(0.7)

返回 0.7 的双曲正切值。

结果
tanh(0.7)

0.6043677771171636

行：1