全部产品
云市场

单行函数

更新时间:2019-09-18 13:14:26

日期时间函数

日期时间函数主要用来显示有关日期和时间的信息。

CURDATE

声明

  1. CURDATE()

说明

返回当前日期,不含时间部分。

例子

  1. OceanBase (root@test)> SELECT CURDATE();
  2. +------------+
  3. | CURDATE() |
  4. +------------+
  5. | 2018-05-05 |
  6. +------------+
  7. 1 row in set (0.00 sec)

CURRENT_DATE

声明

  1. CURRENT_DATE()
  2. CURRENT_DATE

说明

CURDATE()

CURRENT_TIME

声明

  1. CURRENT_TIME([scale])

说明

返回当前时间,不含日期部分。

scale有效值为0到6,表示微秒部分精度,默认值为0。

例子

  1. OceanBase (root@test)> SELECT CURRENT_TIME(6);
  2. +-----------------+
  3. | CURRENT_TIME(6) |
  4. +-----------------+
  5. | 11:11:45.215311 |
  6. +-----------------+
  7. 1 row in set (0.01 sec)

CURRENT_TIMESTAMP

声明

  1. CURRENT_TIMESTAMP([scale])

说明

返回当前日期时间,考虑时区设置。

scale有效值为0到6,表示微秒部分精度,默认值为0。

例子

  1. OceanBase (root@test)> SELECT CURRENT_TIMESTAMP(6);
  2. +----------------------------+
  3. | CURRENT_TIMESTAMP(6) |
  4. +----------------------------+
  5. | 2018-05-05 11:35:39.177764 |
  6. +----------------------------+
  7. 1 row in set (0.01 sec)

CURTIME

声明

  1. CURTIME()

说明

CURRENT_TIME()

DATE_ADD

声明

  1. 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'

例子

  1. OceanBase (root@test)> SELECT
  2. -> DATE_ADD(NOW(), INTERVAL 5 DAY),
  3. -> DATE_ADD('2014-01-10', INTERVAL 5 MICROSECOND),
  4. -> DATE_ADD('2014-01-10', INTERVAL 5 SECOND),
  5. -> DATE_ADD('2014-01-10', INTERVAL 5 MINUTE),
  6. -> DATE_ADD('2014-01-10', INTERVAL 5 HOUR),
  7. -> DATE_ADD('2014-01-10', INTERVAL 5 DAY),
  8. -> DATE_ADD('2014-01-10', INTERVAL 5 WEEK),
  9. -> DATE_ADD('2014-01-10', INTERVAL 5 MONTH),
  10. -> DATE_ADD('2014-01-10', INTERVAL 5 QUARTER),
  11. -> DATE_ADD('2014-01-10', INTERVAL 5 YEAR),
  12. -> DATE_ADD('2014-01-10', INTERVAL '5.000005' SECOND_MICROSECOND),
  13. -> DATE_ADD('2014-01-10', INTERVAL '05:05.000005' MINUTE_MICROSECOND),
  14. -> DATE_ADD('2014-01-10', INTERVAL '05:05' MINUTE_SECOND),
  15. -> DATE_ADD('2014-01-10', INTERVAL '05:05:05.000005' HOUR_MICROSECOND),
  16. -> DATE_ADD('2014-01-10', INTERVAL '05:05:05' HOUR_SECOND),
  17. -> DATE_ADD('2014-01-10', INTERVAL '05:05' HOUR_MINUTE),
  18. -> DATE_ADD('2014-01-10', INTERVAL '01 05:05:05.000005' DAY_MICROSECOND),
  19. -> DATE_ADD('2014-01-10', INTERVAL '01 05:05:05' DAY_SECOND),
  20. -> DATE_ADD('2014-01-10', INTERVAL '01 05:05' DAY_MINUTE),
  21. -> DATE_ADD('2014-01-10', INTERVAL '01 05' DAY_HOUR),
  22. -> DATE_ADD('2014-01-10', INTERVAL '1-01' YEAR_MONTH)
  23. -> \G
  24. *************************** 1. row ***************************
  25. DATE_ADD(NOW(), INTERVAL 5 DAY): 2018-05-10 14:54:52
  26. DATE_ADD('2014-01-10', INTERVAL 5 MICROSECOND): 2014-01-10 00:00:00.000005
  27. DATE_ADD('2014-01-10', INTERVAL 5 SECOND): 2014-01-10 00:00:05
  28. DATE_ADD('2014-01-10', INTERVAL 5 MINUTE): 2014-01-10 00:05:00
  29. DATE_ADD('2014-01-10', INTERVAL 5 HOUR): 2014-01-10 05:00:00
  30. DATE_ADD('2014-01-10', INTERVAL 5 DAY): 2014-01-15
  31. DATE_ADD('2014-01-10', INTERVAL 5 WEEK): 2014-02-14
  32. DATE_ADD('2014-01-10', INTERVAL 5 MONTH): 2014-06-10
  33. DATE_ADD('2014-01-10', INTERVAL 5 QUARTER): 2015-04-10
  34. DATE_ADD('2014-01-10', INTERVAL 5 YEAR): 2019-01-10
  35. DATE_ADD('2014-01-10', INTERVAL '5.000005' SECOND_MICROSECOND): 2014-01-10 00:00:05.000005
  36. DATE_ADD('2014-01-10', INTERVAL '05:05.000005' MINUTE_MICROSECOND): 2014-01-10 00:05:05.000005
  37. DATE_ADD('2014-01-10', INTERVAL '05:05' MINUTE_SECOND): 2014-01-10 00:05:05
  38. DATE_ADD('2014-01-10', INTERVAL '05:05:05.000005' HOUR_MICROSECOND): 2014-01-10 05:05:05.000005
  39. DATE_ADD('2014-01-10', INTERVAL '05:05:05' HOUR_SECOND): 2014-01-10 05:05:05
  40. DATE_ADD('2014-01-10', INTERVAL '05:05' HOUR_MINUTE): 2014-01-10 05:05:00
  41. DATE_ADD('2014-01-10', INTERVAL '01 05:05:05.000005' DAY_MICROSECOND): 2014-01-11 05:05:05.000005
  42. DATE_ADD('2014-01-10', INTERVAL '01 05:05:05' DAY_SECOND): 2014-01-11 05:05:05
  43. DATE_ADD('2014-01-10', INTERVAL '01 05:05' DAY_MINUTE): 2014-01-11 05:05:00
  44. DATE_ADD('2014-01-10', INTERVAL '01 05' DAY_HOUR): 2014-01-11 05:00:00
  45. DATE_ADD('2014-01-10', INTERVAL '1-01' YEAR_MONTH): 2015-02-10
  46. 1 row in set (0.01 sec)

DATE_FORMAT

声明

  1. 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 两位年份。
%% 文字字符,输出一个%

例子

  1. OceanBase (root@test)> SELECT
  2. -> DATE_FORMAT('2014-01-01', '%Y-%M-%d'),
  3. -> DATE_FORMAT('2014-01-01', '%X-%V'),
  4. -> DATE_FORMAT('2014-01-01', '%U')
  5. -> \G
  6. *************************** 1. row ***************************
  7. DATE_FORMAT('2014-01-01', '%Y-%M-%d'): 2014-January-01
  8. DATE_FORMAT('2014-01-01', '%X-%V'): 2013-52
  9. DATE_FORMAT('2014-01-01', '%U'): 00
  10. 1 row in set (0.01 sec)

DATE_SUB

