三角函数

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