内置函数
#
Easysearch SQL 提供 80 多个内置函数，涵盖数学运算、字符串处理、日期时间、条件判断和类型转换等类别。
数学函数
#
| 函数 | 说明 | 示例 |
|---|
ABS(expr) | 绝对值 | ABS(-5) → 5 |
CEIL(expr) / CEILING(expr) | 向上取整 | CEIL(2.3) → 3 |
FLOOR(expr) | 向下取整 | FLOOR(2.7) → 2 |
ROUND(expr [, d]) | 四舍五入到 d 位小数 | ROUND(3.1415, 2) → 3.14 |
TRUNCATE(expr, d) | 截断到 d 位小数 | TRUNCATE(3.1415, 2) → 3.14 |
SQRT(expr) | 平方根 | SQRT(16) → 4.0 |
CBRT(expr) | 立方根 | CBRT(27) → 3.0 |
POWER(base, exp) / POW(base, exp) | 幂运算 | POWER(2, 10) → 1024 |
EXP(expr) | e 的 expr 次幂 | EXP(1) → 2.7183 |
LN(expr) | 自然对数 | LN(E()) → 1.0 |
LOG(expr) | 自然对数（同 LN） | LOG(10) → 2.3026 |
LOG2(expr) | 以 2 为底的对数 | LOG2(8) → 3.0 |
LOG10(expr) | 以 10 为底的对数 | LOG10(100) → 2.0 |
MOD(a, b) / MODULUS(a, b) | 取模 | MOD(10, 3) → 1 |
SIGN(expr) | 符号（-1/0/1） | SIGN(-5) → -1 |
PI() | 圆周率 π | PI() → 3.14159 |
E() | 自然常数 e | E() → 2.71828 |
RAND() / RANDOM() | [0, 1) 随机数 | RAND() → 0.7523 |
CONV(expr, from_base, to_base) | 进制转换 | CONV('a', 16, 10) → '10' |
CRC32(expr) | CRC32 校验和 | CRC32('easysearch') |
三角函数
#
| 函数 | 说明 |
|---|
ACOS(expr) | 反余弦 |
ASIN(expr) | 反正弦 |
ATAN(expr) | 反正切 |
ATAN2(y, x) | 两参数反正切 |
COS(expr) | 余弦 |
COT(expr) | 余切 |
SIN(expr) | 正弦 |
TAN(expr) | 正切 |
DEGREES(expr) | 弧度转角度 |
RADIANS(expr) | 角度转弧度 |
示例
#
SELECT ABS(balance - 10000) AS diff,
ROUND(balance / 1000.0, 1) AS balance_k,
SQRT(age) AS sqrt_age
FROM accounts
字符串函数
#
| 函数 | 说明 | 示例 |
|---|
LENGTH(str) | 字符串长度 | LENGTH('hello') → 5 |
UPPER(str) | 转大写 | UPPER('hello') → 'HELLO' |
LOWER(str) | 转小写 | LOWER('HELLO') → 'hello' |
SUBSTRING(str, pos [, len]) / SUBSTR(str, pos [, len]) | 截取子串（pos 从 1 开始） | SUBSTRING('hello', 2, 3) → 'ell' |
TRIM(str) | 去除首尾空白 | TRIM(' hi ') → 'hi' |
LTRIM(str) | 去除左侧空白 | LTRIM(' hi') → 'hi' |
RTRIM(str) | 去除右侧空白 | RTRIM('hi ') → 'hi' |
CONCAT(str1, str2, ...) | 连接字符串 | CONCAT('a', 'b', 'c') → 'abc' |
CONCAT_WS(sep, str1, str2, ...) | 用分隔符连接 | CONCAT_WS('-', 'a', 'b') → 'a-b' |
REPLACE(str, from, to) | 替换子串 | REPLACE('hello', 'l', 'r') → 'herro' |
LOCATE(substr, str [, pos]) | 查找子串位置（从 1 开始） | LOCATE('ll', 'hello') → 3 |
LEFT(str, len) | 从左取 len 个字符 | LEFT('hello', 2) → 'he' |
RIGHT(str, len) | 从右取 len 个字符 | RIGHT('hello', 2) → 'lo' |
ASCII(str) | 首字符的 ASCII 码 | ASCII('A') → 65 |
REVERSE(str) | 反转字符串 | REVERSE('hello') → 'olleh' |
示例
#
SELECT UPPER(firstname) AS name,
LENGTH(address) AS addr_len,
SUBSTRING(city, 1, 3) AS city_prefix
FROM accounts
WHERE LENGTH(lastname) > 4
日期时间函数
#
构造函数
#
| 函数 | 说明 | 示例 |
|---|
DATE(expr) | 提取日期部分 | DATE('2025-01-15 10:30:00') → '2025-01-15' |
TIME(expr) | 提取时间部分 | TIME('2025-01-15 10:30:00') → '10:30:00' |
TIMESTAMP(expr) | 转为时间戳 | TIMESTAMP('2025-01-15') |
MAKETIME(h, m, s) | 构造时间值 | MAKETIME(10, 30, 0) → '10:30:00' |
提取函数
#
| 函数 | 同义函数 | 说明 |
|---|
YEAR(date) | — | 提取年份 |
MONTH(date) | — | 提取月份（1-12） |
MONTHNAME(date) | — | 月份名称（英文） |
DAY(date) | DAYOFMONTH(date) | 提取日（1-31） |
DAYNAME(date) | — | 星期名称（英文） |
DAYOFWEEK(date) | — | 星期几（1=周日，7=周六） |
DAYOFYEAR(date) | — | 一年中第几天（1-366） |
WEEK(date) | — | 一年中第几周 |
HOUR(time) | — | 提取小时 |
MINUTE(time) | — | 提取分钟 |
SECOND(time) | — | 提取秒 |
运算函数
#
| 函数 | 说明 | 示例 |
|---|
ADDDATE(date, INTERVAL n unit) / DATE_ADD(date, INTERVAL n unit) | 日期加法 | ADDDATE('2025-01-01', INTERVAL 7 DAY) |
SUBDATE(date, INTERVAL n unit) / DATE_SUB(date, INTERVAL n unit) | 日期减法 | SUBDATE('2025-01-08', INTERVAL 7 DAY) |
FROM_DAYS(n) | 从天数转日期 | FROM_DAYS(738886) |
UNIX_TIMESTAMP(date) | 转 Unix 时间戳 | UNIX_TIMESTAMP('2025-01-15') |
INTERVAL 支持的单位：SECOND、MINUTE、HOUR、DAY、WEEK、MONTH、QUARTER、YEAR。
格式化函数
#
| 函数 | 说明 | 示例 |
|---|
DATE_FORMAT(date, format) | 按格式字符串输出 | DATE_FORMAT('2025-01-15', '%Y/%m/%d') → '2025/01/15' |
常用格式占位符：
| 占位符 | 说明 | 示例值 |
|---|
%Y | 四位年份 | 2025 |
%m | 两位月份 | 01 |
%d | 两位日 | 15 |
%H | 24 小时制小时 | 10 |
%i | 分钟 | 30 |
%s | 秒 | 00 |
%W | 星期名称 | Wednesday |
%M | 月份名称 | January |
示例
#
SELECT YEAR(hire_date) AS yr,
MONTH(hire_date) AS mon,
DAYNAME(hire_date) AS dow,
DATE_FORMAT(hire_date, '%Y-%m') AS ym
FROM employees
WHERE hire_date > DATE_SUB(NOW(), INTERVAL 1 YEAR)
条件函数
#
| 函数 | 说明 | 示例 |
|---|
IF(cond, val1, val2) | 条件为真返回 val1，否则 val2 | IF(age > 30, 'senior', 'junior') |
IFNULL(expr, val) | expr 为 NULL 时返回 val | IFNULL(employer, 'N/A') |
NULLIF(expr1, expr2) | 两值相等返回 NULL，否则返回 expr1 | NULLIF(state, 'IL') |
ISNULL(expr) | 判断是否为 NULL（返回 1 或 0） | ISNULL(employer) |
与 CASE 表达式的对比
#
IF 函数适合简单的二选一判断，复杂的多分支条件使用 CASE 表达式更清晰（参见
复杂查询）。
-- IF 函数
SELECT IF(balance > 10000, 'high', 'low') AS level FROM accounts
-- 等效 CASE 表达式
SELECT CASE WHEN balance > 10000 THEN 'high' ELSE 'low' END AS level FROM accounts
类型转换
#
使用 CAST 函数在 SQL 数据类型之间进行转换。
语法
#
CAST(expression AS target_type)
支持的目标类型
#
| 目标类型 | 说明 |
|---|
BOOLEAN | 布尔值 |
BYTE | 8 位有符号整数 |
SHORT | 16 位有符号整数 |
INT / INTEGER | 32 位有符号整数 |
LONG | 64 位有符号整数 |
FLOAT | 单精度浮点 |
DOUBLE | 双精度浮点 |
STRING | 字符串 |
DATE | 日期 |
TIME | 时间 |
DATETIME / TIMESTAMP | 日期时间 |
示例
#
SELECT CAST(age AS DOUBLE) AS age_d,
CAST(account_number AS STRING) AS num_s,
CAST('2025-01-15' AS DATE) AS dt
FROM accounts
相关链接
#