声明

  1. DATE_SUB(date, INTERVAL expr unit)

说明

日期时间的算术计算。

请参考DATE_ADD()

DATEDIFF

声明

  1. DATEDIFF(date1, date2)

说明

返回date1date2之间的天数。

计算中只用到参数的日期部分,忽略时间部分。

例子

  1. OceanBase (root@test)> SELECT DATEDIFF('2015-06-19','1994-12-17');
  2. +-------------------------------------+
  3. | DATEDIFF('2015-06-19','1994-12-17') |
  4. +-------------------------------------+
  5. | 7489 |
  6. +-------------------------------------+
  7. 1 row in set (0.01 sec)

EXTRACT

声明

  1. EXTRACT(unit FROM date)

说明

以整数类型返回date的指定部分值。如果指定多个部分,则将所有值按顺序拼接。

unit请参考DATE_ADD()。当unitWEEK时,请参考DATE_FORMAT()%U说明

例子

  1. SELECT EXTRACT(WEEK FROM '2013-01-01'),
  2. EXTRACT(WEEK FROM '2013-01-06'),
  3. EXTRACT(YEAR_MONTH FROM '2012-03-09'),
  4. EXTRACT(DAY FROM NOW())\G;
  5. * 1. row *
  6. EXTRACT(WEEK FROM '2013-01-01'): 0
  7. EXTRACT(WEEK FROM '2013-01-06'): 1
  8. EXTRACT(YEAR_MONTH FROM '2012-03-09'): 201203
  9. EXTRACT(DAY FROM NOW()): 18
  10. 1 row in set (0.00 sec)

FROM_DAYS

声明

  1. FROM_DAYS(N)

说明

返回指定天数N对应的DATE值。天数指距离0000-01-01的天数。

例子

  1. OceanBase (root@test)> SELECT FROM_DAYS(736271), FROM_DAYS(700000);
  2. +-------------------+-------------------+
  3. | FROM_DAYS(736271) | FROM_DAYS(700000) |
  4. +-------------------+-------------------+
  5. | 2015-11-04 | 1916-07-15 |
  6. +-------------------+-------------------+
  7. 1 row in set (0.00 sec)

FROM_UNIXTIME

声明

  1. FROM_UNIXTIME(unix_timestamp)
  2. FROM_UNIXTIME(unix_timestamp, format)

说明

  • 不指定format参数时,返回DATETIME类型值,不考虑时区。

  • 指定format参数时,返回指定格式的日期时间字符串。

unix_timestamp指UNIX时间戳,即距离1970-01-01 00:00:00.000000的微秒数。

format支持的格式已在DATE_FORMAT()说明中列出。

例子

  1. OceanBase (root@test)> SELECT FROM_UNIXTIME(UNIX_TIMESTAMP(), '%Y %D %M %h:%i:%s %x');
  2. +---------------------------------------------------------+
  3. | FROM_UNIXTIME(UNIX_TIMESTAMP(), '%Y %D %M %h:%i:%s %x') |
  4. +---------------------------------------------------------+
  5. | 2018 5th May 08:41:26 2018 |
  6. +---------------------------------------------------------+
  7. 1 row in set (0.01 sec)

MONTH

声明

  1. MONTH(date)

说明

返回date的月份信息。

例子

  1. OceanBase (root@test)> SELECT MONTH('2008-02-03');
  2. +---------------------+
  3. | MONTH('2008-02-03') |
  4. +---------------------+
  5. | 2 |
  6. +---------------------+
  7. 1 row in set (0.01 sec)

NOW

声明

  1. NOW([scale])

说明

CURRENT_TIMESTAMP()

PERIOD_DIFF

声明

  1. PERIOD_DIFF(p1, p2)

说明

以月份位单位返回两个日期之间的间隔。日期只能包含年月信息,格式只能为YYYYMMYYMM

例子

  1. OceanBase (root@test)> SELECT PERIOD_DIFF(200802, 200703);
  2. +----------------------------+
  3. | PERIOD_DIFF(200802,200703) |
  4. +----------------------------+
  5. | 11 |
  6. +----------------------------+
  7. 1 row in set (0.01 sec)

STR_TO_DATE

声明

  1. STR_TO_DATE(str, format)

说明

使用formatstr转换为DATETIME值、DATE值、或TIME值。返回值类型取决于format包含日期时间的哪些部分。

format支持的格式已在DATE_FORMAT()说明中列出。

例子

  1. OceanBase (root@test)> SELECT STR_TO_DATE('2014-Jan-1st 5:5:5 pm', '%Y-%b-%D %r');
  2. +-----------------------------------------------------+
  3. | STR_TO_DATE('2014-Jan-1st 5:5:5 pm', '%Y-%b-%D %r') |
  4. +-----------------------------------------------------+
  5. | 2014-01-01 05:05:05 |
  6. +-----------------------------------------------------+
  7. 1 row in set (0.01 sec)

TIME

声明

  1. TIME(datetime)

说明

TIME类型返回datetime的时间信息。

例子

  1. OceanBase (root@test)> SELECT TIME('2003-12-31 01:02:03');
  2. +-----------------------------+
  3. | TIME('2003-12-31 01:02:03') |
  4. +-----------------------------+
  5. | 01:02:03.000000 |
  6. +-----------------------------+
  7. 1 row in set (0.01 sec)

TIME_TO_USEC

声明

  1. TIME_TO_USEC(date)

说明

date值转换为距离1970-01-01 00:00:00.000000的微秒数,考虑时区信息。

date可以表示日期,也可以表示日期时间。

例子

  1. OceanBase (root@test)> SELECT TIME_TO_USEC('2014-03-25'), TIME_TO_USEC(NOW());
  2. +----------------------------+---------------------+
  3. | TIME_TO_USEC('2014-03-25') | TIME_TO_USEC(NOW()) |
  4. +----------------------------+---------------------+
  5. | 1395676800000000 | 1525528100000000 |
  6. +----------------------------+---------------------+
  7. 1 row in set (0.01 sec)

TIMEDIFF

声明

  1. TIMEDIFF(date1, date2)

说明

TIME类型返回两个日期时间的时间间隔。

例子

  1. OceanBase (root@test)> SELECT
  2. -> TIMEDIFF('2015-06-06 12:12:12', '2014-06-05 11:11:11'),
  3. -> TIMEDIFF('2015-06-06 12:12:12', '2015-06-05 11:11:11')
  4. -> \G
  5. *************************** 1. row ***************************
  6. TIMEDIFF('2015-06-06 12:12:12', '2014-06-05 11:11:11'): 838:59:59
  7. TIMEDIFF('2015-06-06 12:12:12', '2015-06-05 11:11:11'): 25:01:01
  8. 1 row in set (0.00 sec)

TIMESTAMPDIFF

声明

  1. TIMESTAMPDIFF(unit, date1, date2)

说明

unit为单位返回两个日期时间的间隔。unit只能为DATE_ADD()中的独立单位。

例子

  1. OceanBase (root@test)> SELECT
  2. -> TIMESTAMPDIFF(SECOND, NOW(), '2011-01-01 11:11:11'),
  3. -> TIMESTAMPDIFF(DAY, '2011-01-01 11:11:11', NOW())
  4. -> \G
  5. *************************** 1. row ***************************
  6. TIMESTAMPDIFF(SECOND, NOW(), '2011-01-01 11:11:11'): -231677498
  7. TIMESTAMPDIFF(DAY, '2011-01-01 11:11:11', NOW()): 2681
  8. 1 row in set (0.00 sec)

