小巧。快速。可靠。
三选其二。
内置数学 SQL 函数

1. 概述

下面显示的数学函数是标量函数的一个子集,这些函数内置于SQLite 融合源文件中,但只有在使用-DSQLITE_ENABLE_MATH_FUNCTIONS编译时选项编译融合文件时才会激活。

数学函数的参数可以是整数、浮点数或看起来像整数或实数的字符串或 Blob。如果任何参数为 NULL 或是一个无法轻松转换为数字的字符串或 Blob,则函数将返回 NULL。这些函数对于域错误也会返回 NULL,例如尝试对负数求平方根,或计算大于 1.0 或小于 -1.0 的值的 arccosine。

这些函数返回的值通常是近似值。例如,pi() 函数返回 3.141592653589793115997963468544185161590576171875,它比实际值小约 1.22465e-16,但它是 IEEE754 双精度数所能提供的最接近的近似值。

2. 内置标量 SQL 数学函数说明

acos(X)

返回 X 的反余弦。结果以弧度表示。

acosh(X)

返回 X 的双曲反余弦。

asin(X)

返回 X 的反正弦。结果以弧度表示。

asinh(X)

返回 X 的双曲反正弦。

atan(X)

返回 X 的反正切。结果以弧度表示。

atan2(Y,X)

返回 Y/X 的反正切。结果以弧度表示。结果将根据 X 和 Y 的符号放置到正确的象限。

atanh(X)

返回 X 的双曲反正切。

ceil(X)
ceiling(X)

返回大于或等于 X 的第一个可表示整数。对于 X 的正值,此例程远离零舍入。对于 X 的负值,此例程向零舍入。

cos(X)

返回 X 的余弦。X 以弧度表示。

cosh(X)

返回 X 的双曲余弦。

degrees(X)

将值 X 从弧度转换为度。

exp(X)

计算e(欧拉数,大约为 2.71828182845905)的 X 次幂。

floor(X)

返回小于或等于 X 的第一个可表示整数。对于正数,此函数向零舍入。对于负数,此函数远离零舍入。

ln(X)

返回 X 的自然对数。

log(X)
log10(X)
log(B,X)

返回 X 的以 10 为底的对数。或者,对于两个参数版本,返回 X 的以 B 为底的对数。

兼容性说明:SQLite 与 PostgreSQL 类似,其中 log() 函数计算以 10 为底的对数。大多数其他 SQL 数据库引擎为 log() 计算自然对数。在 log(B,X) 的两个参数版本中,第一个参数是底数,第二个参数是操作数。这与 PostgreSQL 和 MySQL 相同,但与 SQL Server 相反,SQL Server 使用第二个参数作为底数,第一个参数作为操作数。

log2(X)

返回数字 X 的以 2 为底的对数。

mod(X,Y)

返回 X 除以 Y 后的余数。这类似于 '%' 运算符,但它适用于非整数参数。

pi()

返回 π 的近似值。

pow(X,Y)
power(X,Y)

计算 X 的 Y 次幂。

radians(X)

将 X 从度转换为弧度。

sin(X)

返回 X 的正弦。X 以弧度表示。

sinh(X)

返回 X 的双曲正弦。

sqrt(X)

返回 X 的平方根。如果 X 为负,则返回 NULL。

tan(X)

返回 X 的正切。X 以弧度表示。

tanh(X)

返回 X 的双曲正切。

trunc(X)

返回介于 X 和 0(包含)之间且距离零最远的可表示整数。或者,换句话说,返回 X 的整数部分,向零舍入。trunc() 函数类似于ceiling(X)floor(X),但它始终向零舍入,而 ceiling(X) 和 floor(X) 分别向上和向下舍入。

此页面上次修改于 2023-12-05 14:43:20 UTC