3038 lines
63 KiB
Markdown
3038 lines
63 KiB
Markdown
函数
|
|
=======================
|
|
|
|
|
|
|
|
日期时间函数
|
|
---------------
|
|
|
|
日期时间函数主要用来显示有关日期和时间的信息。
|
|
|
|
#### CURDATE
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
CURDATE()
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
返回当前日期，不含时间部分。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT CURDATE();
|
|
+------------+
|
|
| CURDATE() |
|
|
+------------+
|
|
| 2018-05-05 |
|
|
+------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### CURRENT_DATE
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
CURRENT_DATE()
|
|
CURRENT_DATE
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
同 `CURDATE()`。
|
|
|
|
|
|
|
|
#### CURRENT_TIME
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
CURRENT_TIME([scale])
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
返回当前时间，不含日期部分。
|
|
|
|
`scale` 有效值为 0 到 6，表示微秒部分精度，默认值为 0。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT CURRENT_TIME(6);
|
|
+-----------------+
|
|
| CURRENT_TIME(6) |
|
|
+-----------------+
|
|
| 11:11:45.215311 |
|
|
+-----------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### CURRENT_TIMESTAMP
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
CURRENT_TIMESTAMP([scale])
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
返回当前日期时间，考虑时区设置。
|
|
|
|
`scale` 有效值为 0 到 6，表示微秒部分精度，默认值为 0。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT CURRENT_TIMESTAMP(6);
|
|
+----------------------------+
|
|
| CURRENT_TIMESTAMP(6) |
|
|
+----------------------------+
|
|
| 2018-05-05 11:35:39.177764 |
|
|
+----------------------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### CURTIME
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
CURTIME()
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
同 `CURRENT_TIME()`。
|
|
|
|
|
|
|
|
#### DATE_ADD
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
DATE_ADD(date, INTERVAL expr unit)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
日期时间的算术计算。
|
|
|
|
* `date` 表示日期时间基准，日期部分必选，时间部分可选。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* `expr` 表示时间间隔，可以为负值。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* `unit` 表示时间间隔单位。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
以下为所有时间间隔单位列表：
|
|
|
|
|
|
| 单位 | 类型 | 含义 | 格式 |
|
|
|----------------------|----|-------|----------------------------------------|
|
|
| `MICROSECOND` | 独立 | 微秒 | `MICROSECONDS` |
|
|
| `SECOND` | 独立 | 秒 | `SECONDS` |
|
|
| `MINUTE` | 独立 | 分钟 | `MINUTES` |
|
|
| `HOUR` | 独立 | 小时 | `HOURS` |
|
|
| `DAY` | 独立 | 天 | `DAYS` |
|
|
| `WEEK` | 独立 | 周 | `WEEKS` |
|
|
| `MONTH` | 独立 | 月 | `MONTHS` |
|
|
| `QUARTER` | 独立 | 季度 | `QUARTERS` |
|
|
| `YEAR` | 独立 | 年 | `YEARS` |
|
|
| `SECOND_MICROSECOND` | 组合 | 秒到微秒 | `'SECONDS.MICROSECONDS'` |
|
|
| `MINUTE_MICROSECOND` | 组合 | 分钟到微秒 | `'MINUTES:SECONDS.MICROSECONDS'` |
|
|
| `MINUTE_SECOND` | 组合 | 分钟到秒 | `'MINUTES:SECONDS'` |
|
|
| `HOUR_MICROSECOND` | 组合 | 小时到微秒 | `'HOURS:MINUTES:SECONDS.MICROSECONDS'` |
|
|
| `HOUR_SECOND` | 组合 | 小时到秒 | `'HOURS:MINUTES:SECONDS'` |
|
|
| `HOUR_MINUTE` | 组合 | 小时到分钟 | `'HOURS:MINUTES'` |
|
|
| `DAY_SECOND` | 组合 | 天到秒 | `'DAYS HOURS:MINUTES:SECONDS'` |
|
|
| `DAY_MINUTE` | 组合 | 天到分钟 | `'DDAYSD HOURS:MINUTES'` |
|
|
| `DAY_HOUR` | 组合 | 天到小时 | `'DAYS HOURS'` |
|
|
| `YEAR_MONTH` | 组合 | 年到月 | `'YEARS-MONTHS'` |
|
|
|
|
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT
|
|
-> DATE_ADD(NOW(), INTERVAL 5 DAY),
|
|
-> DATE_ADD('2014-01-10', INTERVAL 5 MICROSECOND),
|
|
-> DATE_ADD('2014-01-10', INTERVAL 5 SECOND),
|
|
-> DATE_ADD('2014-01-10', INTERVAL 5 MINUTE),
|
|
-> DATE_ADD('2014-01-10', INTERVAL 5 HOUR),
|
|
-> DATE_ADD('2014-01-10', INTERVAL 5 DAY),
|
|
-> DATE_ADD('2014-01-10', INTERVAL 5 WEEK),
|
|
-> DATE_ADD('2014-01-10', INTERVAL 5 MONTH),
|
|
-> DATE_ADD('2014-01-10', INTERVAL 5 QUARTER),
|
|
-> DATE_ADD('2014-01-10', INTERVAL 5 YEAR),
|
|
-> DATE_ADD('2014-01-10', INTERVAL '5.000005' SECOND_MICROSECOND),
|
|
-> DATE_ADD('2014-01-10', INTERVAL '05:05.000005' MINUTE_MICROSECOND),
|
|
-> DATE_ADD('2014-01-10', INTERVAL '05:05' MINUTE_SECOND),
|
|
-> DATE_ADD('2014-01-10', INTERVAL '05:05:05.000005' HOUR_MICROSECOND),
|
|
-> DATE_ADD('2014-01-10', INTERVAL '05:05:05' HOUR_SECOND),
|
|
-> DATE_ADD('2014-01-10', INTERVAL '05:05' HOUR_MINUTE),
|
|
-> DATE_ADD('2014-01-10', INTERVAL '01 05:05:05.000005' DAY_MICROSECOND),
|
|
-> DATE_ADD('2014-01-10', INTERVAL '01 05:05:05' DAY_SECOND),
|
|
-> DATE_ADD('2014-01-10', INTERVAL '01 05:05' DAY_MINUTE),
|
|
-> DATE_ADD('2014-01-10', INTERVAL '01 05' DAY_HOUR),
|
|
-> DATE_ADD('2014-01-10', INTERVAL '1-01' YEAR_MONTH)
|
|
-> \G
|
|
*************************** 1. row ***************************
|
|
DATE_ADD(NOW(), INTERVAL 5 DAY): 2018-05-10 14:54:52
|
|
DATE_ADD('2014-01-10', INTERVAL 5 MICROSECOND): 2014-01-10 00:00:00.000005
|
|
DATE_ADD('2014-01-10', INTERVAL 5 SECOND): 2014-01-10 00:00:05
|
|
DATE_ADD('2014-01-10', INTERVAL 5 MINUTE): 2014-01-10 00:05:00
|
|
DATE_ADD('2014-01-10', INTERVAL 5 HOUR): 2014-01-10 05:00:00
|
|
DATE_ADD('2014-01-10', INTERVAL 5 DAY): 2014-01-15
|
|
DATE_ADD('2014-01-10', INTERVAL 5 WEEK): 2014-02-14
|
|
DATE_ADD('2014-01-10', INTERVAL 5 MONTH): 2014-06-10
|
|
DATE_ADD('2014-01-10', INTERVAL 5 QUARTER): 2015-04-10
|
|
DATE_ADD('2014-01-10', INTERVAL 5 YEAR): 2019-01-10
|
|
DATE_ADD('2014-01-10', INTERVAL '5.000005' SECOND_MICROSECOND): 2014-01-10 00:00:05.000005
|
|
DATE_ADD('2014-01-10', INTERVAL '05:05.000005' MINUTE_MICROSECOND): 2014-01-10 00:05:05.000005
|
|
DATE_ADD('2014-01-10', INTERVAL '05:05' MINUTE_SECOND): 2014-01-10 00:05:05
|
|
DATE_ADD('2014-01-10', INTERVAL '05:05:05.000005' HOUR_MICROSECOND): 2014-01-10 05:05:05.000005
|
|
DATE_ADD('2014-01-10', INTERVAL '05:05:05' HOUR_SECOND): 2014-01-10 05:05:05
|
|
DATE_ADD('2014-01-10', INTERVAL '05:05' HOUR_MINUTE): 2014-01-10 05:05:00
|
|
DATE_ADD('2014-01-10', INTERVAL '01 05:05:05.000005' DAY_MICROSECOND): 2014-01-11 05:05:05.000005
|
|
DATE_ADD('2014-01-10', INTERVAL '01 05:05:05' DAY_SECOND): 2014-01-11 05:05:05
|
|
DATE_ADD('2014-01-10', INTERVAL '01 05:05' DAY_MINUTE): 2014-01-11 05:05:00
|
|
DATE_ADD('2014-01-10', INTERVAL '01 05' DAY_HOUR): 2014-01-11 05:00:00
|
|
DATE_ADD('2014-01-10', INTERVAL '1-01' YEAR_MONTH): 2015-02-10
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### DATE_FORMAT
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
DATE_FORMAT(date, format)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
将日期时间以指定格式输出。
|
|
|
|
* `date` 表示日期时间。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* `format` 表示输出格式。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
以下为所有输出格式列表：
|
|
|
|
|
|
| 格式符 | 含义 | 格式 |
|
|
|------|------------------------------|------------------------|
|
|
| `%a` | 星期的英文缩写。 | `Sun..Sat` |
|
|
| `%b` | 月份的英文缩写。 | `Jan..Dec` |
|
|
| `%c` | 月份的数字形式。 | `1..12` |
|
|
| `%D` | 日的英文缩写。 | `1st..31st` |
|
|
| `%d` | 日的数字形式。 | `01..31` |
|
|
| `%e` | 日的数字形式。 | `1.. 31` |
|
|
| `%f` | 微秒。 | `000000..999999` |
|
|
| `%H` | 小时。 | `00..23` |
|
|
| `%h` | 小时。 | `01..12` |
|
|
| `%I` | 小时。 | `01..12` |
|
|
| `%i` | 分钟。 | `00..59` |
|
|
| `%j` | 一年中的第几天。 | `001..366` |
|
|
| `%k` | 小时。 | `0..23` |
|
|
| `%l` | 小时。 | `0..12` |
|
|
| `%M` | 月份的英文名称。 | `January..December` |
|
|
| `%m` | 月份的数字形式。 | `01..12` |
|
|
| `%p` | 上午或下午。 | `AM/PM` |
|
|
| `%r` | 12小时制时间。 | `hh:mm:ss AM/PM` |
|
|
| `%S` | 秒。 | `00..59` |
|
|
| `%s` | 秒。 | `00..59` |
|
|
| `%T` | 24小时制时间。 | `hh:mm:ss` |
|
|
| `%U` | 一年中的第几周，周日为每周第一天。 | `00..53` |
|
|
| `%u` | 一年中的第几周，周一为每周第一天。 | `00..53` |
|
|
| `%V` | 一年中的第几周，周日为每周第一天(和`%X`同时使用)。 | `01..53` |
|
|
| `%v` | 一年中的第几周，周一为每周第一天(和`%x`同时使用)。 | `01..53` |
|
|
| `%W` | 星期的英文名称。 | `Sunday..Saturday` |
|
|
| `%w` | 一周中的第几天。 | `0=Sunday..6=Saturday` |
|
|
| `%X` | 一周所属的年份，周日为每周第一天(和`%V`同时使用)。 | |
|
|
| `%x` | 一周所属的年份，周一为每周第一天(和`%v`同时使用)。 | |
|
|
| `%Y` | 四位年份。 | |
|
|
| `%y` | 两位年份。 | |
|
|
| `%%` | 文字字符，输出一个`%`。 | |
|
|
|
|
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT
|
|
-> DATE_FORMAT('2014-01-01', '%Y-%M-%d'),
|
|
-> DATE_FORMAT('2014-01-01', '%X-%V'),
|
|
-> DATE_FORMAT('2014-01-01', '%U')
|
|
-> \G
|
|
*************************** 1. row ***************************
|
|
DATE_FORMAT('2014-01-01', '%Y-%M-%d'): 2014-January-01
|
|
DATE_FORMAT('2014-01-01', '%X-%V'): 2013-52
|
|
DATE_FORMAT('2014-01-01', '%U'): 00
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### DATE_SUB
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
DATE_SUB(date, INTERVAL expr unit)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
日期时间的算术计算。
|
|
|
|
请参考 `DATE_ADD()`。
|
|
|
|
|
|
|
|
#### DATEDIFF
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
DATEDIFF(date1, date2)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
返回 `date1` 和 `date2` 之间的天数。
|
|
|
|
计算中只用到参数的日期部分，忽略时间部分。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT DATEDIFF('2015-06-19','1994-12-17');
|
|
+-------------------------------------+
|
|
| DATEDIFF('2015-06-19','1994-12-17') |
|
|
+-------------------------------------+
|
|
| 7489 |
|
|
+-------------------------------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### EXTRACT
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
EXTRACT(unit FROM date)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
以整数类型返回 `date` 的指定部分值。如果指定多个部分，则将所有值按顺序拼接。
|
|
|
|
`unit` 请参考 `DATE_ADD()`。当 `unit` 为 `WEEK` 时，请参考 `DATE_FORMAT()` 的 `%U` 说明。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
SELECT EXTRACT(WEEK FROM '2013-01-01'),
|
|
EXTRACT(WEEK FROM '2013-01-06'),
|
|
EXTRACT(YEAR_MONTH FROM '2012-03-09'),
|
|
EXTRACT(DAY FROM NOW())\G;
|
|
* 1. row *
|
|
EXTRACT(WEEK FROM '2013-01-01'): 0
|
|
EXTRACT(WEEK FROM '2013-01-06'): 1
|
|
EXTRACT(YEAR_MONTH FROM '2012-03-09'): 201203
|
|
EXTRACT(DAY FROM NOW()): 18
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### FROM_DAYS
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
FROM_DAYS(N)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
返回指定天数 `N` 对应的 `DATE` 值。天数指距离 `0000-01-01` 的天数。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT FROM_DAYS(736271), FROM_DAYS(700000);
|
|
+-------------------+-------------------+
|
|
| FROM_DAYS(736271) | FROM_DAYS(700000) |
|
|
+-------------------+-------------------+
|
|
| 2015-11-04 | 1916-07-15 |
|
|
+-------------------+-------------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### FROM_UNIXTIME
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
FROM_UNIXTIME(unix_timestamp)
|
|
FROM_UNIXTIME(unix_timestamp, format)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
* 不指定 `format` 参数时，返回 `DATETIME` 类型值，不考虑时区。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* 指定 `format` 参数时，返回指定格式的日期时间字符串。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
`unix_timestamp` 指 UNIX 时间戳，即距离 `1970-01-01 00:00:00.000000` 的微秒数。
|
|
|
|
`format` 支持的格式已在 `DATE_FORMAT()` **说** **明** 中列出。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT FROM_UNIXTIME(UNIX_TIMESTAMP(), '%Y %D %M %h:%i:%s %x');
|
|
+---------------------------------------------------------+
|
|
| FROM_UNIXTIME(UNIX_TIMESTAMP(), '%Y %D %M %h:%i:%s %x') |
|
|
+---------------------------------------------------------+
|
|
| 2018 5th May 08:41:26 2018 |
|
|
+---------------------------------------------------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### MONTH
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
MONTH(date)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
返回 `date` 的月份信息。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT MONTH('2008-02-03');
|
|
+---------------------+
|
|
| MONTH('2008-02-03') |
|
|
+---------------------+
|
|
| 2 |
|
|
+---------------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### NOW
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
NOW([scale])
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
同 `CURRENT_TIMESTAMP()`。
|
|
|
|
|
|
|
|
#### PERIOD_DIFF
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
PERIOD_DIFF(p1, p2)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
以月份位单位返回两个日期之间的间隔。日期只能包含年月信息，格式只能为 `YYYYMM` 或 `YYMM`。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT PERIOD_DIFF(200802, 200703);
|
|
+----------------------------+
|
|
| PERIOD_DIFF(200802,200703) |
|
|
+----------------------------+
|
|
| 11 |
|
|
+----------------------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### STR_TO_DATE
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
STR_TO_DATE(str, format)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
使用 `format` 将 `str` 转换为 `DATETIME` 值、`DATE` 值、或 `TIME` 值。返回值类型取决于 `format` 包含日期时间的哪些部分。
|
|
|
|
`format` 支持的格式已在 `DATE_FORMAT()` **说** **明** 中列出。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT STR_TO_DATE('2014-Jan-1st 5:5:5 pm', '%Y-%b-%D %r');
|
|
+-----------------------------------------------------+
|
|
| STR_TO_DATE('2014-Jan-1st 5:5:5 pm', '%Y-%b-%D %r') |
|
|
+-----------------------------------------------------+
|
|
| 2014-01-01 05:05:05 |
|
|
+-----------------------------------------------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### TIME
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
TIME(datetime
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
以 `TIME` 类型返回 `datetime` 的时间信息。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT TIME('2003-12-31 01:02:03');
|
|
+-----------------------------+
|
|
| TIME('2003-12-31 01:02:03') |
|
|
+-----------------------------+
|
|
| 01:02:03.000000 |
|
|
+-----------------------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### TIME_TO_USEC
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
TIME_TO_USEC(date)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
将 `date` 值转换为距离 `1970-01-01 00:00:00.000000` 的微秒数，考虑时区信息。
|
|
|
|
`date` 可以表示日期，也可以表示日期时间。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT TIME_TO_USEC('2014-03-25'), TIME_TO_USEC(NOW());
|
|
+----------------------------+---------------------+
|
|
| TIME_TO_USEC('2014-03-25') | TIME_TO_USEC(NOW()) |
|
|
+----------------------------+---------------------+
|
|
| 1395676800000000 | 1525528100000000 |
|
|
+----------------------------+---------------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### TIMEDIFF
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
TIMEDIFF(date1, date2)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
以 `TIME` 类型返回两个日期时间的时间间隔。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT
|
|
-> TIMEDIFF('2015-06-06 12:12:12', '2014-06-05 11:11:11'),
|
|
-> TIMEDIFF('2015-06-06 12:12:12', '2015-06-05 11:11:11')
|
|
-> \G
|
|
*************************** 1. row ***************************
|
|
TIMEDIFF('2015-06-06 12:12:12', '2014-06-05 11:11:11'): 838:59:59
|
|
TIMEDIFF('2015-06-06 12:12:12', '2015-06-05 11:11:11'): 25:01:01
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### TIMESTAMPDIFF
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
TIMESTAMPDIFF(unit, date1, date2)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
以 `unit` 为单位返回两个日期时间的间隔。`unit` 只能为 `DATE_ADD()` 中的独立单位。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT
|
|
-> TIMESTAMPDIFF(SECOND, NOW(), '2011-01-01 11:11:11'),
|
|
-> TIMESTAMPDIFF(DAY, '2011-01-01 11:11:11', NOW())
|
|
-> \G
|
|
*************************** 1. row ***************************
|
|
TIMESTAMPDIFF(SECOND, NOW(), '2011-01-01 11:11:11'): -231677498
|
|
TIMESTAMPDIFF(DAY, '2011-01-01 11:11:11', NOW()): 2681
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### TIMESTAMPADD
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
TIMESTAMPADD(unit, interval_expr, date)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
日期时间的算术计算。
|
|
|
|
同 `DATE_ADD()`，但 `unit` 只能为独立单位。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT
|
|
-> TIMESTAMPADD(DAY, -5, '2010-01-01 00:00:00'),
|
|
-> DATE_ADD('2010-01-01 00:00:00', INTERVAL -5 DAY)
|
|
-> \G
|
|
*************************** 1. row ***************************
|
|
TIMESTAMPADD(DAY, -5, '2010-01-01 00:00:00'): 2009-12-27 00:00:00
|
|
DATE_ADD('2010-01-01 00:00:00', INTERVAL -5 DAY): 2009-12-27 00:00:00
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### TO_DAYS
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
TO_DAYS(date)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
返回指定 `date` 值对应的天数。天数指距离 `0000-01-01` 的天数。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT TO_DAYS('2015-11-04'), TO_DAYS('20151104');
|
|
+-----------------------+---------------------+
|
|
| TO_DAYS('2015-11-04') | TO_DAYS('20151104') |
|
|
+-----------------------+---------------------+
|
|
| 736271 | 736271 |
|
|
+-----------------------+---------------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### USEC_TO_TIME
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
USEC_TO_TIME(usec)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
将 `usec` 值转换为 `TIMESTAMP` 类型值。
|
|
|
|
`usec` 表示距离 `1970-01-01 00:00:00.000000` 的微秒数，考虑时区信息。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT USEC_TO_TIME(1);
|
|
+----------------------------+
|
|
| USEC_TO_TIME(1) |
|
|
+----------------------------+
|
|
| 1970-01-01 08:00:00.000001 |
|
|
+----------------------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### UNIX_TIMESTAMP
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
UNIX_TIMESTAMP()
|
|
UNIX_TIMESTAMP(date)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
* 不指定 `date` 参数时，返回当前时间距离 '1970-01-01 00:00:00' 的秒数，考虑时区。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* 指定 `date` 参数时，返回指定时间距离 '1970-01-01 00:00:00' 的秒数，考虑时区。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT UNIX_TIMESTAMP(), TIME_TO_USEC(NOW());
|
|
+------------------+---------------------+
|
|
| UNIX_TIMESTAMP() | TIME_TO_USEC(NOW()) |
|
|
+------------------+---------------------+
|
|
| 1525570561 | 1525570561000000 |
|
|
+------------------+---------------------+
|
|
1 row in set (0.01 sec)
|
|
|
|
obclient> SELECT UNIX_TIMESTAMP('1997-10-04 22:23:00');
|
|
+---------------------------------------+
|
|
| UNIX_TIMESTAMP('1997-10-04 22:23:00') |
|
|
+---------------------------------------+
|
|
| 875974980 |
|
|
+---------------------------------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### UTC_TIMESTAMP
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
UTC_TIMESTAMP()
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
返回当前 UTC 时间。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT UTC_TIMESTAMP();
|
|
+---------------------+
|
|
| UTC_TIMESTAMP() |
|
|
+---------------------+
|
|
| 2018-05-06 01:38:32 |
|
|
+---------------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### YEAR
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
YEAR(date)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
返回 `date` 值的年份信息。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT YEAR('1987-01-01');
|
|
+--------------------+
|
|
| YEAR('1987-01-01') |
|
|
+--------------------+
|
|
| 1987 |
|
|
+--------------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
字符串函数
|
|
--------------
|
|
|
|
#### CONCAT
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
CONCAT(str1, .., strN)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
把多个字符串连接成一个字符串。参数中包含 `NULL` 时，返回 `NULL`。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT
|
|
-> CONCAT('test','obclient', '1.0'),
|
|
-> CONCAT('test','obclient', NULL)
|
|
-> \G
|
|
*************************** 1. row ***************************
|
|
CONCAT('test','obclient', '1.0'): testobclient1.0
|
|
CONCAT('test','obclient', NULL): NULL
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### CONCAT_WS
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
CONCAT_WS(separator, str1, .., strN)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
把多个字符串连接成一个字符串，相邻字符串间使用 `separator` 分隔。参数中包含 `NULL` 时，将忽略 `NULL`。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT
|
|
-> CONCAT_WS('_', 'First', 'Second'),
|
|
-> CONCAT_WS('_', 'First', NULL, 'Second')
|
|
-> \G
|
|
*************************** 1. row ***************************
|
|
CONCAT_WS('_', 'First', 'Second'): First_Second
|
|
CONCAT_WS('_', 'First', NULL, 'Second'): First_Second
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
FORMAT
|
|
|
|
**声明**
|
|
|
|
```unknow
|
|
FORMAT(X,D)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
把数字 X 格式化为"#,###,###.##"格式，四舍五入到 D 位小数，并以字符串形式返回结果（如果整数部分超过三位，会用","作为千分位分隔符）。如果 D 为 0，则结果没有小数点或小数部分。
|
|
|
|
**例子**
|
|
|
|
```unknow
|
|
obclient>SELECT FORMAT(12332.123456, 4) from DUAL;
|
|
+-------------------------+
|
|
| format(12332.123456, 4) |
|
|
+-------------------------+
|
|
| 12,332.1235 |
|
|
+-------------------------+
|
|
1 row in set (0.00 sec)
|
|
|
|
obclient>SELECT FORMAT(12332.1, 4) from DUAL;
|
|
+--------------------+
|
|
| format(12332.1, 4) |
|
|
+--------------------+
|
|
| 12,332.1000 |
|
|
+--------------------+
|
|
1 row in set (0.01 sec)
|
|
|
|
obclient>SELECT FORMAT(12332.2, 0) from DUAL;
|
|
+--------------------+
|
|
| format(12332.2, 0) |
|
|
+--------------------+
|
|
| 12,332 |
|
|
+--------------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### SUBSTR
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
SUBSTR(str, pos)
|
|
SUBSTR(str, pos, len)
|
|
SUBSTR(str FROM pos)
|
|
SUBSTR(str FROM pos FOR len)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
返回 `str` 的子字符串，起始位置为 `pos`，长度为 `len`。参数中包含 `NULL` 时，返回 `NULL`。
|
|
|
|
* 不指定 `len` 时，返回的子字符串从 `pos` 位置开始到 `str` 结尾。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* `pos` 值为负数时，从 `str` 尾部向头部倒序确定起始位置。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* `len` 小于等于 0，或 `pos` 指定的起始位置非法时，返回空字符串。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT
|
|
-> SUBSTR('abcdefg', 3),
|
|
-> SUBSTR('abcdefg', 3, 2),
|
|
-> SUBSTR('abcdefg', -3),
|
|
-> SUBSTR('abcdefg', 3, -2),
|
|
-> SUBSTR('abcdefg' from -4 for 2)
|
|
-> \G
|
|
*************************** 1. row ***************************
|
|
SUBSTR('abcdefg', 3): cdefg
|
|
SUBSTR('abcdefg', 3, 2): cd
|
|
SUBSTR('abcdefg', -3): efg
|
|
SUBSTR('abcdefg', 3, -2):
|
|
SUBSTR('abcdefg' from -4 for 2): de
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### SUBSTRING
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
SUBSTRING(str, pos)
|
|
SUBSTRING(str, pos, len)
|
|
SUBSTRING(str FROM pos)
|
|
SUBSTRING(str FROM pos FOR len)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
同 `SUBSTR`。
|
|
|
|
|
|
|
|
#### TRIM
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
TRIM([[{BOTH | LEADING | TRAILING}] [remstr] FROM] str)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
删除字符串所有前缀和/或后缀，默认为 `BOTH`。参数中包含 `NULL` 时，返回 `NULL`。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT
|
|
-> TRIM(' bar '),
|
|
-> TRIM(LEADING 'x' FROM 'xxxbarxxx'),
|
|
-> TRIM(BOTH 'x' FROM 'xxxbarxxx'),
|
|
-> TRIM(TRAILING 'x' FROM 'xxxbarxxx')
|
|
-> \G
|
|
*************************** 1. row ***************************
|
|
TRIM(' bar '): bar
|
|
TRIM(LEADING 'x' FROM 'xxxbarxxx'): barxxx
|
|
TRIM(BOTH 'x' FROM 'xxxbarxxx'): bar
|
|
TRIM(TRAILING 'x' FROM 'xxxbarxxx'): xxxbar
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### LTRIM
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
LTRIM(str)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
删除字符串左侧的空格。
|
|
|
|
|
|
|
|
#### RTRIM
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
RTRIM(str)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
删除字符串右侧的空格。
|
|
|
|
|
|
|
|
#### ASCII
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
ASCII(str)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
返回字符串最左侧字符的 ASCII 码。
|
|
|
|
|
|
|
|
#### ORD
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
ORD(str)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
返回字符串最左侧字符的字符码。单字节编码如果最左侧字符是多字节编码字符，返回值计算规则如下：
|
|
|
|
```javascript
|
|
(1st byte code)
|
|
+ (2nd byte code * 256)
|
|
+ (3rd byte code * 256^2) ...
|
|
```
|
|
|
|
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT ORD('中国');
|
|
+---------------+
|
|
| ORD('中国') |
|
|
+---------------+
|
|
| 14989485 |
|
|
+---------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### LENGTH
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
LENGTH(str)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
返回 `str` 的字节长度。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT LENGTH('中国'), LENGTH('hello');
|
|
+------------------+-----------------+
|
|
| LENGTH('中国') | LENGTH('hello') |
|
|
+------------------+-----------------+
|
|
| 6 | 5 |
|
|
+------------------+-----------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### CHAR_LENGTH
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
CHAR_LENGTH(str)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
返回字符串包含的字符数。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT CHAR_LENGTH('中国'), CHAR_LENGTH('hello');
|
|
+-----------------------+----------------------+
|
|
| CHAR_LENGTH('中国') | CHAR_LENGTH('hello') |
|
|
+-----------------------+----------------------+
|
|
| 2 | 5 |
|
|
+-----------------------+----------------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### UPPER
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
UPPER(str)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
将字符串中的小写字母转化为大写字母。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT UPPER('obclient您好！');
|
|
+-----------------------------+
|
|
| UPPER('obclient您好！') |
|
|
+-----------------------------+
|
|
| OCEANBASE您好！ |
|
|
+-----------------------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### LOWER
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
LOWER(str)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
将字符串中的大写字母转化为小写字母。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT LOWER('obclient您好！');
|
|
+-----------------------------+
|
|
| LOWER('obclient您好！') |
|
|
+-----------------------------+
|
|
| obclient您好！ |
|
|
+-----------------------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### HEX
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
HEX(str)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
将数字或字符串转化为十六进制字符串。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT HEX(255), HEX('abc');
|
|
+----------+------------+
|
|
| HEX(255) | HEX('abc') |
|
|
+----------+------------+
|
|
| FF | 616263 |
|
|
+----------+------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### UNHEX
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
UNHEX(str)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
将十六进制字符串转化为正常字符串。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT UNHEX('4f6365616e42617365');
|
|
+-----------------------------+
|
|
| UNHEX('4f6365616e42617365') |
|
|
+-----------------------------+
|
|
| obclient |
|
|
+-----------------------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### MD5
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
MD5(str)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
返回字符串的 MD5 值。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT MD5(1);
|
|
+----------------------------------+
|
|
| MD5(1) |
|
|
+----------------------------------+
|
|
| c4ca4238a0b923820dcc509a6f75849b |
|
|
+----------------------------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### INT2IP
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
INT2IP(int_value)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
将整数内码转换成 IP 地址。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT
|
|
-> INT2IP(16777216),
|
|
-> HEX(16777216),
|
|
-> INT2IP(1)
|
|
-> \G
|
|
*************************** 1. row ***************************
|
|
INT2IP(16777216): 1.0.0.0
|
|
HEX(16777216): 1000000
|
|
INT2IP(1): 0.0.0.1
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### IP2INT
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
IP2INT('ip_addr')
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
将 IP 地址转换成整数内码。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT
|
|
-> IP2INT('0.0.0.1'),
|
|
-> HEX(IP2INT('0.0.0.1')),
|
|
-> HEX(IP2INT('1.0.0.0'))
|
|
-> \G
|
|
*************************** 1. row ***************************
|
|
IP2INT('0.0.0.1'): 1
|
|
HEX(IP2INT('0.0.0.1')): 1
|
|
HEX(IP2INT('1.0.0.0')): 1000000
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### LIKE
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
str1 [NOT] LIKE str2 [ESCAPE str3]
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
字符串通配符匹配。参数中包含 `NULL` 时，返回 `NULL`。
|
|
|
|
通配符包括：
|
|
|
|
* `%`：匹配任意长度字符串。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* `_`：匹配单个字符。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
ESCAPE 用于定义转义符，如果 str2 中包含 str3，在匹配时 str3 后的字符将做为普通字符处理。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT 'ab%' LIKE 'abc%' ESCAPE 'c';
|
|
+------------------------------+
|
|
| 'ab%' LIKE 'abc%' ESCAPE 'c' |
|
|
+------------------------------+
|
|
| 1 |
|
|
+------------------------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### REGEXP
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
str [NOT] REGEXP | RLIKE pat
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
正则匹配。参数中包含 `NULL` 时，返回 `NULL`。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT
|
|
-> 1234 REGEXP 1,
|
|
-> 'hello' RLIKE 'h%'
|
|
-> \G
|
|
*************************** 1. row ***************************
|
|
1234 REGEXP 1: 1
|
|
'hello' RLIKE 'h%': 0
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### REPEAT
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
REPEAT(str, count)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
返回 `str` 重复 `count` 次组成的字符串。`count` 小于等于 0 时，返回空字符串。参数中包含 `NULL` 时，返回 `NULL`。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT
|
|
-> REPEAT('1', -1),
|
|
-> REPEAT(null, null),
|
|
-> REPEAT('Abc', 4)
|
|
-> \G
|
|
*************************** 1. row ***************************
|
|
REPEAT('1', -1):
|
|
REPEAT(null, null): NULL
|
|
REPEAT('Abc', 4): AbcAbcAbcAbc
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### SPACE
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
SPACE(N)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
返回包含 `N` 个空格的字符串。
|
|
|
|
|
|
|
|
#### SUBSTRING_INDEX
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
SUBSTRING_INDEX(str, delim, count)
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
在定界符 delim 以及 count 出现前，从字符串 str 返回字符串。若 count 为正值，则返回最终定界符（从左边开始）左边的一切内容。若 count 为负值，则返回定界符（从右边开始）右边的一切内容。任意一个参数为 NULL，返回 NULL；若 str 或 delim 为空字符串，则返回空串；若 count = 0, 返回空串。
|
|
|
|
*str, delim, count 参数支持数值与字符串的隐式转换。*
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>select substring_index('abcdabc', 'abc', 0), substring_index('abcdabc', 'abc', 1), substring_index('abcdabc', 'abc', 2), substring_index('abcdabc', 'abc', 3), substring_index('abcdabc', 'abc', -1), substring_index('abcdabc', 'abc', -2), substring_index('abcdabc', 'abc', -3)\G;
|
|
* 1. row *
|
|
substring_index('abcdabc', 'abc', 0):
|
|
substring_index('abcdabc', 'abc', 1):
|
|
substring_index('abcdabc', 'abc', 2): abcd
|
|
substring_index('abcdabc', 'abc', 3): abcdabc
|
|
substring_index('abcdabc', 'abc', -1):
|
|
substring_index('abcdabc', 'abc', -2): dabc
|
|
substring_index('abcdabc', 'abc', -3): abcdabc
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### LOCATE
|
|
|
|
**声明**
|
|
|
|
`LOCATE(substr,str) , LOCATE(substr,str,pos)`
|
|
|
|
**说明**
|
|
|
|
第一个语法返回字符串 str 中子字符串 substr 的第一个出现位置。第二个语法返回字符串 str 中子字符串 substr 的第一个出现位置, 起始位置在 pos。如若 substr 不在 str 中，则返回值为 0。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>SELECT LOCATE('bar', 'foobarbar');
|
|
-> 4
|
|
obclient>SELECT LOCATE('xbar', 'foobar');
|
|
-> 0
|
|
obclient>SELECT LOCATE('bar', 'foobarbar',5);
|
|
-> 7
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### POSITION
|
|
|
|
**声明**
|
|
|
|
`POSITION(substr IN str)`
|
|
|
|
**说明**
|
|
|
|
与 LOCATE 同义。
|
|
|
|
|
|
|
|
#### INSTR
|
|
|
|
**声明**
|
|
|
|
`INSTR(str,substr)`
|
|
|
|
**说明**
|
|
|
|
返回字符串 str 中子字符串的第一个出现位置。这和 LOCATE() 的双参数形式相同，除非参数的顺序被颠倒。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>SELECT INSTR('foobarbar', 'bar');
|
|
-> 4
|
|
obclient>SELECT INSTR('xbar', 'foobar');
|
|
-> 0
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### REPLACE
|
|
|
|
**声明**
|
|
|
|
`REPLACE(str, from_str, to_str)`
|
|
|
|
**说明**
|
|
|
|
返回字符串 str 以及所有被字符 to_str 替代的字符串 from_str。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>SELECT REPLACE('abc.efg.gpg.nowdew.abc.dabc.e', 'abc.', 'www');
|
|
+---------------------------------------------------------+
|
|
| REPLACE('abc.efg.gpg.nowdew.abc.dabc.e', 'abc.', 'www') |
|
|
+---------------------------------------------------------+
|
|
| wwwefg.gpg.nowdew.wwwdwwwe |
|
|
+---------------------------------------------------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### FIELD
|
|
|
|
**声明**
|
|
|
|
`FIELD(str,str1,str2,str3,...)`
|
|
|
|
**说明**
|
|
|
|
返回参数 str 在 str1, str2, str3,... 列表中的索引位置（从 1 开始的位置）。在找不到 str 的情况下，返回值为 0。
|
|
|
|
如果所有的对于 FIELD() 的参数均为字符串，则所有参数均按照字符串进行比较。如果所有的参数均为数字，则按照数字进行比较。否则，参数均按照 double 类型进行比较。
|
|
|
|
如果 str 为 NULL，则返回值为 0，原因是 NULL 不能同任何值进行同等比较。FILED() 是 ELT() 的补数。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>select field('abc','abc1','abc2','abc','abc4','abc'), field(NULL, 'null1', NULL);
|
|
+-----------------------------------------------+----------------------------+
|
|
| field('abc','abc1','abc2','abc','abc4','abc') | field(NULL, 'null1', NULL) |
|
|
+-----------------------------------------------+----------------------------+
|
|
| 3 | 0 |
|
|
+-----------------------------------------------+----------------------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### ELT
|
|
|
|
**声明**
|
|
|
|
`ELT(N, str1, str2, str3,...)`
|
|
|
|
**说明**
|
|
|
|
若 N=1，则返回值为 str1, 若 N=2，则返回值为 str2，以此类推。若 N 小于 1 或大于参数的数目，则返回值为NULL。ELT() 是 FIELD() 的补数。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>select elt(3, 'abc1', 'abc2', 'abc', 'abc4', 'abc'), elt(0, 'null1', NULL);
|
|
+----------------------------------------------+-----------------------+
|
|
| elt(3, 'abc1', 'abc2', 'abc', 'abc4', 'abc') | elt(0, 'null1', NULL) |
|
|
+----------------------------------------------+-----------------------+
|
|
| abc | NULL |
|
|
+----------------------------------------------+-----------------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### INSERT
|
|
|
|
**声明**
|
|
|
|
`INSERT (str1,pos,len,str2)`
|
|
|
|
**说明**
|
|
|
|
返回字符串 str1, 字符串中起始于 pos 位置，长度为 len 的子字符串将被 str2 取代。如果 pos 超过字符串长度，则返回值为原始字符串。 假如 len 的长度大于其它字符串的长度，则从位置 pos 开始替换。若任何一个参数为 null，则返回值为 NULL。这个函数支持多字节字元。
|
|
|
|
* *str1 和 str2 必须是字符串，pos 和 len 必须是整数。任意参数为 NULL，结果总为 NULL；*
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* *str1 和 str2 中的文字符被当做字节流看待；*
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* *pos 值为负数或者大于 str1 长度时，返回 str1；*
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* 当 len 小于 0，或大于 str 的长度时，返回结果为 str1 从开头到 pos 位置的串，和 str2 的组合串。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>select insert('Quadratic',-2,100,'What'), insert('Quadratic',7,3,'What'),
|
|
-> insert('Quadratic',-1,3,'What'), insert('Quadratic',10,3,'What'), insert('Quadratic',5,-1,''),
|
|
-> insert('Quadratic',7,-1,'What')\G;
|
|
* 1. row *
|
|
insert('Quadratic',-2,100,'What'): Quadratic
|
|
insert('Quadratic',7,3,'What'): QuadraWhat
|
|
insert('Quadratic',-1,3,'What'): Quadratic
|
|
insert('Quadratic',10,3,'What'): Quadratic
|
|
insert('Quadratic',5,-1,''): Quad
|
|
insert('Quadratic',7,-1,'What'): QuadraWhat
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### LPAD
|
|
|
|
**声明**
|
|
|
|
`LPAD(str, len, padstr)`
|
|
|
|
**说明**
|
|
|
|
用指定字符串 padstr，在左侧填充字符串 str 到指定长度 len。如果 str 长度大于 len，则 str 被截断。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient > SELECT LPAD('hi',4,'??');
|
|
+-------------------+
|
|
| LPAD('hi',4,'??') |
|
|
+-------------------+
|
|
| ??hi |
|
|
+-------------------+
|
|
1 row in set (0.01 sec)
|
|
|
|
obclient > SELECT LPAD('hi',1,'??');
|
|
+-------------------+
|
|
| LPAD('hi',1,'??') |
|
|
+-------------------+
|
|
| h |
|
|
+-------------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### RPAD
|
|
|
|
**声明**
|
|
|
|
`RPAD(str, len, padstr)`
|
|
|
|
**说明**
|
|
|
|
用指定字符串 padstr，在右侧填充字符串 str 到指定长度 len。如果 str 长度大于 len，则 str 被截断。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> SELECT RPAD('hi',4,'??');
|
|
+-------------------+
|
|
| RPAD('hi',4,'??') |
|
|
+-------------------+
|
|
| hi?? |
|
|
+-------------------+
|
|
1 row in set (0.00 sec)
|
|
|
|
obclient> SELECT RPAD('hi',1,'??');
|
|
+-------------------+
|
|
| RPAD('hi',1,'??') |
|
|
+-------------------+
|
|
| h |
|
|
+-------------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### UUID
|
|
|
|
**声明**
|
|
|
|
`uuid()`
|
|
|
|
**说明**
|
|
|
|
生成一个全局唯一 ID。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> select uuid();
|
|
+--------------------------------------+
|
|
| uuid() |
|
|
+--------------------------------------+
|
|
| f756a1f6-4de6-11e8-90af-90b11c53e421 |
|
|
+--------------------------------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### BIN
|
|
|
|
**声明**
|
|
|
|
`bin(N)`
|
|
|
|
**说明**
|
|
|
|
返回数字 N 的二进制形式。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient > SELECT BIN(12);
|
|
+---------+
|
|
| BIN(12) |
|
|
+---------+
|
|
| 1100 |
|
|
+---------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### QUOTE
|
|
|
|
**声明**
|
|
|
|
`quote(str)`
|
|
|
|
**说明**
|
|
|
|
引用一个字符串以产生一个结果可以作为 SQL 语句中正确地转义数据值。返回的字符串由单引号和单引号的各个实例封闭('')，反斜线('')，ASCII NUL 和 Control-Z 前面加一个反斜杠。如果参数为 NULL，则返回值是词 'NULL' 不包围单引号。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient > SELECT QUOTE('Don\'t!');
|
|
+------------------+
|
|
| QUOTE('Don\'t!') |
|
|
+------------------+
|
|
| 'Don\'t!' |
|
|
+------------------+
|
|
1 row in set (0.00 sec)
|
|
|
|
obclient > SELECT QUOTE(NULL);
|
|
+-------------+
|
|
| QUOTE(NULL) |
|
|
+-------------+
|
|
| NULL |
|
|
+-------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### REGEXP_SUBSTR
|
|
|
|
**声明**
|
|
|
|
`regexp_substr(str,pattern,[position[,occurrence[,match_param[,subexpr]]]])`
|
|
|
|
**说明**
|
|
|
|
在 str 中搜索匹配正则表达式 pattern 的子串，子串不存在返回 NULL。这个函数支持多字节字元。除 match_param 外，其他任意参数为 NULL，结果为 NULL。
|
|
|
|
* str 待搜索的字符串，支持多字节字元。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* pattern 正则表达式，正则表达式规则兼容 mysql。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* position \[可选\] 搜索的开始位置。必须是大于 0 的正整数，小于等于 0 报错，输入为 NULL 返回 NULL，默认值为 1，表示从第一个字符开始搜索。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* occurrence \[可选\] 返回第几次匹配的值。必须是大于等于 0 的正整数，小于等于 0 报错，输入为 NULL 返回 NULL，默认值是 1，表示返回第一次匹配的结果。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* match_param \[可选\] 搜索参数，字符串类型，目前仅支持两个字符 'i','c'，i: 代表忽略大小写 c: 代表不忽略，其他字符报错。默认值根据 str 字符集的 collection 决定。 为 NULL 时使用默认值。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* subexpr \[可选\] 返回正则表达式中第几个组的值。大于等于 0 的整数，小于 0 则报错。默认值是 0，表示返回满足整个 pattern 的子串。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> select regexp_substr('I have 2 apples and 100 bucks!', '[[:blank:]][[:alnum:]]*', 1, 1) from dual;
|
|
+----------------------------------------------------------------------------------+
|
|
| regexp_substr('I have 2 apples and 100 bucks!', '[[:blank:]][[:alnum:]]*', 1, 1) |
|
|
+----------------------------------------------------------------------------------+
|
|
| have |
|
|
+----------------------------------------------------------------------------------+
|
|
1 row in set (0.00 sec)
|
|
|
|
obclient> select regexp_substr('foothebar', 'foo(.*)(bar)', 1, 1, 'c', 1) from dual;
|
|
+----------------------------------------------------------+
|
|
| regexp_substr('foothebar', 'foo(.*)(bar)', 1, 1, 'c', 1) |
|
|
+----------------------------------------------------------+
|
|
| the |
|
|
+----------------------------------------------------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
转换函数
|
|
-------------
|
|
|
|
#### CAST
|
|
|
|
**声明**
|
|
|
|
`CAST(expr AS type)`
|
|
|
|
**说明**
|
|
|
|
将某种数据类型的表达式显式转换为另一种数据类型。
|
|
|
|
将 expr 字段值转换为 type 数据类型。
|
|
|
|
**参数说明** ：
|
|
|
|
|
|
|
|
* expr：表示任何有效的 SQL 表达式。
|
|
|
|
|
|
|
|
* AS：用于分隔两个参数，在 AS 之前的是要处理的数据，在 AS 之后是要转换的数据类型。
|
|
|
|
|
|
|
|
* type：表示目标系统所提供的数据类型。可以是以下值其中的一个：
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
在使用 CAST 函数进行数据类型转换时，在下列情况下能够被接受：
|
|
|
|
* 两个表达式的数据类型完全相同；
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* 两个表达式可隐式转换；
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* 必须显式转换数据类型。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
如果试图进行不可能的转换，OceanBase数据库 将显示一条错误信息。
|
|
|
|
如果转换时没有指定数据类型的长度，则使用 OceanBase 数据库系统内部最大长度。如 varchar 是262,143字节，number 是 65 个 bit 位的浮动精度。
|
|
|
|
支持带符号和无符号的 64 比特值的运算。若你正在使用数字操作符 (如 +) 而其中一个操作数为无符号整数，则结果为无符号。可使用 SIGNED 和 UNSIGNED cast 操作符来覆盖它。将运算分别派给带符号或无符号 64 比特整数。
|
|
|
|
假如任意一个操作数为一个浮点值，则结果为一个浮点值。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>SELECT CAST(123 AS BOOL);
|
|
+-------------------+
|
|
| CAST(123 AS bool) |
|
|
+-------------------+
|
|
| 1 |
|
|
+-------------------+
|
|
1 row in set (0.00 sec)
|
|
|
|
obclient>select cast(1-2 as unsigned), cast(cast(1-2 as unsigned) as signed);
|
|
+-----------------------+---------------------------------------+
|
|
| cast(1-2 as unsigned) | cast(cast(1-2 as unsigned) as signed) |
|
|
+-----------------------+---------------------------------------+
|
|
| 18446744073709551615 | -1 |
|
|
+-----------------------+---------------------------------------+
|
|
1 row in set (0.00 sec)
|
|
|
|
obclient>SELECT CAST(1 AS UNSIGNED) - 2.0;
|
|
+---------------------------+
|
|
| CAST(1 AS UNSIGNED) - 2.0 |
|
|
+---------------------------+
|
|
| -1.0 |
|
|
+---------------------------+
|
|
1 row in set (0.00 sec)
|
|
|
|
obclient>select cast(0 as date);
|
|
+-----------------+
|
|
| cast(0 as date) |
|
|
+-----------------+
|
|
| 0000-00-00 |
|
|
+-----------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
数学函数
|
|
-------------
|
|
|
|
#### ROUND
|
|
|
|
**声明**
|
|
|
|
`ROUND(X), ROUND(X,D)`
|
|
|
|
**说明**
|
|
|
|
返回一个数值，四舍五入到指定的长度或精度。
|
|
|
|
返回参数 X, 其值接近于最近似的整数。在有两个参数的情况下，返回 X，其值保留到小数点后 D 位，而第 D 位的保留方式为四舍五入。若要接保留 X 值小数点左边的 D 位，可将 D 设为负值。
|
|
|
|
返回值的类型同第一个自变量相同（假设它是一个整数、双精度数或小数）。这意味着对于一个整数参数，结果也是一个整数（无小数部分）。
|
|
|
|
* 对于准确值数字，ROUND() 使用"四舍五入" 或"舍入成最接近的数" 的规则：对于一个分数部分为 .5 或大于 .5 的值，正数则上舍入到邻近的整数值，负数则下舍入临近的整数值。（换言之, 其舍入的方向是数轴上远离零的方向）。对于一个分数部分小于 .5 的值，正数则下舍入下一个整数值，负数则下舍入邻近的整数值，而正数则上舍入邻近的整数值。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* 对于近似值数字， ROUND() 遵循银行家规则"四舍--大于五入--五取最接近的偶数"的规则： 一个带有任何小数部分的值会被舍入成最接近的偶数整数。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>select round(2.15,2);
|
|
+---------------+
|
|
| round(2.15,2) |
|
|
+---------------+
|
|
| 2.15 |
|
|
+---------------+
|
|
1 row in set (0.00 sec)
|
|
|
|
obclient>select round(2555e-2,1);
|
|
+------------------+
|
|
| round(2555e-2,1) |
|
|
+------------------+
|
|
| 25.6 |
|
|
+------------------+
|
|
1 row in set (0.01 sec)
|
|
|
|
obclient>select round(25e-1), round(25.3e-1),round(35e-1);
|
|
+--------------+----------------+--------------+
|
|
| round(25e-1) | round(25.3e-1) | round(35e-1) |
|
|
+--------------+----------------+--------------+
|
|
| 3 | 3 | 4 |
|
|
+--------------+----------------+--------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### CEIL
|
|
|
|
**声明**
|
|
|
|
`CEIL(expr)`
|
|
|
|
**说明**
|
|
|
|
返回大于或者等于指定表达式的最小整数。
|
|
|
|
还支持比较运算，结果为 BOOL 值，被转化为数字类型处理，产生的结果为 1(TRUE)、0 (FALSE)；
|
|
|
|
如果输入 NULL，返回值为 NULL。
|
|
|
|
如果输入纯数字的字符串，支持自动转换成数字类型。
|
|
|
|
返回值会被转化为一个 BIGINT。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>select ceil(1.2), ceil(-1.2), ceil(1+1.5), ceil(1=1),ceil(1<1),ceil(null);
|
|
+-----------+------------+-------------+-----------+-----------+------------+
|
|
| ceil(1.2) | ceil(-1.2) | ceil(1+1.5) | ceil(1=1) | ceil(1<1) | ceil(null) |
|
|
+-----------+------------+-------------+-----------+-----------+------------+
|
|
| 2 | -1 | 3 | 1 | 0 | NULL |
|
|
+-----------+------------+-------------+-----------+-----------+------------+
|
|
1 row in set (0.00 sec)
|
|
|
|
obclient>select ceil(name);
|
|
ERROR 1166 (42703): Unkown column name 'name'
|
|
|
|
obclient>select ceil('2');
|
|
+-----------+
|
|
| ceil('2') |
|
|
+-----------+
|
|
| 2 |
|
|
+-----------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### FLOOR
|
|
|
|
**声明**
|
|
|
|
`FLOOR(expr)`
|
|
|
|
**说明**
|
|
|
|
和 CEIL(expr) 函数功能类似，返回小于或者等于指定表达式的最大整数。
|
|
|
|
还支持比较运算，结果为 BOOL 值，被转化为数字类型处理，产生的结果为 1(TRUE)、0 (FALSE)；
|
|
|
|
如果输入 NULL，返回值为 NULL。
|
|
|
|
如果输入纯数字的字符串，支持自动转换成数字类型。
|
|
|
|
返回值会被转化为一个 BIGINT。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>select floor(1.2), floor(-1.2), floor(1+1.5), floor(1=1),floor(1<1),floor(null);
|
|
+------------+-------------+--------------+------------+------------+-------------+
|
|
| floor(1.2) | floor(-1.2) | floor(1+1.5) | floor(1=1) | floor(1<1) | floor(null) |
|
|
+------------+-------------+--------------+------------+------------+-------------+
|
|
| 1 | -2 | 2 | 1 | 0 | NULL |
|
|
+------------+-------------+--------------+------------+------------+-------------+
|
|
1 row in set (0.00 sec)
|
|
|
|
obclient>select floor(name);
|
|
ERROR 1166 (42703): Unkown column name 'name'
|
|
|
|
obclient>select floor('2');
|
|
+------------+
|
|
| floor('2') |
|
|
+------------+
|
|
| 2 |
|
|
+------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### ABS
|
|
|
|
**声明**
|
|
|
|
`ABS(expr)`
|
|
|
|
**说明**
|
|
|
|
绝对值函数，求表达式绝对值，函数返回值类型与数值表达式的数据类型相同。
|
|
|
|
还支持比较运算，结果为 BOOL 值，被转化为数字类型处理，产生的结果为 1(TRUE)、0 (FALSE)；
|
|
|
|
如果输入 NULL，返回值为 NULL。
|
|
|
|
如果输入纯数字的字符串，支持自动转换成数字类型。
|
|
|
|
返回值会被转化为一个 BIGINT。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>select abs(5), abs(-5.777), abs(0), abs(1/2), abs(1-5);
|
|
+--------+-------------+--------+----------+----------+
|
|
| abs(5) | abs(-5.777) | abs(0) | abs(1/2) | abs(1-5) |
|
|
+--------+-------------+--------+----------+----------+
|
|
| 5 | 5.777 | 0 | 0.5000 | 4 |
|
|
+--------+-------------+--------+----------+----------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### NEG
|
|
|
|
**声明**
|
|
|
|
`NEG(expr)`
|
|
|
|
**说明**
|
|
|
|
求补函数，对操作数执行求补运算：用零减去操作数，然后结果返回操作数。
|
|
|
|
支持比较运算，结果为 BOOL 值，被转化为数字类型处理，产生的结果为 1(TRUE)、0 (FALSE)，再对结果求补。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>select neg(1), neg(1+1), neg(2*3), neg(1=1), neg(5<1);
|
|
+--------+----------+----------+----------+----------+
|
|
| neg(1) | neg(1+1) | neg(2*3) | neg(1=1) | neg(5<1) |
|
|
+--------+----------+----------+----------+----------+
|
|
| -1 | -2 | -6 | -1 | 0 |
|
|
+--------+----------+----------+----------+----------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### SIGN
|
|
|
|
**声明**
|
|
|
|
`SIGN(X)`
|
|
|
|
**说明**
|
|
|
|
SIGN(X) 返回参数作为 -1、 0 或 1 的符号，该符号取决于 X 的值为负、零或正。
|
|
|
|
支持比较运算，结果为 BOOL 值，被转化为数字类型处理，产生的结果为 1(TRUE)、0 (FALSE)；
|
|
|
|
如果输入 NULL，返回值为 NULL。
|
|
|
|
支持浮点数、十六进制数。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>SELECT SIGN(-32), SIGN(0), SIGN(234);
|
|
+-----------+---------+-----------+
|
|
| SIGN(-32) | SIGN(0) | SIGN(234) |
|
|
+-----------+---------+-----------+
|
|
| -1 | 0 | 1 |
|
|
+-----------+---------+-----------+
|
|
1 row in set (0.01 sec)
|
|
|
|
obclient>select sign(null),sign(false),sign(0x01);
|
|
+------------+-------------+------------+
|
|
| sign(null) | sign(false) | sign(0x01) |
|
|
+------------+-------------+------------+
|
|
| NULL | 0 | 1 |
|
|
+------------+-------------+------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### CONV
|
|
|
|
**声明**
|
|
|
|
`CONV(N, from_base, to_base)`
|
|
|
|
**说明**
|
|
|
|
不同数基间转换数字。返回值为一个字符串，由 from_base 基转化为 to_base 基。输入参数 N 可以是一个整数或字符串。最小基数为 2，而最大基数则为 36。如果 to_base 是一个负数，则 N 被看作一个带符号数。否则，N 被看作无符号数。from_base 如果是负数，则被当作整数处理，符号被忽略。N 参数仅支持 int 类型和字符串类型输入；from_base 和 to_base 参数仅支持十进制 int 类型输入，且取值范围为 \[-36, -2\] U \[2, 36\]。
|
|
|
|
非法输入将导致报错，其中非法输入包括以下情况：
|
|
|
|
* *from_base 或者 to_base 不是一个合法的十进制int类型输入；*
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* *from_base 或者 to_base 超出 \[-36,-2\] U \[2,36\] 的取值范围；*
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* N 不是一个合法的数字表示，例如取值超出 0～9，a～z，A～Z 的字符范围；
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* N 超出了 from_base 基的取值范围，例如 from_base 为 2，而 N 取值为 3；
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* N 的取值超出了 int64 的最大表示范围，即 \[-9223372036854775807, 9223372036854775807\]。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>select conv(9223372036854775807,10,2);
|
|
+-----------------------------------------------------------------+
|
|
| conv(9223372036854775807,10,2) |
|
|
+-----------------------------------------------------------------+
|
|
| 111111111111111111111111111111111111111111111111111111111111111 |
|
|
+-----------------------------------------------------------------+
|
|
1 row in set (0.00 sec)
|
|
|
|
obclient>select conv('-acc',21,-7);
|
|
+--------------------+
|
|
| conv('-acc',21,-7) |
|
|
+--------------------+
|
|
| -16425 |
|
|
+--------------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### MOD
|
|
|
|
**声明**
|
|
|
|
`MOD(N,M)`
|
|
|
|
**说明**
|
|
|
|
取余函数。MOD(N，M)， N % M， N MOD M 三种形式是等效的。
|
|
|
|
MOD() 对于带有小数部分的数值也起作用，它返回除法运算后的精确余数。
|
|
|
|
N,M 中任何一个参数为 NULL，返回值都为 NULL。M 为 0 时，也返回 NULL。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>select mod(29,19), 29 mod 19, 29 % 19;
|
|
+------------+-----------+---------+
|
|
| mod(29,19) | 29 mod 19 | 29 % 19 |
|
|
+------------+-----------+---------+
|
|
| 10 | 10 | 10 |
|
|
+------------+-----------+---------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### POW
|
|
|
|
**声明**
|
|
|
|
`POW(X,Y)`
|
|
|
|
**说明**
|
|
|
|
返回 X 的 Y 次方。
|
|
|
|
X 与 Y 中任何一个参数为 NULL，返回值都为 NULL。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>select pow(4,2), pow(4,-2), pow(1,null);
|
|
+----------+-----------+-------------+
|
|
| pow(4,2) | pow(4,-2) | pow(1,null) |
|
|
+----------+-----------+-------------+
|
|
| 16 | 0.0625 | NULL |
|
|
+----------+-----------+-------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### POWER
|
|
|
|
**声明**
|
|
|
|
`POWER(X,Y)`
|
|
|
|
**说明**
|
|
|
|
POWER(X,Y) 和 POW(X,Y) 是同义函数。
|
|
|
|
|
|
|
|
#### RAND
|
|
|
|
**声明**
|
|
|
|
`rand([N])`
|
|
|
|
**说明**
|
|
|
|
RAND(\[N\]) 函数接受 0 个或者 1 个参数（N 被称为随机数种子），返回一个范围是 \[0,1.0) 的随机浮点数。如果想获得一个范围在 \[i, j) 的随机整数，可以使用表达式 FLOOR(I + RAND() \* (j - i))。
|
|
|
|
如果参数 N 不指定，那么在执行之前会使用随机种子初始化，之后 RAND() 会根据这个初始化值来生成随机数，所以 RAND() 每次会生成不同的随机数序列。
|
|
|
|
如果参数 N 指定，那么 N 会作为随机数种子来生成随机数。根据 N 是否是常量，分成以下两种情况：
|
|
|
|
* 如果 N 是常量，那么 N 在执行之前会被当成随机种子初始化，之后 RAND(N) 会根据这个初始化值来生成随机数。相同的 N 值会生成相同的随机数序列。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
* 如果 N 是变量(比如 N 是一个列值)，那么 N 会在每次执行的时候作为随机数种子来生成随机数。相同的 N 值会生成相同的随机数。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
除了出现在 Select 语句中，RAND(\[N\]) 也可以出现在 where，order by 和 group by 语句中，它的执行方式还是按照上述规则执行。比如，如果想随机的对一个表进行排序，可以使用如下 SQL：select from t1 order by rand()。如果想随机取样一个表的 100 行，可以使用如下 SQL：select from t1 order by rand() limit 100。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient> select a, b, rand() from t3;
|
|
+------+------+---------------------+
|
|
| a | b | rand() |
|
|
+------+------+---------------------+
|
|
| 1 | 1 | 0.641815407799385 |
|
|
| 2 | 2 | 0.16825051248841966 |
|
|
| 3 | 3 | 0.9158063697775886 |
|
|
+------+------+---------------------+
|
|
3 rows in set (0.00 sec)
|
|
|
|
obclient> select a, b, rand() from t3;
|
|
+------+------+---------------------+
|
|
| a | b | rand() |
|
|
+------+------+---------------------+
|
|
| 1 | 1 | 0.07428034215632857 |
|
|
| 2 | 2 | 0.6239826321825224 |
|
|
| 3 | 3 | 0.897072165177271 |
|
|
+------+------+---------------------+
|
|
3 rows in set (0.00 sec)
|
|
|
|
obclient> select a, b, rand(3) from t3;
|
|
+------+------+---------------------+
|
|
| a | b | rand(3) |
|
|
+------+------+---------------------+
|
|
| 1 | 1 | 0.9057697559760601 |
|
|
| 2 | 2 | 0.37307905813034536 |
|
|
| 3 | 3 | 0.14808605345719125 |
|
|
+------+------+---------------------+
|
|
3 rows in set (0.00 sec)
|
|
|
|
obclient> select a, b, rand(3) from t3;
|
|
+------+------+---------------------+
|
|
| a | b | rand(3) |
|
|
+------+------+---------------------+
|
|
| 1 | 1 | 0.9057697559760601 |
|
|
| 2 | 2 | 0.37307905813034536 |
|
|
| 3 | 3 | 0.14808605345719125 |
|
|
+------+------+---------------------+
|
|
3 rows in set (0.00 sec)
|
|
|
|
obclient> select a, b, rand(a), rand(b) from t3;
|
|
+------+------+---------------------+---------------------+
|
|
| a | b | rand(a) | rand(b) |
|
|
+------+------+---------------------+---------------------+
|
|
| 1 | 1 | 0.40540353712197724 | 0.40540353712197724 |
|
|
| 2 | 2 | 0.6555866465490187 | 0.6555866465490187 |
|
|
| 3 | 3 | 0.9057697559760601 | 0.9057697559760601 |
|
|
+------+------+---------------------+---------------------+
|
|
3 rows in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
比较函数
|
|
-------------
|
|
|
|
#### GREATEST
|
|
|
|
**声明**
|
|
|
|
`GREATEST(value1, ...)`
|
|
|
|
**说明**
|
|
|
|
返回参数的最大值，和函数 LEAST() 相对。
|
|
|
|
参数至少为两个（一个参数将会报错）；如果参数中有 NULL, 返回值为 NULL。
|
|
|
|
当参数中同时存在数值和字符时，把字符隐式转换为数值类型处理，不能转换的报错。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>select greatest(2,1), greatest('2',1,0), greatest('a','b','c'), greatest('a', NULL, 'c'), greatest('2014-05-15','2014-06-01')\G
|
|
* 1. row *
|
|
greatest(2,1): 2
|
|
greatest('2',1,0): 2
|
|
greatest('a','b','c'): c
|
|
greatest('a', NULL, 'c'): NULL
|
|
greatest('2014-05-15','2014-06-01'): 2014-06-01
|
|
1 row in set (0.01 sec)
|
|
obclient>select greatest(2);
|
|
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'greatest'
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### LEAST
|
|
|
|
**声明**
|
|
|
|
`LEAST(value1, ...)`
|
|
|
|
**说明**
|
|
|
|
返回参数的最小值，和函数 GREATEST() 相对。
|
|
|
|
参数至少为两个；如果参数中有 NULL，返回值为 NULL。
|
|
|
|
当参数中同时存在数值和字符时，把字符隐式转换为数值类型处理，不能转换的报错。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>select least(2, null), least('2',4,9), least('a','b','c'), least('a',NULL,'c'), least('2014-05-15','2014-06-01')\G;
|
|
* 1. row *
|
|
least(2, null): NULL
|
|
least('2',4,9): 2
|
|
least('a','b','c'): a
|
|
least('a',NULL,'c'): NULL
|
|
least('2014-05-15','2014-06-01'): 2014-05-15
|
|
1 row in set (0.01 sec)
|
|
obclient>select least(2);
|
|
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'least'
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### ISNULL
|
|
|
|
**声明**
|
|
|
|
`ISNULL(expr)`
|
|
|
|
**说明**
|
|
|
|
如果参数 expr 为 NULL，那么 ISNULL() 的返回值为 1，否则范围值为 0。
|
|
|
|
ISNULL() 函数可以用来替代针对 NULL 的等值（=）比较。（使用 = 的 NULL 值比较通常都是错误的。）ISNULL() 函数同 IS NULL 比较操作符具有一些相同的特性。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>SELECT ISNULL(null), ISNULL('test'), ISNULL(123.456), ISNULL('10:00');
|
|
+--------------+----------------+-----------------+-----------------+
|
|
| ISNULL(null) | ISNULL('test') | ISNULL(123.456) | ISNULL('10:00') |
|
|
+--------------+----------------+-----------------+-----------------+
|
|
| 1 | 0 | 0 | 0 |
|
|
+--------------+----------------+-----------------+-----------------+
|
|
1 row in set (0.01 sec)
|
|
|
|
obclient>SELECT ISNULL(null+1);
|
|
+----------------+
|
|
| ISNULL(null+1) |
|
|
+----------------+
|
|
| 1 |
|
|
+----------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
流程控制函数
|
|
---------------
|
|
|
|
#### CASE
|
|
|
|
**声明**
|
|
|
|
```javascript
|
|
CASE value WHEN [compare-value] THEN result [WHEN [compare-value] THEN result ...] [ELSE result] END
|
|
OR
|
|
CASE WHEN [condition] THEN result [WHEN [condition] THEN result ...] [ELSE result] END
|
|
```
|
|
|
|
|
|
|
|
**说明**
|
|
|
|
在第一个方案的返回结果中，value = compare-value。而第二个方案的返回结果是第一种条件为真。如果没有匹配的结果值，则返回结果为 ELSE 后的结果，如果没有 ELSE 部分，则返回值为 NULL。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>select CASE 'b' when 'a' then 1 when 'b' then 2 END;
|
|
+----------------------------------------------+
|
|
| CASE 'b' when 'a' then 1 when 'b' then 2 END |
|
|
+----------------------------------------------+
|
|
| 2 |
|
|
+----------------------------------------------+
|
|
1 row in set (0.01 sec)
|
|
|
|
obclient>select CASE concat('a','b') when concat('ab','') then 'a' when 'b' then 'b' end;
|
|
+--------------------------------------------------------------------------+
|
|
| CASE concat('a','b') when concat('ab','') then 'a' when 'b' then 'b' end |
|
|
+--------------------------------------------------------------------------+
|
|
| a |
|
|
+--------------------------------------------------------------------------+
|
|
1 row in set (0.01 sec)
|
|
|
|
obclient>select case when 1>0 then 'true' else 'false' end;
|
|
+--------------------------------------------+
|
|
| case when 1>0 then 'true' else 'false' end |
|
|
+--------------------------------------------+
|
|
| true |
|
|
+--------------------------------------------+
|
|
1 row in set (0.00 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### IF
|
|
|
|
**声明**
|
|
|
|
`IF(expr1,expr2,expr3)`
|
|
|
|
**说明**
|
|
|
|
如果 expr1 的值为 TRUE（即：expr1\<\>0 且 expr1\<\>NULL），返回结果为 expr2; 否则返回结果为 expr3。
|
|
|
|
IF() 返回结果可以是数值或字符串类型，它取决于使用的内容。
|
|
|
|
如果 expr2, expr3 中只有一个明确是 NULL，则 IF() 函数的结果类型为非 NULL 表达式的结果类型。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>select if(5>6, 'T','F'), if (5>6, 1, 0), if(null, 'True', 'False'), if(0, 'True', 'False')\G
|
|
* 1. row *
|
|
if(5>6, 'T','F'): F
|
|
if (5>6, 1, 0): 0
|
|
if(null, 'True', 'False'): False
|
|
if(0, 'True', 'False'): False
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### IFNULL
|
|
|
|
**声明**
|
|
|
|
`IFNULL(expr1, expr2)`
|
|
|
|
**说明**
|
|
|
|
假设 expr1 不为 NULL，则 IFNULL() 的返回值为 expr1; 否则其返回值为 expr2。IFNULL() 的返回值是数值或字符串，具体情况取决于其所使用的语境。
|
|
|
|
IF() 的默认返回值类型按照以下方式计算：
|
|
|
|
|
|
| 表达式 | 返回值 |
|
|
|--------------------------|-----|
|
|
| expr1 或 expr2 返回值为一个字符串。 | 字符串 |
|
|
| expr1 或 expr2 返回值为一个浮点值。 | 浮点 |
|
|
| expr1 或 expr2 返回值为一个整数。 | 整数 |
|
|
|
|
|
|
|
|
假如 expr1 和 expr2 都是字符串，且其中任何一个字符串区分大小写，则返回结果是区分大小写。
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>SELECT IFNULL('abc', null), IFNULL(NULL+1, NULL+2), IFNULL(1/0, 0/1);
|
|
+---------------------+------------------------+------------------+
|
|
| IFNULL('abc', null) | IFNULL(NULL+1, NULL+2) | IFNULL(1/0, 0/1) |
|
|
+---------------------+------------------------+------------------+
|
|
| abc | NULL | 0.0000 |
|
|
+---------------------+------------------------+------------------+
|
|
1 row in set (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### NULLIF
|
|
|
|
**声明**
|
|
|
|
`NULLIF(expr1, expr2)`
|
|
|
|
**说明**
|
|
|
|
如果 expr1 = expr2 成立，那么返回值为 NULL，否则返回值为 expr1。这和 CASE WHEN
|
|
|
|
*expr1 = expr2 THEN NULL ELSE expr1 END 相同。注意，如果参数不相等，则两次求得的值为 expr1。*
|
|
|
|
**例子**
|
|
|
|
```javascript
|
|
obclient>SELECT NULLIF('ABC', 123), NULLIF('123',123), NULLIF(NULL, 'abc');
|
|
+--------------------+-------------------+---------------------+
|
|
| NULLIF('ABC', 123) | NULLIF('123',123) | NULLIF(NULL, 'abc') |
|
|
+--------------------+-------------------+---------------------+
|
|
| ABC | NULL | NULL |
|
|
+--------------------+-------------------+---------------------+
|
|
1 row in set, 1 warning (0.01 sec)
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### ORA_DECODE
|
|
|
|
**声明**
|
|
|
|
`ora_decode(条件, 值1, 返回值1, 值2, 返回值2, ... 值n, 返回值n, 缺省值)`
|
|
|
|
**说明**
|
|
|
|
ORA_DECODE() 函数功能等同于 Oracle 的 DECODE() 函数功能。
|
|
|
|
该函数的含义如下:
|
|
|
|
```javascript
|
|
IF 条件=值1
|
|
THEN RETURN(返回值1)
|
|
ELSIF 条件=值2
|
|
THEN RETURN(返回值2)
|
|
......
|
|
ELSIF 条件=值n
|
|
THEN RETURN(返回值n)
|
|
ELSE RETURN(缺省值)
|
|
END IF
|
|
```
|
|
|
|
|