TIMESTAMPADD

声明

  1. TIMESTAMPADD(unit, interval_expr, date)

说明

日期时间的算术计算。

DATE_ADD(),但unit只能为独立单位。

例子

  1. OceanBase (root@test)> SELECT
  2. -> TIMESTAMPADD(DAY, -5, '2010-01-01 00:00:00'),
  3. -> DATE_ADD('2010-01-01 00:00:00', INTERVAL -5 DAY)
  4. -> \G
  5. *************************** 1. row ***************************
  6. TIMESTAMPADD(DAY, -5, '2010-01-01 00:00:00'): 2009-12-27 00:00:00
  7. DATE_ADD('2010-01-01 00:00:00', INTERVAL -5 DAY): 2009-12-27 00:00:00
  8. 1 row in set (0.01 sec)

TO_DAYS

声明

  1. TO_DAYS(date)

说明

返回指定date值对应的天数。天数指距离0000-01-01的天数。

例子

  1. OceanBase (root@test)> SELECT TO_DAYS('2015-11-04'), TO_DAYS('20151104');
  2. +-----------------------+---------------------+
  3. | TO_DAYS('2015-11-04') | TO_DAYS('20151104') |
  4. +-----------------------+---------------------+
  5. | 736271 | 736271 |
  6. +-----------------------+---------------------+
  7. 1 row in set (0.01 sec)

USEC_TO_TIME

声明

  1. USEC_TO_TIME(usec)

说明

usec值转换为TIMESTAMP类型值。

usec表示距离1970-01-01 00:00:00.000000的微秒数,考虑时区信息。

例子

  1. OceanBase (root@test)> SELECT USEC_TO_TIME(1);
  2. +----------------------------+
  3. | USEC_TO_TIME(1) |
  4. +----------------------------+
  5. | 1970-01-01 08:00:00.000001 |
  6. +----------------------------+
  7. 1 row in set (0.00 sec)

UNIX_TIMESTAMP

声明

  1. UNIX_TIMESTAMP()
  2. UNIX_TIMESTAMP(date)

说明

  • 不指定date参数时,返回当前时间距离’1970-01-01 00:00:00’的秒数,考虑时区。

  • 指定date参数时,返回指定时间距离’1970-01-01 00:00:00’的秒数,考虑时区。

例子

  1. OceanBase (root@test)> SELECT UNIX_TIMESTAMP(), TIME_TO_USEC(NOW());
  2. +------------------+---------------------+
  3. | UNIX_TIMESTAMP() | TIME_TO_USEC(NOW()) |
  4. +------------------+---------------------+
  5. | 1525570561 | 1525570561000000 |
  6. +------------------+---------------------+
  7. 1 row in set (0.01 sec)
  8. OceanBase (root@test)> SELECT UNIX_TIMESTAMP('1997-10-04 22:23:00');
  9. +---------------------------------------+
  10. | UNIX_TIMESTAMP('1997-10-04 22:23:00') |
  11. +---------------------------------------+
  12. | 875974980 |
  13. +---------------------------------------+
  14. 1 row in set (0.01 sec)

UTC_TIMESTAMP

声明

  1. UTC_TIMESTAMP()

说明

返回当前UTC时间。

例子

  1. OceanBase (root@test)> SELECT UTC_TIMESTAMP();
  2. +---------------------+
  3. | UTC_TIMESTAMP() |
  4. +---------------------+
  5. | 2018-05-06 01:38:32 |
  6. +---------------------+
  7. 1 row in set (0.01 sec)

YEAR

声明

  1. YEAR(date)

说明

返回date值的年份信息。

例子

  1. OceanBase (root@test)> SELECT YEAR('1987-01-01');
  2. +--------------------+
  3. | YEAR('1987-01-01') |
  4. +--------------------+
  5. | 1987 |
  6. +--------------------+
  7. 1 row in set (0.00 sec)

字符串函数

CONCAT

声明

  1. CONCAT(str1, .., strN)

说明

把多个字符串连接成一个字符串。参数中包含NULL时,返回NULL

例子

  1. OceanBase (root@test)> SELECT
  2. -> CONCAT('test','OceanBase', '1.0'),
  3. -> CONCAT('test','OceanBase', NULL)
  4. -> \G
  5. *************************** 1. row ***************************
  6. CONCAT('test','OceanBase', '1.0'): testOceanBase1.0
  7. CONCAT('test','OceanBase', NULL): NULL
  8. 1 row in set (0.01 sec)

CONCAT_WS

声明

  1. CONCAT_WS(separator, str1, .., strN)

说明

把多个字符串连接成一个字符串,相邻字符串间使用separator分隔。参数中包含NULL时,将忽略NULL

例子

  1. OceanBase (root@test)> SELECT
  2. -> CONCAT_WS('_', 'First', 'Second'),
  3. -> CONCAT_WS('_', 'First', NULL, 'Second')
  4. -> \G
  5. *************************** 1. row ***************************
  6. CONCAT_WS('_', 'First', 'Second'): First_Second
  7. CONCAT_WS('_', 'First', NULL, 'Second'): First_Second
  8. 1 row in set (0.00 sec)

SUBSTR

声明

  1. SUBSTR(str, pos)
  2. SUBSTR(str, pos, len)
  3. SUBSTR(str FROM pos)
  4. SUBSTR(str FROM pos FOR len)

说明

返回str的子字符串,起始位置为pos,长度为len。参数中包含NULL时,返回NULL

  • 不指定len时,返回的子字符串从pos位置开始到str结尾。

  • pos值为负数时,从str尾部向头部倒序确定起始位置。

  • len小于等于0,或pos指定的起始位置非法时,返回空字符串。

例子

  1. OceanBase (root@test)> SELECT
  2. -> SUBSTR('abcdefg', 3),
  3. -> SUBSTR('abcdefg', 3, 2),
  4. -> SUBSTR('abcdefg', -3),
  5. -> SUBSTR('abcdefg', 3, -2),
  6. -> SUBSTR('abcdefg' from -4 for 2)
  7. -> \G
  8. *************************** 1. row ***************************
  9. SUBSTR('abcdefg', 3): cdefg
  10. SUBSTR('abcdefg', 3, 2): cd
  11. SUBSTR('abcdefg', -3): efg
  12. SUBSTR('abcdefg', 3, -2):
  13. SUBSTR('abcdefg' from -4 for 2): de
  14. 1 row in set (0.01 sec)

SUBSTRING

声明

  1. SUBSTRING(str, pos)
  2. SUBSTRING(str, pos, len)
  3. SUBSTRING(str FROM pos)
  4. SUBSTRING(str FROM pos FOR len)

说明

SUBSTR

TRIM

声明

  1. TRIM([[{BOTH | LEADING | TRAILING}] [remstr] FROM] str)

说明

删除字符串所有前缀和/或后缀,默认为BOTH。参数中包含NULL时,返回NULL

例子

  1. OceanBase (root@test)> SELECT
  2. -> TRIM(' bar '),
  3. -> TRIM(LEADING 'x' FROM 'xxxbarxxx'),
  4. -> TRIM(BOTH 'x' FROM 'xxxbarxxx'),
  5. -> TRIM(TRAILING 'x' FROM 'xxxbarxxx')
  6. -> \G
  7. *************************** 1. row ***************************
  8. TRIM(' bar '): bar
  9. TRIM(LEADING 'x' FROM 'xxxbarxxx'): barxxx
  10. TRIM(BOTH 'x' FROM 'xxxbarxxx'): bar
  11. TRIM(TRAILING 'x' FROM 'xxxbarxxx'): xxxbar
  12. 1 row in set (0.01 sec)

LTRIM

声明

  1. LTRIM(str)

说明

删除字符串左侧的空格。

RTRIM

声明

  1. RTRIM(str)

说明

删除字符串右侧的空格。

ASCII

声明

  1. ASCII(str)

说明

返回字符串最左侧字符的ASCII码。

ORD

声明

  1. ORD(str)

说明

返回字符串最左侧字符的字符码。单字节编码如果最左侧字符是多字节编码字符,返回值计算规则如下:

  1. (1st byte code)
  2. + (2nd byte code * 256)
  3. + (3rd byte code * 256^2) ...

例子

  1. OceanBase (root@test)> SELECT ORD('中国');
  2. +---------------+
  3. | ORD('中国') |
  4. +---------------+
  5. | 14989485 |
  6. +---------------+
  7. 1 row in set (0.01 sec)

LENGTH

声明

  1. LENGTH(str)

说明

返回str的字节长度。

例子

  1. OceanBase (root@test)> SELECT LENGTH('中国'), LENGTH('hello');
  2. +------------------+-----------------+
  3. | LENGTH('中国') | LENGTH('hello') |
  4. +------------------+-----------------+
  5. | 6 | 5 |
  6. +------------------+-----------------+
  7. 1 row in set (0.01 sec)

CHAR_LENGTH

声明

  1. CHAR_LENGTH(str)

说明

返回字符串包含的字符数。

例子

  1. OceanBase (root@test)> SELECT CHAR_LENGTH('中国'), CHAR_LENGTH('hello');
  2. +-----------------------+----------------------+
  3. | CHAR_LENGTH('中国') | CHAR_LENGTH('hello') |
  4. +-----------------------+----------------------+
  5. | 2 | 5 |
  6. +-----------------------+----------------------+
  7. 1 row in set (0.00 sec)

UPPER

声明

  1. UPPER(str)

说明

将字符串中的小写字母转化为大写字母。

例子

  1. OceanBase (root@test)> SELECT UPPER('OceanBase您好!');
  2. +-----------------------------+
  3. | UPPER('OceanBase您好!') |
  4. +-----------------------------+
  5. | OCEANBASE您好! |
  6. +-----------------------------+
  7. 1 row in set (0.01 sec)

LOWER

声明

  1. LOWER(str)

说明

将字符串中的大写字母转化为小写字母。

例子

  1. OceanBase (root@test)> SELECT LOWER('OceanBase您好!');
  2. +-----------------------------+
  3. | LOWER('OceanBase您好!') |
  4. +-----------------------------+
  5. | oceanbase您好! |
  6. +-----------------------------+
  7. 1 row in set (0.01 sec)

HEX

声明

  1. HEX(str)

说明

将数字或字符串转化为十六进制字符串。

例子

  1. OceanBase (root@test)> SELECT HEX(255), HEX('abc');
  2. +----------+------------+
  3. | HEX(255) | HEX('abc') |
  4. +----------+------------+
  5. | FF | 616263 |
  6. +----------+------------+
  7. 1 row in set (0.00 sec)

UNHEX

声明

  1. UNHEX(str)

说明

将十六进制字符串转化为正常字符串。

例子

  1. OceanBase (root@test)> SELECT UNHEX('4f6365616e42617365');
  2. +-----------------------------+
  3. | UNHEX('4f6365616e42617365') |
  4. +-----------------------------+
  5. | OceanBase |
  6. +-----------------------------+
  7. 1 row in set (0.00 sec)

MD5

声明

  1. MD5(str)

说明

返回字符串的MD5值。

例子

  1. OceanBase (root@test)> SELECT MD5(1);
  2. +----------------------------------+
  3. | MD5(1) |
  4. +----------------------------------+
  5. | c4ca4238a0b923820dcc509a6f75849b |
  6. +----------------------------------+
  7. 1 row in set (0.00 sec)

INT2IP

声明

  1. INT2IP(int_value)

说明

将整数内码转换成IP地址。

例子

  1. OceanBase (root@test)> SELECT
  2. -> INT2IP(16777216),
  3. -> HEX(16777216),
  4. -> INT2IP(1)
  5. -> \G
  6. *************************** 1. row ***************************
  7. INT2IP(16777216): 1.0.0.0
  8. HEX(16777216): 1000000
  9. INT2IP(1): 0.0.0.1
  10. 1 row in set (0.01 sec)

IP2INT

声明

  1. IP2INT('ip_addr')

说明

将IP地址转换成整数内码。

例子

  1. OceanBase (root@test)> SELECT
  2. -> IP2INT('0.0.0.1'),
  3. -> HEX(IP2INT('0.0.0.1')),
  4. -> HEX(IP2INT('1.0.0.0'))
  5. -> \G
  6. *************************** 1. row ***************************
  7. IP2INT('0.0.0.1'): 1
  8. HEX(IP2INT('0.0.0.1')): 1
  9. HEX(IP2INT('1.0.0.0')): 1000000
  10. 1 row in set (0.01 sec)

LIKE

声明

  1. str1 [NOT] LIKE str2 [ESCAPE str3]

说明

字符串通配符匹配。参数中包含NULL时,返回NULL

通配符包括:

  • %:匹配任意长度字符串。

  • _:匹配单个字符。

ESCAPE用于定义转义符,如果str2中包含str3,在匹配时str3后的字符将做为普通字符处理。

例子

  1. OceanBase (root@test)> SELECT 'ab%' LIKE 'abc%' ESCAPE 'c';
  2. +------------------------------+
  3. | 'ab%' LIKE 'abc%' ESCAPE 'c' |
  4. +------------------------------+
  5. | 1 |
  6. +------------------------------+
  7. 1 row in set (0.01 sec)

REGEXP

声明

  1. str [NOT] REGEXP | RLIKE pat

说明

正则匹配。参数中包含NULL时,返回NULL

例子

  1. OceanBase (root@test)> SELECT
  2. -> 1234 REGEXP 1,
  3. -> 'hello' RLIKE 'h%'
  4. -> \G
  5. *************************** 1. row ***************************
  6. 1234 REGEXP 1: 1
  7. 'hello' RLIKE 'h%': 0
  8. 1 row in set (0.01 sec)

REPEAT

声明

  1. REPEAT(str, count)

说明

返回str重复count次组成的字符串。count小于等于0时,返回空字符串。参数中包含NULL时,返回NULL

例子

  1. OceanBase (root@test)> SELECT
  2. -> REPEAT('1', -1),
  3. -> REPEAT(null, null),
  4. -> REPEAT('Abc', 4)
  5. -> \G
  6. *************************** 1. row ***************************
  7. REPEAT('1', -1):
  8. REPEAT(null, null): NULL
  9. REPEAT('Abc', 4): AbcAbcAbcAbc
  10. 1 row in set (0.01 sec)

SPACE

声明

  1. SPACE(N)

说明

返回包含N个空格的字符串。

SUBSTRING_INDEX

声明

  1. SUBSTRING_INDEX(str, delim, count)

说明

在定界符 delim 以及 count 出现前,从字符串 str 返回字符串。若 count 为正值,则返回最终定界符(从左边开始)左边的一切内容。若 count 为负值,则返回定界符(从右边开始)右边的一切内容。任意一个参数为NULL,返回NULL;若 strdelim 为空字符串,则返回空串;若 count = 0, 返回空串。

str, delim, count 参数支持数值与字符串的隐式转换。

例子

  1. Oceanbase>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;
  2. * 1. row *
  3. substring_index('abcdabc', 'abc', 0):
  4. substring_index('abcdabc', 'abc', 1):
  5. substring_index('abcdabc', 'abc', 2): abcd
  6. substring_index('abcdabc', 'abc', 3): abcdabc
  7. substring_index('abcdabc', 'abc', -1):
  8. substring_index('abcdabc', 'abc', -2): dabc
  9. substring_index('abcdabc', 'abc', -3): abcdabc
  10. 1 row in set (0.00 sec)

LOCATE

声明

LOCATE(substr,str) , LOCATE(substr,str,pos)

说明

第一个语法返回字符串 str 中子字符串 substr 的第一个出现位置。第二个语法返回字符串 str 中子字符串 substr 的第一个出现位置, 起始位置在 pos。如若 substr 不在 str 中,则返回值为 0。

例子

  1. Oceanbase>SELECT LOCATE('bar', 'foobarbar');
  2. -> 4
  3. Oceanbase>SELECT LOCATE('xbar', 'foobar');
  4. -> 0
  5. Oceanbase>SELECT LOCATE('bar', 'foobarbar',5);
  6. -> 7

POSITION

声明

POSITION(substr IN str)

说明

与LOCATE同义。

INSTR

声明

INSTR(str,substr)

说明

返回字符串 str 中子字符串的第一个出现位置。这和 LOCATE() 的双参数形式相同,除非参数的顺序被颠倒。

例子

  1. Oceanbase>SELECT INSTR('foobarbar', 'bar');
  2. -> 4
  3. Oceanbase>SELECT INSTR('xbar', 'foobar');
  4. -> 0

REPLACE

声明

REPLACE(str, from_str, to_str)

说明

返回字符串 str 以及所有被字符 to_str 替代的字符串 from_str

例子

  1. Oceanbase>SELECT REPLACE('abc.efg.gpg.nowdew.abc.dabc.e', 'abc.', 'www');
  2. +---------------------------------------------------------+
  3. | REPLACE('abc.efg.gpg.nowdew.abc.dabc.e', 'abc.', 'www') |
  4. +---------------------------------------------------------+
  5. | wwwefg.gpg.nowdew.wwwdwwwe |
  6. +---------------------------------------------------------+
  7. 1 row in set (0.00 sec)

FIELD

声明

FIELD(str,str1,str2,str3,…)

说明

返回参数 strstr1, str2, str3,… 列表中的索引位置(从1开始的位置)。在找不到 str 的情况下,返回值为0。

如果所有的对于 FIELD() 的参数均为字符串,则所有参数均按照字符串进行比较。如果所有的参数均为数字,则按照数字进行比较。否则,参数均按照 double 类型进行比较。

如果 str 为 NULL,则返回值为 0,原因是 NULL 不能同任何值进行同等比较。FILED() 是 ELT() 的补数。

例子

  1. Oceanbase>select field('abc','abc1','abc2','abc','abc4','abc'), field(NULL, 'null1', NULL);
  2. +-----------------------------------------------+----------------------------+
  3. | field('abc','abc1','abc2','abc','abc4','abc') | field(NULL, 'null1', NULL) |
  4. +-----------------------------------------------+----------------------------+
  5. | 3 | 0 |
  6. +-----------------------------------------------+----------------------------+
  7. 1 row in set (0.00 sec)

ELT

声明

ELT(N, str1, str2, str3,…)

说明

若 N=1,则返回值为 str1, 若 N=2,则返回值为 str2,以此类推。若 N 小于 1 或大于参数的数目,则返回值为NULL。ELT() 是 FIELD() 的补数。

例子

  1. Oceanbase>select elt(3, 'abc1', 'abc2', 'abc', 'abc4', 'abc'), elt(0, 'null1', NULL);
  2. +----------------------------------------------+-----------------------+
  3. | elt(3, 'abc1', 'abc2', 'abc', 'abc4', 'abc') | elt(0, 'null1', NULL) |
  4. +----------------------------------------------+-----------------------+
  5. | abc | NULL |
  6. +----------------------------------------------+-----------------------+
  7. 1 row in set (0.00 sec)

INSERT

声明

INSERT (str1,pos,len,str2)

说明

返回字符串 str1, 字符串中起始于 pos 位置,长度为 len 的子字符串将被 str2 取代。如果 pos 超过字符串长度,则返回值为原始字符串。 假如 len 的长度大于其它字符串的长度,则从位置 pos 开始替换。若任何一个参数为 null,则返回值为 NULL。这个函数支持多字节字元。

  • str1str2 必须是字符串,poslen 必须是整数。任意参数为 NULL,结果总为 NULL。

  • str1str2 中的文字符被当做字节流看待。

  • pos 值为负数或者大于 str1 长度时,返回 str1

  • len 小于 0,或大于 str1 的长度时,返回结果为 str1 从开头到 pos 位置的串,和 str2 的组合串。

例子

  1. Oceanbase>select insert('Quadratic',-2,100,'What'), insert('Quadratic',7,3,'What'),
  2. -> insert('Quadratic',-1,3,'What'), insert('Quadratic',10,3,'What'), insert('Quadratic',5,-1,''),
  3. -> insert('Quadratic',7,-1,'What')\G;
  4. * 1. row *
  5. insert('Quadratic',-2,100,'What'): Quadratic
  6. insert('Quadratic',7,3,'What'): QuadraWhat
  7. insert('Quadratic',-1,3,'What'): Quadratic
  8. insert('Quadratic',10,3,'What'): Quadratic
  9. insert('Quadratic',5,-1,''): Quad
  10. insert('Quadratic',7,-1,'What'): QuadraWhat
  11. 1 row in set (0.01 sec)

LPAD

声明

LPAD(str, len, padstr)

说明

用指定字符串padstr,在左侧填充字符串str到指定长度len。如果str长度大于len,则str被截断。

例子

  1. OceanBase > SELECT LPAD('hi',4,'??');
  2. +-------------------+
  3. | LPAD('hi',4,'??') |
  4. +-------------------+
  5. | ??hi |
  6. +-------------------+
  7. 1 row in set (0.01 sec)
  8. OceanBase > SELECT LPAD('hi',1,'??');
  9. +-------------------+
  10. | LPAD('hi',1,'??') |
  11. +-------------------+
  12. | h |
  13. +-------------------+
  14. 1 row in set (0.00 sec)

RPAD

声明

RPAD(str, len, padstr)

说明

用指定字符串padstr,在右侧填充字符串str到指定长度len。如果str长度大于len,则str被截断。

例子

  1. OceanBase (root@test)> SELECT RPAD('hi',4,'??');
  2. +-------------------+
  3. | RPAD('hi',4,'??') |
  4. +-------------------+
  5. | hi?? |
  6. +-------------------+
  7. 1 row in set (0.00 sec)
  8. OceanBase (root@test)> SELECT RPAD('hi',1,'??');
  9. +-------------------+
  10. | RPAD('hi',1,'??') |
  11. +-------------------+
  12. | h |
  13. +-------------------+
  14. 1 row in set (0.00 sec)

UUID

声明

uuid()

说明

生成一个全局唯一ID。

例子

  1. OceanBase (root@test)> select uuid();
  2. +--------------------------------------+
  3. | uuid() |
  4. +--------------------------------------+
  5. | f756a1f6-4de6-11e8-90af-90b11c53e421 |
  6. +--------------------------------------+
  7. 1 row in set (0.00 sec)

BIN

声明

bin(N)

说明

返回数字N的二进制形式。

例子

  1. OceanBase > SELECT BIN(12);
  2. +---------+
  3. | BIN(12) |
  4. +---------+
  5. | 1100 |
  6. +---------+
  7. 1 row in set (0.00 sec)

QUOTE

声明

quote(str)

说明

引用一个字符串以产生一个结果可以作为SQL语句中正确地转义数据值。返回的字符串由单引号和单引号的各个实例封闭(‘’),反斜线(‘’),ASCII NUL 和 Control-Z前面加一个反斜杠。如果参数为NULL,则返回值是词 ‘NULL’ 不包围单引号。

例子

  1. OceanBase > SELECT QUOTE('Don\'t!');
  2. +------------------+
  3. | QUOTE('Don\'t!') |
  4. +------------------+
  5. | 'Don\'t!' |
  6. +------------------+
  7. 1 row in set (0.00 sec)
  8. OceanBase > SELECT QUOTE(NULL);
  9. +-------------+
  10. | QUOTE(NULL) |
  11. +-------------+
  12. | NULL |
  13. +-------------+
  14. 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的子串。

例子

  1. oceanbase> select regexp_substr('I have 2 apples and 100 bucks!', '[[:blank:]][[:alnum:]]*', 1, 1) from dual;
  2. +----------------------------------------------------------------------------------+
  3. | regexp_substr('I have 2 apples and 100 bucks!', '[[:blank:]][[:alnum:]]*', 1, 1) |
  4. +----------------------------------------------------------------------------------+
  5. | have |
  6. +----------------------------------------------------------------------------------+
  7. 1 row in set (0.00 sec)
  8. oceanbase> select regexp_substr('foothebar', 'foo(.*)(bar)', 1, 1, 'c', 1) from dual;
  9. +----------------------------------------------------------+
  10. | regexp_substr('foothebar', 'foo(.*)(bar)', 1, 1, 'c', 1) |
  11. +----------------------------------------------------------+
  12. | the |
  13. +----------------------------------------------------------+
  14. 1 row in set (0.01 sec)

转换函数

CAST

声明

CAST(expr AS type)

说明

将某种数据类型的表达式显式转换为另一种数据类型。

expr 字段值转换为 type 数据类型。

参数说明

expr : 表示任何有效的SQL表达式。
AS : 用于分隔两个参数,在AS之前的是要处理的数据,在AS之后是要转换的数据类型。
type : 表示目标系统所提供的数据类型。可以是以下值其中的一个:

  • CHAR[(N)] (CHAR[N]会使 cast 使用该参数的不多于N 个字符)

  • DATE

  • DATETIME

  • DECIMAL

  • SIGNED [INTEGER]

  • TIME

  • UNSIGNED [INTEGER]

在使用CAST函数进行数据类型转换时,在下列情况下能够被接受:

  • 两个表达式的数据类型完全相同;

  • 两个表达式可隐式转换;

  • 必须显式转换数据类型。

如果试图进行不可能的转换,OceanBase将显示一条错误信息。

如果转换时没有指定数据类型的长度,则使用 OceanBase系统内部最大长度。如varchar是262,143字节,number是65个bit位的浮动精度。

支持带符号和无符号的64比特值的运算。若你正在使用数字操作符 (如 +) 而其中一个操作数为无符号整数,则结果为无符号。可使用SIGNED 和UNSIGNED cast操作符来覆盖它。将运算分别派给带符号或无符号64比特整数。

假如任意一个操作数为一个浮点值,则结果为一个浮点值。

例子

  1. Oceanbase>SELECT CAST(123 AS BOOL);
  2. +-------------------+
  3. | CAST(123 AS bool) |
  4. +-------------------+
  5. | 1 |
  6. +-------------------+
  7. 1 row in set (0.00 sec)
  8. Oceanbase>select cast(1-2 as unsigned), cast(cast(1-2 as unsigned) as signed);
  9. +-----------------------+---------------------------------------+
  10. | cast(1-2 as unsigned) | cast(cast(1-2 as unsigned) as signed) |
  11. +-----------------------+---------------------------------------+
  12. | 18446744073709551615 | -1 |
  13. +-----------------------+---------------------------------------+
  14. 1 row in set (0.00 sec)
  15. Oceanbase>SELECT CAST(1 AS UNSIGNED) - 2.0;
  16. +---------------------------+
  17. | CAST(1 AS UNSIGNED) - 2.0 |
  18. +---------------------------+
  19. | -1.0 |
  20. +---------------------------+
  21. 1 row in set (0.00 sec)
  22. Oceanbase>select cast(0 as date);
  23. +-----------------+
  24. | cast(0 as date) |
  25. +-----------------+
  26. | 0000-00-00 |
  27. +-----------------+
  28. 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()遵循银行家规则“四舍—大于五入—五取最接近的偶数”的规则: 一个带有任何小数部分的值会被舍入成最接近的偶数整数。

例子

  1. Oceanbase>select round(2.15,2);
  2. +---------------+
  3. | round(2.15,2) |
  4. +---------------+
  5. | 2.15 |
  6. +---------------+
  7. 1 row in set (0.00 sec)
  8. Oceanbase>select round(2555e-2,1);
  9. +------------------+
  10. | round(2555e-2,1) |
  11. +------------------+
  12. | 25.6 |
  13. +------------------+
  14. 1 row in set (0.01 sec)
  15. Oceanbase>select round(25e-1), round(25.3e-1),round(35e-1);
  16. +--------------+----------------+--------------+
  17. | round(25e-1) | round(25.3e-1) | round(35e-1) |
  18. +--------------+----------------+--------------+
  19. | 3 | 3 | 4 |
  20. +--------------+----------------+--------------+
  21. 1 row in set (0.00 sec)

CEIL

声明

CEIL(expr)

说明

返回大于或者等于指定表达式的最小整数。

还支持比较运算,结果为BOOL值,被转化为数字类型处理,产生的结果为1(TRUE)、0 (FALSE);

如果输入NULL,返回值为NULL。

如果输入纯数字的字符串,支持自动转换成数字类型。

返回值会被转化为一个BIGINT。

例子

  1. Oceanbase>select ceil(1.2), ceil(-1.2), ceil(1+1.5), ceil(1=1),ceil(1<1),ceil(null);
  2. +-----------+------------+-------------+-----------+-----------+------------+
  3. | ceil(1.2) | ceil(-1.2) | ceil(1+1.5) | ceil(1=1) | ceil(1<1) | ceil(null) |
  4. +-----------+------------+-------------+-----------+-----------+------------+
  5. | 2 | -1 | 3 | 1 | 0 | NULL |
  6. +-----------+------------+-------------+-----------+-----------+------------+
  7. 1 row in set (0.00 sec)
  8. Oceanbase>select ceil(name);
  9. ERROR 1166 (42703): Unkown column name 'name'
  10. Oceanbase>select ceil('2');
  11. +-----------+
  12. | ceil('2') |
  13. +-----------+
  14. | 2 |
  15. +-----------+
  16. 1 row in set (0.00 sec)

FLOOR

声明

FLOOR(expr)

说明

和CEIL(expr)函数功能类似,返回小于或者等于指定表达式的最大整数。

还支持比较运算,结果为BOOL值,被转化为数字类型处理,产生的结果为1(TRUE)、0 (FALSE);

如果输入NULL,返回值为NULL。

如果输入纯数字的字符串,支持自动转换成数字类型。

返回值会被转化为一个BIGINT。

例子

  1. Oceanbase>select floor(1.2), floor(-1.2), floor(1+1.5), floor(1=1),floor(1<1),floor(null);
  2. +------------+-------------+--------------+------------+------------+-------------+
  3. | floor(1.2) | floor(-1.2) | floor(1+1.5) | floor(1=1) | floor(1<1) | floor(null) |
  4. +------------+-------------+--------------+------------+------------+-------------+
  5. | 1 | -2 | 2 | 1 | 0 | NULL |
  6. +------------+-------------+--------------+------------+------------+-------------+
  7. 1 row in set (0.00 sec)
  8. Oceanbase>select floor(name);
  9. ERROR 1166 (42703): Unkown column name 'name'
  10. Oceanbase>select floor('2');
  11. +------------+
  12. | floor('2') |
  13. +------------+
  14. | 2 |
  15. +------------+
  16. 1 row in set (0.00 sec)

ABS

声明

ABS(expr)

说明

绝对值函数,求表达式绝对值,函数返回值类型与数值表达式的数据类型相同。

还支持比较运算,结果为BOOL值,被转化为数字类型处理,产生的结果为1(TRUE)、0 (FALSE);

如果输入NULL,返回值为NULL。

如果输入纯数字的字符串,支持自动转换成数字类型。

返回值会被转化为一个BIGINT。

例子

  1. Oceanbase>select abs(5), abs(-5.777), abs(0), abs(1/2), abs(1-5);
  2. +--------+-------------+--------+----------+----------+
  3. | abs(5) | abs(-5.777) | abs(0) | abs(1/2) | abs(1-5) |
  4. +--------+-------------+--------+----------+----------+
  5. | 5 | 5.777 | 0 | 0.5000 | 4 |
  6. +--------+-------------+--------+----------+----------+
  7. 1 row in set (0.00 sec)

NEG

声明

NEG(expr)

说明

求补函数,对操作数执行求补运算:用零减去操作数,然后结果返回操作数。

支持比较运算,结果为BOOL值,被转化为数字类型处理,产生的结果为1(TRUE)、0 (FALSE),再对结果求补。

例子

  1. Oceanbase>select neg(1), neg(1+1), neg(2*3), neg(1=1), neg(5<1);
  2. +--------+----------+----------+----------+----------+
  3. | neg(1) | neg(1+1) | neg(2*3) | neg(1=1) | neg(5<1) |
  4. +--------+----------+----------+----------+----------+
  5. | -1 | -2 | -6 | -1 | 0 |
  6. +--------+----------+----------+----------+----------+
  7. 1 row in set (0.01 sec)

SIGN

声明

SIGN(X)

说明

SIGN(X)返回参数作为-1、 0或1的符号,该符号取决于X的值为负、零或正。

支持比较运算,结果为BOOL值,被转化为数字类型处理,产生的结果为1(TRUE)、0 (FALSE);

如果输入NULL,返回值为NULL。

支持浮点数、十六进制数。

例子

  1. Oceanbase>SELECT SIGN(-32), SIGN(0), SIGN(234);
  2. +-----------+---------+-----------+
  3. | SIGN(-32) | SIGN(0) | SIGN(234) |
  4. +-----------+---------+-----------+
  5. | -1 | 0 | 1 |
  6. +-----------+---------+-----------+
  7. 1 row in set (0.01 sec)
  8. Oceanbase>select sign(null),sign(false),sign(0x01);
  9. +------------+-------------+------------+
  10. | sign(null) | sign(false) | sign(0x01) |
  11. +------------+-------------+------------+
  12. | NULL | 0 | 1 |
  13. +------------+-------------+------------+
  14. 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_baseto_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]。

例子

  1. Oceanbase>select conv(9223372036854775807,10,2);
  2. +-----------------------------------------------------------------+
  3. | conv(9223372036854775807,10,2) |
  4. +-----------------------------------------------------------------+
  5. | 111111111111111111111111111111111111111111111111111111111111111 |
  6. +-----------------------------------------------------------------+
  7. 1 row in set (0.00 sec)
  8. Oceanbase>select conv('-acc',21,-7);
  9. +--------------------+
  10. | conv('-acc',21,-7) |
  11. +--------------------+
  12. | -16425 |
  13. +--------------------+
  14. 1 row in set (0.00 sec)

MOD

声明

MOD(N,M)

说明

取余函数。MOD(NM), N % MN MOD M 三种形式是等效的。

MOD()对于带有小数部分的数值也起作用,它返回除法运算后的精确余数。

N,M 中任何一个参数为 NULL,返回值都为 NULL。M 为 0 是,也返回 NULL。

例子

  1. Oceanbase>select mod(29,19), 29 mod 19, 29 % 19;
  2. +------------+-----------+---------+
  3. | mod(29,19) | 29 mod 19 | 29 % 19 |
  4. +------------+-----------+---------+
  5. | 10 | 10 | 10 |
  6. +------------+-----------+---------+
  7. 1 row in set (0.00 sec)

POW

声明

POW(X,Y)

说明

返回X的Y次方。

X与Y中任何一个参数为NULL,返回值都为NULL。

例子

  1. Oceanbase>select pow(4,2), pow(4,-2), pow(1,null);
  2. +----------+-----------+-------------+
  3. | pow(4,2) | pow(4,-2) | pow(1,null) |
  4. +----------+-----------+-------------+
  5. | 16 | 0.0625 | NULL |
  6. +----------+-----------+-------------+
  7. 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。

例子

  1. mysql> select a, b, rand() from t3;
  2. +------+------+---------------------+
  3. | a | b | rand() |
  4. +------+------+---------------------+
  5. | 1 | 1 | 0.641815407799385 |
  6. | 2 | 2 | 0.16825051248841966 |
  7. | 3 | 3 | 0.9158063697775886 |
  8. +------+------+---------------------+
  9. 3 rows in set (0.00 sec)
  10. mysql> select a, b, rand() from t3;
  11. +------+------+---------------------+
  12. | a | b | rand() |
  13. +------+------+---------------------+
  14. | 1 | 1 | 0.07428034215632857 |
  15. | 2 | 2 | 0.6239826321825224 |
  16. | 3 | 3 | 0.897072165177271 |
  17. +------+------+---------------------+
  18. 3 rows in set (0.00 sec)
  19. mysql> select a, b, rand(3) from t3;
  20. +------+------+---------------------+
  21. | a | b | rand(3) |
  22. +------+------+---------------------+
  23. | 1 | 1 | 0.9057697559760601 |
  24. | 2 | 2 | 0.37307905813034536 |
  25. | 3 | 3 | 0.14808605345719125 |
  26. +------+------+---------------------+
  27. 3 rows in set (0.00 sec)
  28. mysql> select a, b, rand(3) from t3;
  29. +------+------+---------------------+
  30. | a | b | rand(3) |
  31. +------+------+---------------------+
  32. | 1 | 1 | 0.9057697559760601 |
  33. | 2 | 2 | 0.37307905813034536 |
  34. | 3 | 3 | 0.14808605345719125 |
  35. +------+------+---------------------+
  36. 3 rows in set (0.00 sec)
  37. mysql> select a, b, rand(a), rand(b) from t3;
  38. +------+------+---------------------+---------------------+
  39. | a | b | rand(a) | rand(b) |
  40. +------+------+---------------------+---------------------+
  41. | 1 | 1 | 0.40540353712197724 | 0.40540353712197724 |
  42. | 2 | 2 | 0.6555866465490187 | 0.6555866465490187 |
  43. | 3 | 3 | 0.9057697559760601 | 0.9057697559760601 |
  44. +------+------+---------------------+---------------------+
  45. 3 rows in set (0.00 sec)

比较函数

GREATEST

声明

GREATEST(value1, ...)

说明

返回参数的最大值,和函数LEAST()相对。

参数至少为两个(一个参数将会报错);如果参数中有NULL, 返回值为NULL。

当参数中同时存在数值和字符时,把字符隐式转换为数值类型处理,不能转换的报错。

例子

  1. Oceanbase>select greatest(2,1), greatest('2',1,0), greatest('a','b','c'), greatest('a', NULL, 'c'), greatest('2014-05-15','2014-06-01')\G
  2. * 1. row *
  3. greatest(2,1): 2
  4. greatest('2',1,0): 2
  5. greatest('a','b','c'): c
  6. greatest('a', NULL, 'c'): NULL
  7. greatest('2014-05-15','2014-06-01'): 2014-06-01
  8. 1 row in set (0.01 sec)
  9. Oceanbase>select greatest(2);
  10. ERROR 1582 (42000): Incorrect parameter count in the call to native function 'greatest'

LEAST

声明

LEAST(value1, ...)

说明

返回参数的最小值,和函数GREATEST()相对。

参数至少为两个;如果参数中有NULL,返回值为NULL。

当参数中同时存在数值和字符时,把字符隐式转换为数值类型处理,不能转换的报错。

例子

  1. Oceanbase>select least(2, null), least('2',4,9), least('a','b','c'), least('a',NULL,'c'), least('2014-05-15','2014-06-01')\G;
  2. * 1. row *
  3. least(2, null): NULL
  4. least('2',4,9): 2
  5. least('a','b','c'): a
  6. least('a',NULL,'c'): NULL
  7. least('2014-05-15','2014-06-01'): 2014-05-15
  8. 1 row in set (0.01 sec)
  9. Oceanbase>select least(2);
  10. 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 比较操作符具有一些相同的特性。

例子

  1. Oceanbase>SELECT ISNULL(null), ISNULL('test'), ISNULL(123.456), ISNULL('10:00');
  2. +--------------+----------------+-----------------+-----------------+
  3. | ISNULL(null) | ISNULL('test') | ISNULL(123.456) | ISNULL('10:00') |
  4. +--------------+----------------+-----------------+-----------------+
  5. | 1 | 0 | 0 | 0 |
  6. +--------------+----------------+-----------------+-----------------+
  7. 1 row in set (0.01 sec)
  8. Oceanbase>SELECT ISNULL(null+1);
  9. +----------------+
  10. | ISNULL(null+1) |
  11. +----------------+
  12. | 1 |
  13. +----------------+
  14. 1 row in set (0.00 sec)

流程控制函数

CASE

声明

  1. CASE value WHEN [compare-value] THEN result [WHEN [compare-value] THEN result ...] [ELSE result] END
  2. OR
  3. CASE WHEN [condition] THEN result [WHEN [condition] THEN result ...] [ELSE result] END

说明

在第一个方案的返回结果中,value = compare-value。而第二个方案的返回结果是第一种条件为真。如果没有匹配的结果值,则返回结果为 ELSE 后的结果,如果没有 ELSE 部分,则返回值为 NULL。

例子

  1. Oceanbase>select CASE 'b' when 'a' then 1 when 'b' then 2 END;
  2. +----------------------------------------------+
  3. | CASE 'b' when 'a' then 1 when 'b' then 2 END |
  4. +----------------------------------------------+
  5. | 2 |
  6. +----------------------------------------------+
  7. 1 row in set (0.01 sec)
  8. Oceanbase>select CASE concat('a','b') when concat('ab','') then 'a' when 'b' then 'b' end;
  9. +--------------------------------------------------------------------------+
  10. | CASE concat('a','b') when concat('ab','') then 'a' when 'b' then 'b' end |
  11. +--------------------------------------------------------------------------+
  12. | a |
  13. +--------------------------------------------------------------------------+
  14. 1 row in set (0.01 sec)
  15. Oceanbase>select case when 1>0 then 'true' else 'false' end;
  16. +--------------------------------------------+
  17. | case when 1>0 then 'true' else 'false' end |
  18. +--------------------------------------------+
  19. | true |
  20. +--------------------------------------------+
  21. 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 表达式的结果类型。

例子

  1. Oceanbase>select if(5>6, 'T','F'), if (5>6, 1, 0), if(null, 'True', 'False'), if(0, 'True', 'False')\G
  2. * 1. row *
  3. if(5>6, 'T','F'): F
  4. if (5>6, 1, 0): 0
  5. if(null, 'True', 'False'): False
  6. if(0, 'True', 'False'): False
  7. 1 row in set (0.01 sec)

IFNULL

声明

IFNULL(expr1, expr2)

说明

假设 expr1 不为 NULL,则 IFNULL() 的返回值为 expr1; 否则其返回值为 expr2。 IFNULL() 的返回值是数值或字符串,具体情况取决于其所使用的语境。

IF()的默认返回值类型按照以下方式计算:

表达式 返回值
expr2 或 expr3 返回值为一个字符串。 字符串
expr2 或 expr3 返回值为一个浮点值。 浮点
expr2 或 expr3 返回值为一个整数。 整数

假如 expr2expr3 都是字符串,且其中任何一个字符串区分大小写,则返回结果是区分大小写。

例子

  1. Oceanbase>SELECT IFNULL('abc', null), IFNULL(NULL+1, NULL+2), IFNULL(1/0, 0/1);
  2. +---------------------+------------------------+------------------+
  3. | IFNULL('abc', null) | IFNULL(NULL+1, NULL+2) | IFNULL(1/0, 0/1) |
  4. +---------------------+------------------------+------------------+
  5. | abc | NULL | 0.0000 |
  6. +---------------------+------------------------+------------------+
  7. 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。

例子

  1. Oceanbase>SELECT NULLIF('ABC', 123), NULLIF('123',123), NULLIF(NULL, 'abc');
  2. +--------------------+-------------------+---------------------+
  3. | NULLIF('ABC', 123) | NULLIF('123',123) | NULLIF(NULL, 'abc') |
  4. +--------------------+-------------------+---------------------+
  5. | ABC | NULL | NULL |
  6. +--------------------+-------------------+---------------------+
  7. 1 row in set, 1 warning (0.01 sec)

ORA_DECODE

声明

ora_decode(条件, 值1, 返回值1, 值2, 返回值2, ... 值n, 返回值n, 缺省值)

说明

ORADECODE()函数功能等同于Oracle的DECODE()函数功能(OceanBase 1.0兼容MySQL,同时也增加了部分Oracle的函数,这部分Oracle同功能的函数在OceanBase 1.0中被统一命名以ORA开头 )。

该函数的含义如下:

  1. IF 条件=值1
  2. THEN RETURN(返回值1)
  3. ELSIF 条件=值2
  4. THEN RETURN(返回值2)
  5. ......
  6. ELSIF 条件=值n
  7. THEN RETURN(返回值n)
  8. ELSE RETURN(缺省值)
  9. END IF